Operator InsertImage

Operator Library: Synchronization

算子 InsertImage 将多个(n 个)输入链路 I[0] .. I[n-1] 多路复用到输出链路 O 中。 因此,该算子会按顺序在 O 处输出所有输入的输入图像。

该算子将输入图像依次转发到输出端。 首先处理输入链路 I[0],然后是链路 I[1]。处理完链路 I[n-1] 后,算子再次从 I[0] 处的下一幅图像开始,依此类推。 该算子会等待,直到当前选定的输入端出现图像。 因此,无法跳过输入端。 不存在“先到先处理”的策略。

如前所述,该算子在特定时间只转发特定的输入。 在一个输入被处理的同时,所有其他输入都会被阻塞。 如果图像出现在被阻塞的输入端,请确保可以对其进行缓冲,直到其被处理。 此外,用户必须确保多个输入不是由同一个图像源提供,因为这会导致死锁。 有关正确插入的更多信息,请查阅“基础与示例”中的 “Multiplex the Images of Two Cameras”。

对于每个输入 I[k],该算子提供一个控制输入 Ins[k]。 这些输入用于控制是否必须使用图像数据并将其转发到输出端,还是将其丢弃。 Ins[k] 输入接受二进制数据。 如果在相应图像的极首个像素处提供 1,则该图像将被转发到输出端。 而如果在相应图像的极首个像素处提供值 0,则该图像将被处理但会被丢弃。

I[k] 和 Ins[k] 对是同步的,即它们必须由相同的 M-type 源通过 O-type 算子的任意网络提供源。 有关更多信息,请参阅 “M-type Operators with Multiple Inputs”。 因此,这些对不需要 SYNC 算子。

该算子的输出帧率是输入帧率的 n 倍。 但是,输出 Parallelism 并未增加。 因此,输出带宽等于输入带宽,同时可能需要传输更多数据。 在算子处理数据之前,可能需要增加输入的 Parallelism。

I[k] 处的 所有图像可以具有不同的高度和宽度。 对于空的输入图像,控制输入 Ins[k] 将被忽略。 这些图像将不会被转发到输出端,即会被丢弃。

I/O Properties

财产 值
操作员类型 M
输入链接 I[0],数据输入
I[k],数据输入
Ins[k],控制输入
输出链接 O,数据输出

Supported Link Format

链接参数 输入链路 I[0] 输入 Link I[k] 输入链路 Ins[k] 输出链路 O
Bit Width [1, 64]1 作为 I[0] 1 作为 I[0]
Arithmetic {unsigned, signed} 作为 I[0] 未签名 作为 I[0]
Parallelism 任何 作为 I[0] 作为 I[0] 作为 I[0]
内核列 任何 作为 I[0] 1 作为 I[0]
内核行 任何 作为 I[0] 1 作为 I[0]
图像协议 VALT_IMAGE2D 作为 I[0] 作为 I[0] 作为 I[0]
Color Format 任何 作为 I[0] VAF_GRAY 作为 I[0]
颜色口味 任何 作为 I[0] FL_NONE 作为 I[0]
Max. Img Width 任何 任何 与 I[k] 相同 auto2
Max. Img Height 任何 任何 与 I[k] 相同 auto3

1

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

2

最大输出图像宽度是所有 I[k] 输入图像宽度的最大值。

3

最大输出图像高度是所有 I[k] 输入图像高度的最大值。

同步输入和异步输入

  • 同步组:I[k] 和 Ins[k]
  • 所有组之间均为异步关系。

参数

无

Examples of Use

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