运算符 CreateBlankImage

运算符 Library: Synchronization

该算子会生成具有指定宽度和高度的空白二值图像。 该算子不需要任何输入链路。 输出图像的宽度和高度通过参数 ImageWidth 和 ImageHeight 进行指定。

该算子将以尽可能高的速度输出空白图像。 因此,输出速度仅受输出链路 Parallelism 以及后续算子的限制。 如果后续算子无法处理由 CreateBlankImage 产生的数据速率,VisualApplets 流控制将会限制带宽。

通常,该算子用于测试实现的各项功能,而无需连接相机。 借助诸如 Coordinate_x、 Coordinate_y 和 ImageNumber 等算子,该算子可用于生成 Test Patterns。 结合 ImageValve 算子,可以控制帧率、行率或像素率。

生成图像的尺寸只能在采集未运行(即停止)时更改。

对于 1D 应用,ImageHeight 参数将被忽略。 对于 0D 应用,ImageWidth 和 ImageHeight 均会被忽略。

该算子可以非常方便地与 VisualApplets 仿真一同使用。 该算子自身可生成仿真图像。 它作为一个仿真源运行。 因此,无需在算子的输出链路上添加仿真源探针。

[注意] 仿真期间的行为

该算子在每个仿真步骤中至少输出一个数据集。根据输出端当前的链路配置, 该数据集为

  • 0D 模式下的一系列像素。像素数量通过参数 PixelsToSimulate 控制
  • 1D 模式下的一系列行。行数通过参数 LinesToSimulate 控制
  • 2D 模式下的一系列帧。帧数通过参数 FramesToSimulate 控制

这些参数的默认值为 1。根据输出端当前的链路配置,只有相关的 参数可编辑,其他参数处于非活动状态。例如,对于 0D,只有 PixelsToSimulate 可编辑,而对于 1D,参数 LinesToSimulate 和 ImageWidth 可编辑。

如果在采集过程中更改参数 ImageHeight 或 ImageWidth,该算子可保证图像完整性。 在当前帧输出完成后,算子将开始使用新的参数值。

I/O Property

Property 值
Operator Type M
Output Link O,数据输出

Supported Link Format

Link Parameter Output Link O
Bit Width 1
Arithmetic unsigned
Parallelism any
Kernel Columns 1
Kernel Rows 1
Img Protocol {VALT_IMAGE2D, VALT_LINE1D, VALT_PIXEL0D}
Color Format VAF_GRAY
Color Flavor FL_NONE
Max. Img Width any
Max. Img Height any

参数

ImageWidth
键入 动态/静态读/写参数
默认 1024
范围 [0, 最大输出图像宽度],步长 = 输出 Parallelism

指定生成图像的宽度。 只有当算子的输出图像协议设置为 VALT_IMAGE2D 或 VALT_LINE1D 时,该参数才启用。

ImageHeight
键入 动态/静态读/写参数
默认 1024
范围 [1, Maximum Output Image Height]

指定生成图像的高度。 只有当算子的输出图像协议设置为 VALT_IMAGE2D 时,该参数才启用。

FramesToSimulate
键入 静态写参数
默认 1
范围 [1, 2^32 - 1]

如果输出链路图像协议设置为 VALT_IMAGE2D, 则该参数指定单个仿真步骤生成的帧数。 有关 2D 仿真的更多信息,请参见 'Simulation'。 只有当输出图像协议设置为 VALT_IMAGE2D 时,才能更改此参数。

LinesToSimulate
键入 静态写参数
默认 1
范围 [1, 2^32 - 1]

如果输出链路图像协议设置为 VALT_LINE1D, 则需要指定用于仿真的行数。 该参数用于指定仿真图像高度。 有关 1D 仿真的更多信息,请参见 'Simulation'。 只有当输出图像协议设置为 VALT_LINE1D 时,才能更改此参数。

PixelsToSimulate
键入 静态写参数
默认 1
范围 [1, 2^32 - 1],步长 = 输出 Parallelism

如果输出链路图像协议设置为 VALT_PIXEL0D, 则需要指定用于仿真的像素流大小。 该参数用于指定仿真像素流宽度。 有关 0D 仿真的更多信息,请参见 'Simulation'。 只有当输出图像协议设置为 VALT_LINE0D 时,才能更改此参数。

使用示例

CreateBlankImage 算子的使用方法见以下示例: