C# Vp机器视觉-拓冰企业网站定制

vp显示屏幕`new CogRecordDisplay()`的常用属性

以下是创建一个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`	用户自定义数据，可附加任意对象

`Operator`的常用子属性（重点）

通过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本身是一个几何图形对象，表示一个可以旋转的矩形区域。

类别	属性	说明
位置	`CenterX`、`CenterY`	设置矩形中心点坐标
大小	`SideXLength`、`SideYLength`	设置矩形宽度和高度
旋转	`Rotation`	设置矩形旋转角度（单位：弧度）
移动缩放旋转控制	`GraphicDOFEnable`	控制鼠标可以进行哪些操作（移动、缩放、旋转）
鼠标操作	`Interactive`	是否允许鼠标拖动、调整区域
显示颜色	`Color`	设置矩形框显示颜色
显示粗细	`LineWidthInScreenPixels`	设置矩形边框线宽
X方向偏移	`TranslationX`	设置X方向平移
Y方向偏移	`TranslationY`	设置Y方向平移
左边界	`Left`	获取矩形左侧坐标
上边界	`Top`	获取矩形顶部坐标
右边界	`Right`	获取矩形右侧坐标
下边界	`Bottom`	获取矩形底部坐标
边界框	`GetBoundingBox()`	获取当前矩形的外接矩形
复制对象	`Copy()`	复制当前矩形对象

GraphicDOFEnable常用设置

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

PMAlign训练区域最常用：

类别	属性
中心位置	`CenterX`、`CenterY`
区域大小	`SideXLength`、`SideYLength`
旋转角度	`Rotation`
鼠标调整	`Interactive`
操作权限	`GraphicDOFEnable`
显示颜色	`Color`
显示线宽	`LineWidthInScreenPixels`

PMAlign训练区域最常用：

类别	属性
中心位置	`CenterX`、`CenterY`
区域大小	`SideXLength`、`SideYLength`
旋转角度	`Rotation`
鼠标调整	`Interactive`
操作权限	`GraphicDOFEnable`
显示颜色	`Color`
显示线宽	`LineWidthInScreenPixels`

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

类别	属性	说明
输入图像	`InputImage`	设置PMAlign进行匹配的输入图片
匹配模板	`Pattern`	PMAlign训练模板相关对象
运行参数	`RunParams`	设置运行匹配参数
匹配结果	`Results`	获取匹配后的结果集合
工具名称	`Name`	工具名称
启用状态	`Enabled`	是否启用工具
运行状态	`RunStatus`	获取工具运行状态
最后运行记录	`LastRunRecord`	获取最后一次运行记录

Pattern（训练模板）常用属性

类别	属性	说明
训练图片	`TrainImage`	设置用于训练的图片
训练区域	`TrainRegion`	设置训练目标区域
训练状态	`Trained`	判断是否已经训练
训练方法	`Train()`	根据图片和区域生成模板
清除模板	`Clear()`	清除已经训练的模板

RunParams（运行参数）

类别	属性	说明
最小匹配分数	`AcceptThreshold`	设置匹配通过分数
最大结果数量	`MaxResults`	设置最多返回几个结果
搜索方向	`ZoneAngle`	设置搜索角度范围
搜索区域	`SearchRegion`	设置匹配搜索范围

Results（匹配结果）

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

CogPMAlignResult 常用属性

类别	属性	说明
匹配分数	`Score`	匹配得分
X坐标	`X`	匹配中心X坐标
Y坐标	`Y`	匹配中心Y坐标
旋转角	`Rotation`	匹配旋转角度
仿射变换	`GetPose()`	获取目标姿态

PMAlign最核心的几个：

功能	属性/方法
输入图片	`InputImage`
创建模板	`Pattern`
训练图片	`Pattern.TrainImage`
训练区域	`Pattern.TrainRegion`
训练	`Pattern.Train()`
设置匹配条件	`RunParams`
运行	`Run()`
获取结果	`Results`

关于技术查阅教学

比如组件：CogImageFileTool

我要获取它的参数，可以通过以下方法获取。

技术文档

技术文档要查全的话，比如我要获取总数，搜工具，只给你个大概的内容方法，但是细节的，你还得单独搜索一下类的，比如以下：

组件终端查阅

资讯详情

C# Vp机器视觉

vp显示屏幕new CogRecordDisplay()的常用属性

常用属性一览

Operator的常用子属性（重点）

vp显示屏幕`new CogRecordDisplay()`的常用属性

`Operator`的常用子属性（重点）