CogCreateGraphicLabelTool 工具文檔

1. 工具概述

CogCreateGraphicLabelTool 是康耐視 VisionPro 視覺軟件中的核心圖形標注工具，用于在圖像上疊加文本或坐標信息，以標識、注釋或動態顯示檢測結果。它的主要功能是通過簡單的配置，在圖像中指定位置添加可定制的文本標簽，支持靜態文本和動態數據鏈接，無需編寫腳本即可實現結果的直觀可視化。

• 核心價值：簡化結果展示流程，提升檢測結果的可讀性和可追溯性。
• 典型應用場景：
  • 顯示測量結果（如尺寸、角度）。
  • 標注識別內容（如零件編號、二維碼內容）。
  • 輸出狀態信息（如檢測結果 "PASS/NG"）。

2. 工具配置與參數說明

2.1 基本參數設置

在 QuickBuild 的屬性面板中，需配置以下關鍵參數：

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 方法確保標簽在運行后持久顯示。

5. 實操

整體工作流

取測量結果Width出來做標簽顯示。

CogCreateGraphicLabelTool具體設置

使用Formatted格式化顯示,顯示雙精度浮點數{D}，且小數保留2位。

最終結果