VisionPro学习笔记- CogCreateGraphicLabelTool

CogCreateGraphicLabelTool 工具文档

1. 工具概述

CogCreateGraphicLabelTool 是康耐视 VisionPro 视觉软件中的核心图形标注工具，用于在图像上叠加文本或坐标信息，以标识、注释或动态显示检测结果。它的主要功能是通过简单的配置，在图像中指定位置添加可定制的文本标签，支持静态文本和动态数据链接，无需编写脚本即可实现结果的直观可视化。

• 核心价值：简化结果展示流程，提升检测结果的可读性和可追溯性。
• 典型应用场景：
  • 显示测量结果（如尺寸、角度）。
  • 标注识别内容（如零件编号、二维码内容）。
  • 输出状态信息（如检测结果 "PASS/NG"）。

2. 工具配置与参数说明

2.1 基本参数设置

在 QuickBuild 的属性面板中，需配置以下关键参数：

参数类别	说明	示例值/选项
选择器 (Selector)	选择输入数据的类型。	InputString（字符串）、InputDouble（双精度浮点数）、InputInteger（整数）、InputBoolean（布尔值）、Formatted（格式化文本）
文本 (Text)	定义标签显示的文本内容。	可直接输入文字，或使用格式化占位符（如 "宽度: {D:F2} mm"）。
位置坐标 (X, Y)	设置文本在图像上的显示坐标。	例如 (100, 50)，可链接到其他工具的坐标输出。
外观设置	字体、颜色、大小、背景色等。	字体：Arial；颜色：CogColorConstants.Red；背景色：CogColorConstants.LightGrey。

2.2 格式化文本语法

通过 { } 占位符动态插入数据，支持精度控制和格式优化：

• 基本占位符：
  • {B}：显示布尔值（True/False）。
  • {I}：显示整数值。
  • {D}：显示双精度浮点数。
  • {T}：显示工具运行状态（如 Succeeded）。
• 高级格式化（基于 .NET 标准）：
  • 控制小数位数：{D:F2}（保留两位小数）。
  • 组合使用："结果: {B}, 值: {D:F1}" 显示为 结果: True, 值: 12.3。

2.3 添加未直接暴露的参数

如果工具的默认输出未包含所需参数，可通过以下步骤添加：

1. 右键点击工具，选择 “添加终端”。
2. 在浏览窗口中选择 “所有（未过滤）”。
3. 在 Results 项下找到所需参数（如特定测量值），点击添加。

3. 在 QuickBuild 中的使用流程

3.1 基本操作步骤

1. 添加工具：从工具箱的 Geometry -> Creation 类别下拖拽 CogCreateGraphicLabelTool 到作业中。
2. 连接数据源：
   • 将 InputImage 链接到图像源（如 ImageSource 或上游工具的 OutputImage）。
   • 将需要显示的动态数据（如 CogCaliperTool 的宽度结果）链接到工具的对应输入端口（如 InputDouble）。
3. 配置文本与位置：
   • 在属性面板设置文本内容（如 "距离: {D:F2} px"）。
   • 调整 (X, Y) 坐标，或链接到定位工具的坐标输出。
4. 运行与验证：执行作业，查看图像上是否正确显示标签。

3.2 典型工作流示例：显示零件测量结果

1. 图像定位：使用 CogPMAlignTool 定位零件，并通过 CogFixtureTool 建立固定坐标系。
2. 尺寸测量：使用 CogCaliperTool 测量零件宽度。
3. 结果标注：
   • 添加 CogCreateGraphicLabelTool，链接 CogCaliperTool 的宽度结果到 InputDouble。
   • 设置文本为 "宽度: {D:F2} mm"，并调整位置到零件附近。
4. 输出效果：运行后图像显示如 宽度: 25.40 mm。

4. 注意事项与最佳实践

• 坐标系对齐：为确保标签位置稳定，建议先将 CogFixtureTool 与定位工具（如 CogPMAlignTool）结合使用，建立与工件对齐的坐标系。
• 多标签管理：一个作业可添加多个 CogCreateGraphicLabelTool 实例，分别显示不同信息（如同时显示距离、角度和状态）。
• 性能优化：避免在循环中频繁创建新标签，如需动态生成大量标签，可考虑使用 CogGraphicCollection 和脚本封装方法。
• 调试技巧：通过 ModifyLastRunRecord 方法确保标签在运行后持久显示。

实操

整体工作流

取测量结果Width出来做标签显示。

CogCreateGraphicLabelTool具体设置

使用Formatted格式化显示,显示双精度浮点数{D}，且小数保留2位。

最终结果