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

VisionPro学习笔记- CogCreateGraphicLabelTool

news 2026/3/26 17:17:57

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 添加未直接暴露的参数

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

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

3. 在 QuickBuild 中的使用流程

3.1 基本操作步骤

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

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

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

4. 注意事项与最佳实践

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