news 2026/8/13 9:50:54

C# Vp机器视觉

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
C# Vp机器视觉

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

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

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

文件对话框 常用属性(System.Windows.Forms.OpenFileDialog)

属性类型说明
Filterstring文件类型过滤器。格式:"描述1|*.ext1|描述2|*.ext2"
例如:"图像文件|*.bmp;*.jpg;*.png|所有文件|*.*"
FilterIndexint默认选中的过滤器索引(从 1 开始)
InitialDirectorystring对话框打开时的起始目录,如@"C:\Images"
Titlestring对话框标题栏文字,如"选择要打开的图片"
FileNamestring用户选定的单个文件的完整路径(对话框关闭后获取)
FileNamesstring[]Multiselect = true时,获取所有选定文件的路径数组
Multiselectbool是否允许一次选择多个文件,默认false
RestoreDirectorybool关闭对话框后是否恢复当前工作目录到初始值
CheckFileExistsbool是否检查所选文件实际存在,默认true
CheckPathExistsbool是否检查所选路径存在,默认true
DefaultExtstring如果用户未输入扩展名,自动添加的默认扩展名,如"bmp"
AddExtensionbool是否在缺少扩展名时自动添加DefaultExt,默认true
ShowHelpbool是否显示“帮助”按钮,默认false
DereferenceLinksbool是否解析快捷方式(.lnk),返回其目标路径,默认true
ValidateNamesbool是否检查文件名不包含无效字符,默认true

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

常用属性一览

属性类型说明
OperatorCogImageFileOperator核心操作对象,包含文件夹路径、文件列表、循环、当前文件等子属性与方法(见下)
InputImageICogImage输入图像(此工具一般不需要设置输入,内部自己读文件)
OutputImageICogImage运行后输出的图像(只读),就是当前读取到的图片
RunStatusCogToolResultConstants运行后的状态(Accept、Warning、Error等)
LastRunRecordICogRecord最后运行的记录,包含结果细节
UserDataobject用户自定义数据,可附加任意对象

Operator的常用子属性(重点)

通过tool.Operator访问,用于配置数据源:

子属性类型说明
Open(folderPath, mode)方法打开文件夹,modeCogImageFileModeConstants.Read
Filterstring文件过滤器,如"*.bmp;*.jpg"(默认"*.*"
Loopbool读完后是否循环(true则从头开始,false则停止)
CurrentFileNamestring当前加载的文件完整路径(只读)
CurrentIndexint当前文件在列表中的索引(从0开始)
NumberOfFilesint文件夹内匹配的文件总数(只读)
Reset()方法重置索引到第一张图片

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

类别属性说明
位置CenterXCenterY设置矩形中心点坐标
大小SideXLengthSideYLength设置矩形宽度和高度
旋转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训练区域最常用:

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

PMAlign训练区域最常用:

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

CogPMAlignTool常用属性列表(按类别整理,方便复制)

类别属性说明
输入图像InputImage设置PMAlign进行匹配的输入图片
匹配模板PatternPMAlign训练模板相关对象
运行参数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

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

技术文档

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

组件终端查阅


版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/8/13 9:48:10

Window版本OpenClaw 可视化部署,避开 Defender 拦截完整步骤

核心亮点:提供全程可视化的图形操作界面,自动补齐全套运行依赖,数据独立存储于本地设备,兼容多款主流大模型,并采用轻量化的 45.7MB 整合压缩包。 教程适配:OpenClaw | 适配 Windows 10/11 与 macOS 双系统…

作者头像 李华
网站建设 2026/8/13 9:45:45

开源AI代码智能体:本地部署、私有代码库深度理解与问答实践

这次我们来看一个开源代码智能体项目。如果你在找本地部署、支持私有代码库、能替代 Greptile 的 AI 代码助手,这个项目值得关注。它不是一个简单的代码搜索工具,而是一个能理解代码库上下文、回答复杂问题、甚至生成代码片段的智能体。对于开发者来说&a…

作者头像 李华
网站建设 2026/8/13 9:44:10

应对模糊系统响应:从防御性编码到系统性排查的工程实践

在实际开发中,我们经常需要处理来自外部系统或用户的响应。一个“愤世嫉俗”的响应,通常指代那些带有嘲讽、不信任、消极或防御性态度的反馈。这不仅仅是一个沟通问题,在技术层面,它可能表现为API返回了非预期的错误码、含糊的日志…

作者头像 李华
网站建设 2026/8/13 9:43:43

基于RAG与智能体技术的大语言模型专业知识增强实践指南

1. 这篇文章真正要解决的问题 如果你正在尝试将大语言模型(LLMs)应用到具体的业务场景中,比如构建一个智能客服、一个代码助手,或者一个内容生成系统,你很可能已经遇到了一个核心瓶颈: 模型“懂”得很多&…

作者头像 李华
网站建设 2026/8/13 9:43:35

车牌识别技术全链路解析:从硬件选型到算法优化的实战避坑指南

1. 从“识别”到“猫腻”:一个从业者的视角 每次开车进出停车场,或者经过高速收费站,看到摄像头一闪,栏杆自动抬起,我们早已习以为常。这背后,是车牌识别技术在默默工作。大多数人可能觉得,这不…

作者头像 李华