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

CogCreateGraphicLabelTool工具

news 来源：原创 2025/5/10 2:26:04

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	-	-