通信建设网站整合网络营销外包
CogCreateGraphicLabelTool是一个用于在图像或界面上创建图像标签(如文本、符号等)的工具，通常用于在视觉检测结果中叠加标注信息(如检测状态、测量值、位置坐标等)。
效果图
CogCreateGraphicLabelTool工具功能
图形标签生成：在图像或显示控件上创建文本或简单图形（如箭头、矩形框等）。
动态内容：支持绑定变量或检测结果，实时更新标签内容（例如显示某个工具的测量值）。
格式自定义：允许配置字体、颜色、位置、对齐方式、旋转角度等属性。
坐标系统：支持基于图像坐标或屏幕坐标的定位，确保标签显示在正确位置。
应用场景
在图像上显示检测结果（如“OK”或“NG”）。
标注测量值（如尺寸、角度、位置偏差）。
标记感兴趣区域（ROI）的坐标或说明。
在用户界面中动态生成状态提示。
常见属性
-
Text：标签的文本内容（可绑定变量或表达式）。
-
PositionX/PositionY：标签的坐标位置（基于图像或屏幕坐标系）。
-
Font：字体类型、大小、样式（粗体、斜体等）。
-
Color：文本或图形颜色。
-
Alignment：对齐方式（左对齐、居中、右对齐）。
-
Rotation：旋转角度（以度为单位）。
-
Visibility：控制标签是否显示。
输入与输出
-
输入：
-
可能依赖其他工具的输出来生成动态内容（如 CogPMAlignTool 的匹配结果）。
-
坐标输入（如从 CogCalibNPointToNPointTool 获取变换后的坐标）。
-
-
输出：
-
生成的图形对象（
ICogGraphic或CogGraphicCollection），可叠加到图像或显示控件。
-
在代码中的使用示例（C#）
// 创建工具实例
CogCreateGraphicLabelTool labelTool = new CogCreateGraphicLabelTool();// 配置标签属性
labelTool.Text = "检测结果: OK";
labelTool.PositionX = 100; // X坐标（基于图像或屏幕）
labelTool.PositionY = 50; // Y坐标
labelTool.Font = new Font("Arial", 12, FontStyle.Bold);
labelTool.Color = CogColorConstants.Green;// 执行工具生成图形
labelTool.Run();// 将生成的图形添加到显示控件
cogDisplay1.InteractiveGraphics.Add(labelTool.OutputGraphic, "Label", CogColorConstants.Green
);注意事项
-
坐标系：需明确使用图像坐标（像素）还是屏幕坐标（界面控件坐标）。
-
动态绑定：可通过 VisionPro 的“绑定机制”将标签内容与变量或其他工具的输出关联。
-
性能：频繁更新复杂图形可能影响实时性，建议优化标签数量和复杂度。
-
版本兼容性：不同版本的 VisionPro API 可能有细微差异，建议查阅对应版本的文档（如 Cognex.VisionPro.Core 命名空间）。
CogCreateGraphicLabelTool应用
| 名称 | 类型 | 描述 |
|---|---|---|
| InputImage | - | 是指被处理的原始图像数据 |
| InputGraphicLabel.X | double | 水平坐标基于坐标系设置，可能是图像像素坐标或屏幕坐标 |
| InputGraphicLabel.Y | double | 垂直坐标与 X 共同决定标签位置 |
| nputGraphicLabel.Text | string | 显示的 文本内容，支持动态绑定（如绑定其他工具的输出值） |
| InputBoolean | bool | 传递布尔值（true 或 false），通常用于控制工具的启用/禁用或条件分支 |
| InputDouble | double | 传递双精度浮点数值（如测量结果、阈值或坐标值） |
| InputInteger | int | 传递整数值（如计数、索引或配置选项） |
| InputToolResiltConstant | CogRectangle\double | 将其他工具的输出结果或常量值绑定到当前工具的输入 |
| GetOutputGraphicLabel | - | - |
选择器：
InputGraphicLabelText:用于指定要在图像上显示的文本内容
InputBoolean:只接受布尔值（true 或 false）
InputDouble:一个双精度浮点数
InputInteger:接受整数类型的输入
InputToolResultConstant:这种类型的输入通常是与另一个视觉工具的结果相关联的常量
Formatted:自定义文本
ToolResultConstant
Accept(接受): 当视觉工具执行的结果符合预期标准时，通常会返回一个“接受”的状态
Warning(警告):警告状态表明虽然检测对象存在一些问题或偏差，但这些问题还不足以导致整个项目被拒绝
Reject(拒绝):当检测到的对象明显不符合质量标准时，系统将返回一个“拒绝”状态
Error(错误):错误状态通常是与工具本身的操作相关的问题，而不是检测对象的状态
步骤2：可以选择自定义字体类型；
步骤3：自定义字体颜色
步骤4：图像
步骤5：结果
