VisionPro二次开发学习笔记5-使用C#注释图像

Visual Studio.NET应用程序可以在获取的图像上显示图形和文本。

静态和交互式图形类

VisionPro支持将CogStaticGraphicsContainer图形添加到CogDisplay图像后无法移动或更改，并且支持CogInteractiveGraphicsContainer图形，如果启用了Interactive属性，则可由应用程序或用户移动或修改。

静态文字示例

以下C＃语句向现有应用程序添加静态标签，该应用程序在CogDisplay对象CogDisplay1中显示图像：

using Cognex.VisionPro;

private CogGraphicLabel cglCaption;
private Font myFont;

private void InitializeStaticGraphics()
{
        cglCaption = new CogGraphicLabel();

        // 设置文本和对齐属性
        cglCaption.Text = "Cognex Display Control";
        cglCaption.Alignment = CogGraphicLabelAlignmentConstants.TopLeft;

        // 创建字体并设置给标签                      
        myFont = new Font("Comic Sans MS", 16, FontStyle.Bold);
        cglCaption.Font = myFont;

        // 设置标签的空间名称为 "#"，表示标签的坐标系与图像坐标系相同，并且会随着图像的移动而移动。
        cglCaption.SelectedSpaceName = "#";

        // 将标签的位置设置为 (0, 0)，即放置在显示控件的左上角
        cglCaption.X = 0;
        cglCaption.Y = 0;

        // 将创建的标签添加到 cogDisplay1 的静态图形集合中。第二个参数是标签的文本，用于标识该图形
        cogDisplay1.StaticGraphics.Add(cglCaption, cglCaption.Text);
}

总结

创建一个静态文本标签并将其添加到 Cognex VisionPro 的显示控件中。标签的文本内容、字体样式、对齐方式和位置都被精确设置，从而使其在显示控件上以可读的方式呈现。由于标签是静态图形，它不会随图像的变化而变化，这对于显示固定信息（如标题或说明）非常有用。

交互式图形示例

以下C＃语句向现有应用程序添加一个交互式标签，该标签在CogDisplay对象CogDisplay1中显示图像。该应用程序包含一个TextBox控件，textBox1和一个按钮button2。每次用户在TextBox控件中输入文本并按下按钮时，CogDisplay1中的交互式标签都会用用户输入的文本进行更新。

using Cognex.VisionPro;

private CogGraphicLabel cglCaption;
private Font myFont;

private void InitializeInteractiveGraphics()
{
        cglCaption = new CogGraphicLabel();
 
        cglCaption.Text = "Cognex Display Control";
        cglCaption.Alignment = CogGraphicLabelAlignmentConstants.TopLeft;
                       
        myFont = new Font("Comic Sans MS", 16, FontStyle.Bold);
        cglCaption.Font = myFont;

        // 设置标签的空间名为 "*"，表示它将被锚定在图像上。
        cglCaption.SelectedSpaceName = "*";

        cglCaption.X = 0;
        cglCaption.Y = 0;

         // 将标签添加到 cogDisplay1 控件的交互图形中，使用标签的文本作为标识。
        cogDisplay1.InteractiveGraphics.Add(cglCaption, cglCaption.Text, false);
}

private void button2_Click(object sender, System.EventArgs e)
{
        string output;

        output = "Text: " + textBox1.Text;
        cglCaption.Text = output;
}

总结

这段代码的主要功能是在一个 Cognex VisionPro 应用程序中创建一个文本标签，并在按钮点击时动态更新该标签的文本内容。标签的位置和样式都经过了设置，以确保它在图像上正确显示。