Operator ImageNumber

Operator Library: Base

算子 ImageNumber 在输出链上提供输入链当前图像的索引。 因此,输入的每个像素都被图像的索引(即图像编号)所取代。 实际的输入像素值不会被使用。 该算子的作用类似于一个 Counter,每当输入端有新图像时,该 Counter 就会递增。 当进程开始('Multiple Processes')或 Counter 达到最大值时,Counter 会被重置。 第一张图像的图像索引将为 0。

可以通过更改输出链 O 的 Bit Width 来定义 Counter 宽度。 如果 Counter 达到最大值,它将从零重新开始 = 循环回绕条件。 例如,8 bit 的输出 Bit Width 将产生介于零到 255 之间的 Counter 值。

使用参数 SingleShot 时,算子在发生循环回绕条件时不会被重置。 Counter 值输出将保持在最大值。 因此,对于 8 bit 的图像 Counter,Counter 值将保持在最大值 255。

该算子通常与算子 RemoveImage 结合使用, 以移除序列中的前 N 张图像。

算子限制

  • 该算子支持空图像。 算子将对这些空图像进行计数。 然而,对于空图像,由于空帧的输出不包含任何像素,因此无法在输出端提供 Counter 值。 在下一个非空图像之后,输出链将提供正确的 Counter 值。

I/O Property

Property 值
Operator Type O
Input Link I,数据输入
Output Link O,数据输出

Supported Link Format

Link Parameter Input Link I Output Link O
Bit Width [1, 64]1 [1, 64]
Arithmetic {unsigned, signed} unsigned
Parallelism any as I
Kernel Columns any 1
Kernel Rows any 1
Img Protocol VALT_IMAGE2D as I
Color Format any VAF_GRAY
Color Flavor any FL_NONE
Max. Img Width any as I
Max. Img Height any as I

1

输入 Bit Width 的范围是 [1, 64]。对于有符号输入,范围是 [2, 64]。对于无符号彩色输入,范围是 [3, 63],对于有符号彩色输入,范围是 [6, 63]。

参数

SingleShot
键入 static 参数
默认 OFF
范围 {OFF, ON}

此参数控制循环回绕条件。 当设置为 OFF 时,Counter 将随着每张处理过的图像进行无限计数, 即会在输出链 Bit Width 定义的最大可能 Counter 值处发生循环回绕。

当设置为 ON 时,Counter 会持续计数,直到达到最大可能值。 Counter 将在达到最大值时停止计数。

使用示例

以下示例展示了算子 ImageNumber 的使用方法: