運算子 InsertPixel

Operator Library: Synchronization

Library: Synchronization

Operator InsertPixel 會將輸入鏈結 I1 影像中的任意像素插入到 I0 影像中,並在 O 輸出組合後的影像。

插入作業透過二進位輸入鏈結 Ins 進行控制。 若特定像素的 Ins = 1,則將 I1 的值插入至 I0 的影像中。 因此,輸出行的長度會增加插入的像素數量。 例如,若所有像素的 Ins == 1,則 O 處的行長度將會相對於輸入行長度加倍。 所有位於偶數像素座標的輸出像素源自 I0,所有奇數像素則源自 I1。 若所有像素的 Ins == 0,則 O 處的輸出影像等於 I0 處的影像。

所有輸入鏈結必須是同步的,也就是說它們必須透過任意的 O 型 operator 網路,由同一個 M 型 operator 提供來源。

此 operator 會將 Parallelism 加倍以避免頻寬限制。 請注意:插入的像素數量可能不是 Parallelism 的倍數。 在這種情況下,operator 必須在行尾加入虛擬像素(dummy pixels)。 這些虛擬像素的值未定義。 在 VA 模擬期間,虛擬像素會設為零以提升可視性。

I/O Properties

Property Value
Operator Type P
輸入連結 I0,資料輸入
I1,資料輸入
Ins,控制輸入
Output Link O, data output

支援的 Link 格式

Link Parameter 輸入連線 I0 Input Link I1 Input Link Ins Output Link O
Bit Width [1, 64]1 如 I0 1 如 I0
Arithmetic {unsigned, signed} 如 I0 unsigned 如 I0
Parallelism any 如 I0 如 I0 2 * I0
Kernel Columns any 如 I0 1 如 I0
Kernel Rows any 如 I0 1 如 I0
Img Protocol {VALT_IMAGE2D, VALT_LINE1D, VALT_PIXEL0D} 如 I0 如 I0 如 I0
Color Format any 如 I0 VAF_GRAY 如 I0
Color Flavor any 如 I0 FL_NONE 如 I0
Max. Img Width any 如 I0 如 I0 2 * I02
Max. Img Height any 如 I0 如 I0 如 I0

1

無號輸入的 Bit Width 範圍為 [1, 64]。 針對有號輸入,範圍為 [2, 64]。 針對無號彩色輸入,範圍為 [3, 63],而針對有號彩色輸入,範圍為 [6, 63]。

2

輸出影像寬度不得超過 2^31 - 1。

同步與非同步輸入

  • 所有輸入彼此同步,亦即它們必須透過任意的 O 型 operator 網路,由同一個 M 型 operator 提供來源。

參數

無

使用範例

以下範例顯示了 InsertPixel operator 的使用方式: