VisualApplets
Operator Reference

此参数用于设置内部标记对象时所使用的位数。它还会影响由 2^label_bits 决定的两行图像中可能共存的最大对象数。请注意，Blob 分析所需的 Memory 资源几乎每增加一位就会翻倍。该参数的一个良好取值范围在 7 到 9 位之间，这对于几乎所有应用来说都应该足够了。

如果检测到此地址空间的溢出，运算符将在端口 "ErrorFlagsO" 的位 0 和位 1 上输出错误标志。这些标志在检测到溢出时置位，并在输出帧结束时清零。

选择 Object Detection 所需的邻域。有关像素邻域的详细说明，请参阅 'Definition'。

需要此参数来指定对象的最大高度。例如，10 bit 的高度将不允许对象超过 1024 个图像线的高度。

如果对象超过此限制，它将被分割为两个或多个分离的对象。如果发生这种情况，ErrorFlagsO 端口的第 3 位处的错误标志将与恢复的对象一起置位。

选择最大输出帧大小，即一个输出帧中的最大对象数。

最大输出帧大小由参数 "max_output_frame_size" 指定。如果对象数量超过此大小，算子可以生成新帧或丢弃超出的对象。生成新帧会导致帧结束，即该帧已完成。如果丢弃对象，算子将在 ErrorFlagsO 端口的位编号 2 处输出一个错误标志，并伴随该帧的最后一个有效对象。

请注意，通过 flush 输入也会生成新帧。

该参数用于抑制由 flush 条件且无对象数据引起的空输出帧。

详细的时序图可以在 'Generation of Output Frames - Flush, Empty Frames, Discarding Data' 中找到。

每个对象的 "line_marker" 在 "LineMarkerO" 处输出。Bit Width 由输入 LineMarkerI 输入链路决定。如果未使用线标记，则 Bit Width 设置为 1，其输出为恒定的零。

边界框表示包围对象的最小轴平行矩形。每个坐标值均相对于图像的左上角。Bounding box X0 表示每个对象的最低 x 坐标。它在 "BoundingX0O" 处输出。Bit Width 由输入图像决定。如果未使用边界框，则 Bit Width 设置为一位，其输出为常数零。

边界框表示包围对象的最小轴平行矩形。每个坐标值均相对于图像的左上角。Bounding box X1 表示每个对象的最高 x 坐标。它在 "BoundingX1O" 处输出。Bit Width 由输入图像决定。如果未使用边界框，则 Bit Width 设置为一位，其输出为常数零。

边界框 y0 表示每个对象的最低 y 坐标。此坐标基于算子的内部 Counter。它从处理的第一行图像开始计数。其最大值等于通过参数 max_object_height_bits 设置的最大高度。发生溢出后，Counter 将重新从零开始。

此功能可以替代线标记使用。然而，线标记提供了更多的可能性并允许进行复杂的配置。

该功能在 "BoundingY0O" 处输出。Bit Width 由输入图像决定。如果未使用边界框，则 Bit Width 设置为 1，其输出为恒定的零。

对于 1D 算子（与 2D 算子相反），边界框 y1 表示对象的高度。它在 "BoundingY1O" 处输出。Bit Width 由输入图像决定。如果未使用边界框，则 Bit Width 设置为 1，其输出为恒定的零。

对象的面积定义为所有对象前景像素的总和。此参数用于选择所需的面积模式。如果选择了 "use_area_with_maximum_required_bits"，运算符将自动确定对象最大可能尺寸所需的 Bit Width。对象最大可能尺寸取决于输入链路 I 上的最大宽度和高度。如果图像的所有像素都由前景值组成（即由一个大对象组成的白色输入图像），则可达到对象的理论最大值。

如果用户可以确保对象不会超过指定的面积大小，则可以对此进行参数化设置。如果已知最大对象大小，请选择“use_area_with_specified_bits”。使用参数“area_bits”指定位数。如果完全不需要面积，请选择“area_not_used”。在“area_not_used”模式下，Bit Width 设置为 1，且输出端始终为常量零。

仅当参数“area_mode”设置为“use_area_with_specified_bits”时，此参数才处于启用状态。如果对象的面积大于所选位数允许的范围，斑点分析将在输出链路“ErrorFlagsO”的第 4 位输出溢出标志。

有关重心的说明，请参阅 'Center of Gravity'。

请注意，为了获得正确的结果，在斑点分析之后，必须将输出除以面积。

如果该参数设置为“use_cX_width_maximum_required_bits”，算子将自动确定输出 Bit Width。如果使用较大的输入图像，所需的 Bit Width 可能会非常高。

如果参数值使用“use_cX_with_specified_bits”，则 Bit Width 是可调节的。

如果不需要 x 方向的重心，可以通过选择“cX_not_used”将其关闭。

如果“center_of_gravity_x_mode”设置为“use_cX_with_specified_bits”，则可以在此处更改 Bit Width。否则，该参数将被禁用。

如果手动设置 x 方向重心的 Bit Width，则此参数将被激活并可设置为“used”。如果检测到溢出，算子随后将在输出链路“ErrorFlagsO”的第 5 位输出 1。

有关重心的说明，请参阅 'Center of Gravity'。

请注意，为了获得正确的结果，在斑点分析之后，必须将输出除以面积。

如果该参数设置为“use_cY_width_maximum_required_bits”，算子将自动确定输出 Bit Width。如果使用较大的输入图像，所需的 Bit Width 可能会非常高。

如果参数值使用“use_cY_with_specified_bits”，则 Bit Width 是可调节的。

如果不需要 y 方向的重心，可以通过选择“cY_not_used”将其关闭。

如果在 "center_of_gravity_y_mode" 中设置了 "use_cY_with_specified_bits"，则可以在此处更改 bit 数。否则，该参数将被禁用。

如果手动设置 y 方向重心的 bit 数，此参数将被激活并可设置为 "used"。如果检测到溢出，算子随后将在输出连接 "ErrorFlagsO" 的第 6 个 bit 上输出数字 1。

对象的轮廓长度包括所有边缘，甚至包括孔洞处的边缘。详细解释请参见 'Contour Length'。

如果选择了此功能，可以根据所选的邻域，通过参数 "contour_length_bits_orthogonal_connected" 和 "contour_length_bits_diagonal_connected" 来选择所需的位数。如果选择了 4 邻域，则只能在正交方向上确定轮廓长度。如果选择了 8 邻域，则在正交和对角方向上确定轮廓长度。

如果将 "contour_length_mode" 设置为 "contour_length_used"，则可在此处选择表示正交连接像素的轮廓长度所需的位数。

如果将 "contour_length_mode" 设置为 "contour_length_used"，则可在此处选择表示对角连接像素的轮廓长度所需的位数。只有在选择了 8 邻域时才可能这样做。否则，此参数将被禁用。

轮廓长度可能会导致溢出。如果使用了该标志，一旦发生溢出，就会在端口 "ErrorFlagsO" 的第 7 个 bit 上设置一个错误标志。