Operator InsertPixel

Operator Library: Synchronization

函式庫:同步化

運算子 InsertPixel 會將輸入連結 I1 上的影像中的任意像素, 插入至 I0 上的影像中,並在 O 輸出合併後的影像。

插入操作是透過二進位輸入連結 Ins 來控制的。 若某個像素的 Ins 值為 1,則 I1 處的值會被插入至影像的 I0 位置。 因此,輸出線長度會增加等同於插入像素的數量。 例如,若所有像素的Ins== 1,則 O 處的行長度將 相較於輸入行長度增加一倍。 所有位於偶數像素座標的輸出像素均源自 I0,所有位於奇數像素座標的則源自 I1。 若所有像素的Ins== 0,則 O 處的輸出影像將等同於 I0 處的影像。

所有輸入鏈路都必須是同步的,也就是說,它們必須由同一個 M 型 運算子,透過任意 O 型運算子組成的網路來提供。

操作員將並行度加倍,以避免帶寬限制。 請注意:插入的像素數可能並非並行度的倍數。 在此情況下,操作員必須在行尾新增虛擬像素。 這些虛擬像素的數值未定義。 在 VA 模擬過程中,為提高可視性,虛擬像素會被設為零。

I/O Properties

Property Value
Operator Type P
Input Links I0,資料輸入
I1,資料輸入
Ins,控制輸入
Output Link O,資料輸出

Supported Link Format

Link Parameter 輸入連結 I0 輸入連接線 I1 輸入連結 Ins Output Link O
Bit Width [1, 64]1 如同 I0 1 如同 I0
Arithmetic {unsigned, signed} 如同 I0 無號數 如同 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。

Synchronous and Asynchronous Inputs

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

Parameters

無

Examples of Use

以下範例展示了 InsertPixel 運算子的使用方式: