Painter vTool#
Painter vTool 通过 Image 输入引脚接收图像，通过 Data 输入引脚接收用于绘制的数据。此数据由其他 vTool（例如 Texts 或 Regions）的输出引脚数据定义。vTool 通过 Image 输出引脚输出已绘制了数据的图像。
下载 pylon Software Suite 以使用 Painter vTool。
运作原理#
将要添加到图像中的数据的 vTool 输出引脚连接到 Painter vTool 的其中一个 Data 输入引脚，例如 Barcode Reader vTool 的 Texts 输出引脚。您可以根据需要通过 Num Input Data Pins 参数指定 Data 输入引脚的数量。
Painter vTool 在图像中绘制以下数据：
- 几何形状：矩形、圆形、椭圆形、线条、点和区域
- 文本：字符串、整数、浮点数和布尔值。或者，还可以绘制几何数据、图像和变换数据的文本表示形式。
还支持这些类型的数组。几何数组按元素进行绘制。除非提供了匹配的坐标数组，否则字符串、数字或布尔值的数组将合并为一个文本块。
使用 Input Data Pin Selector 参数选择要配置的 Data 引脚。绘制、颜色和文本放置均按引脚进行配置。有关更多详细信息，请参阅下面的 Configuration Settings。
您可以使用 Features - All 面板在配方运行时测试设置。
配置设置#
- Num Input Data Pins: 指定 vTool 提供的 Data 输入引脚数量。您最多可以添加 100 个引脚。在配方运行时，无法更改此参数。
- Input Data Pin Selector: 设置要配置其设置的 Data 引脚。以下参数适用于所选引脚，但适用于整个 vTool 的 Output Pixel Format 除外。
- Pin Description: 所选引脚的可选说明，例如用于记录连接了什么。此值仅供用户参考，不用于绘制。
- Draw Enable: 启用或禁用所选引脚的绘制功能。
- Draw Outline Enable: 启用或禁用在所选引脚上绘制矩形、圆形、椭圆形和区域边界框的轮廓。
- Draw Center Enable: 启用或禁用在所选引脚上为矩形、圆形、椭圆形和区域边界框绘制中心标记。
- ToString Enable: 启用或禁用在所选引脚上绘制几何数据、图像和变换数据的文本表示形式。无论此设置如何，字符串、整数、浮点数和布尔值始终作为文本绘制。
- Pen Color Red / Green / Blue / Alpha: 用于所选引脚上的轮廓、Fill、中心标记和文本的颜色。alpha 分量用于填充区域时。
- Pen Width: 绘制线条的宽度。对于点，此值还决定了所绘制标记的大小。
- Font Size: 在所选引脚上绘制的文本大小。
- Size Offset: 添加到矩形、圆形、椭圆形和区域边界框大小的偏移量，以便绘制的轮廓不会与感兴趣区域重叠。
- Text Offset X / Text Offset Y: 添加到文本区域原点的偏移量。
- Text Position： 文本区域相对于直线、矩形、圆形、椭圆形或区域边界框的原点。
- Top Left：文本区域的原点位于几何图形的左侧。
- Top Right：文本区域的原点位于几何图形的右侧。
- Bottom Left：文本区域的原点位于几何图形左侧下方。
- Bottom Right：文本区域的原点位于几何图形右侧下方。
- Center：文本区域的原点位于几何图形的中心。
- Text Coordinate Data Pin Index：另一个 Data 引脚的索引，其几何图形用于放置来自所选引脚的文本。例如，可以使用此功能将条形码文本放置在接收自不同引脚的区域或矩形旁边。索引为 0 时将关闭此功能，并使用所选引脚自身的数据来确定文本位置。
- Text Box Origin： 用于书写文本的起始角。
- Top Left：文本从左上角开始书写。
- Bottom Left：文本从左下角开始书写。
- Text Format： 定义绘制文本时的打印内容。如果此 parameter 为空，则使用数据的默认表示形式。诸如
{Width},{Height},{Center_X},{Radius}和{_Hour_}之类的占位符将被替换为来自数据的值。如果将格式从编辑器复制到 parameter 的编辑框中，则支持换行符。有关占位符的完整列表，请选择 Text Format 并查看 Feature Documentation 窗格。 - Output Pixel Format： 绘制的输出图像的 Pixel Format。输入图像在绘制前会被转换为此格式。
- BGR8：彩色输出图像
- Mono8：单色输出图像
配置 vTool#
要配置 Painter vTool，请在 Workbench 中双击它。随即会打开一个对话框，其中显示所有可用的设置。或者，您也可以在 Features - All 窗格中找到相同的设置。
您可以在 pin data view 中查看 Painter vTool 的结果。
输入#
图像#
直接从 Camera vTool 或从输出图像的 vTool（例如 Image Format Converter vTool）接受图像。
- 数据类型：图像
- 图像格式：在绘制之前，输入图像会被转换为由 Output Pixel Format 参数（BGR8 或 Mono8）所选定的格式。
Data1#
接受可绘制到图像中的任意类型的数据。附加的 Data 输入引脚将根据 Num Input Data Pins 参数启用。
- 数据类型：初始时为 Value。建立连接后，输入引脚将采用所连接输出引脚的 数据类型。
输出#
图像#
返回附加了绘制内容的图像。
- 数据类型：图像
- 图像格式：BGR8 或 Mono8，具体取决于 Output Pixel Format 参数。
相关的 vTools#
典型前置项#
典型后置项#
- 接受 Image 数据类型输入的任何 vTool。