当前位置：首页 > news >正文

C# Vp机器视觉

news 2026/8/13 10:10:50

以下是创建一个CogRecordDisplay实例后，你可以直接使用的核心属性（假设你已添加了Cognex.VisionPro.Display的引用）：

属性	类型	说明
`Image`	`ICogImage`/`CogImage`	要显示的图像。可赋值任何 VisionPro 图像（`CogImage8Grey`,`CogImage24PlanarColor`等）或`null`
`AutoFit`	`bool`	控件尺寸变化或图像改变时，是否自动缩放图像以适应控件区域。默认通常为`true`
`Zoom`	`double`	当前缩放比例，1.0 为原始大小
`PanX`/`PanY`	`double`	图像在控件内的平移量（逻辑像素）
`Fit`	方法	`Fit()`方法会自动计算缩放和平移，使图像完整居中显示。无返回值
`DisplayMode`	枚举（如`CogDisplayMode`）	控制图像的渲染方式，例如适应宽度、高度、拉伸等
`Interactive`	`bool`	是否允许鼠标交互（框选、拖动、缩放等）
`Graphics`	`Cognex.VisionPro.Display.CogDisplayGraphics`	获取图形集合，可在图像上绘制自定义形状、文字等
`Record`	`ICogRecord`	与控件关联的`CogRecord`对象，用于记录图像的修改历史和图形（常用于调试和结果展示）
`BackgroundColor`	`Color`	控件背景色（通常为黑色）
`AutoCreateGraphics`	`bool`	是否自动为每个图像创建默认图形（如十字线等），一般保持`false`

文件对话框常用属性（System.Windows.Forms.OpenFileDialog）

属性	类型	说明
`Filter`	`string`	文件类型过滤器。格式：`"描述1\|.ext1\|描述2\|.ext2"` 例如：`"图像文件\|.bmp;.jpg;.png\|所有文件\|.*"`
`FilterIndex`	`int`	默认选中的过滤器索引（从 1 开始）
`InitialDirectory`	`string`	对话框打开时的起始目录，如`@"C:\Images"`
`Title`	`string`	对话框标题栏文字，如`"选择要打开的图片"`
`FileName`	`string`	用户选定的单个文件的完整路径（对话框关闭后获取）
`FileNames`	`string[]`	当`Multiselect = true`时，获取所有选定文件的路径数组
`Multiselect`	`bool`	是否允许一次选择多个文件，默认`false`
`RestoreDirectory`	`bool`	关闭对话框后是否恢复当前工作目录到初始值
`CheckFileExists`	`bool`	是否检查所选文件实际存在，默认`true`
`CheckPathExists`	`bool`	是否检查所选路径存在，默认`true`
`DefaultExt`	`string`	如果用户未输入扩展名，自动添加的默认扩展名，如`"bmp"`
`AddExtension`	`bool`	是否在缺少扩展名时自动添加`DefaultExt`，默认`true`
`ShowHelp`	`bool`	是否显示“帮助”按钮，默认`false`
`DereferenceLinks`	`bool`	是否解析快捷方式（.lnk），返回其目标路径，默认`true`
`ValidateNames`	`bool`	是否检查文件名不包含无效字符，默认`true`

CogImageFileTool是 VisionPro 中用来从文件夹按顺序读取图像的工具。创建实例后，你可以通过一系列属性配置它的行为，并通过Run()方法自动加载下一张图片。下面列出其常用属性（创建后可直接设置或读取），并附上与之前代码结合的用法。

属性	类型	说明
`Operator`	`CogImageFileOperator`	核心操作对象，包含文件夹路径、文件列表、循环、当前文件等子属性与方法（见下）
`InputImage`	`ICogImage`	输入图像（此工具一般不需要设置输入，内部自己读文件）
`OutputImage`	`ICogImage`	运行后输出的图像（只读），就是当前读取到的图片
`RunStatus`	`CogToolResultConstants`	运行后的状态（Accept、Warning、Error等）
`LastRunRecord`	`ICogRecord`	最后运行的记录，包含结果细节
`UserData`	`object`	用户自定义数据，可附加任意对象

通过tool.Operator访问，用于配置数据源：

子属性	类型	说明
`Open(folderPath, mode)`	方法	打开文件夹，`mode`取`CogImageFileModeConstants.Read`
`Filter`	`string`	文件过滤器，如`".bmp;.jpg"`（默认`"."`）
`Loop`	`bool`	读完后是否循环（`true`则从头开始，`false`则停止）
`CurrentFileName`	`string`	当前加载的文件完整路径（只读）
`CurrentIndex`	`int`	当前文件在列表中的索引（从0开始）
`NumberOfFiles`	`int`	文件夹内匹配的文件总数（只读）
`Reset()`	方法	重置索引到第一张图片

CogRectangleAffine本身是一个几何图形对象，表示一个可以旋转的矩形区域。

GraphicDOFEnable常用设置

功能	属性值
全部操作（移动+缩放+旋转）	`CogRectangleAffineDOFConstants.All`
只允许移动	`CogRectangleAffineDOFConstants.Translation`
只允许缩放	`CogRectangleAffineDOFConstants.Scale`
只允许旋转	`CogRectangleAffineDOFConstants.Rotation`

PMAlign训练区域最常用：

PMAlign训练区域最常用：

CogPMAlignTool常用属性列表（按类别整理，方便复制）

Pattern（训练模板）常用属性

RunParams（运行参数）

Results（匹配结果）

类别	属性	说明
结果数量	`Count`	匹配结果数量
第一个结果	`Results[0]`	获取第一个匹配结果

CogPMAlignResult 常用属性

PMAlign最核心的几个：