Operator AppendImage

Operator Library: Synchronization

Operator AppendImage 會將輸入影像串接成較大的輸出影像。 輸出連結 O 中組合的影像數量是由參數 AppendNumber 所定義。 例如，當 AppendNumber 設為 2 時， 該 operator 會將兩個連續的影像組合成一個較大的新影像。

請注意，該 operator 會在維持原始頻寬的情況下降低輸出的影格率。 影格率會降低 AppendNumber 倍。

該 operator 的輸出連結影像協定也可以設為 VALT_LINE1D。 在此情況下，operator 會將所有傳入的影像附加到一個高度無限的影像中。 透過這種方式，operator 可用來將 2D 影像串流轉換為 1D 行串流。 如果在 VisualApplets 模擬中使用 2D 轉 1D 轉換，則不會串接影像。 在模擬中，每個輸入影像都會產生一個輸出影像。

當在擷取執行期間動態變更 AppendNumber 值時， operator 會確保影像完整性。 operator 會保留舊的 AppendNumber 值，直到輸出影格完成為止。 在目前輸出影格完成後，operator 將開始使用新的 AppendNumber 值進行進一步的合併。

[注意] 超出最大影像高度

請注意，使用此 operator 可能會超過輸出連結中定義的最大影像高度。 請務必確保串接的輸入影像不超過輸出連結參數設定的最大影像高度。 如果超過影像高度，後續的 operator 可能無法正常運作。

例如，將 3 個高度為 1024 的輸入影像進行串接。 輸出影像高度將為 3072。 因此，輸出連結中的最大影像高度必須設為 3072 或更高， 以確保 VisualApplets operator 的功能正常運作。

[提示] 將 1D 轉換為 2D

如果要執行 1D 到 2D 轉換，可以使用 operator SplitImage。請參閱 operator SplitImage 的說明文件。

I/O Properties

Property Value
Operator Type P
Input Link I, data input
Output Link O, data output

支援的 Link 格式

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

1

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

2

最大輸出影像高度必須大於或等於參數 AppendNumber 乘以輸入影像高度。 然而，如果輸出連結影像協定設為 VALT_LINE1D，則參數 AppendNumber 會停用。

參數

AppendNumber
Type 動態讀取/寫入參數
Default 1
Range [1, Max. Image Height(output link)]

串接成單一輸出影像的輸入影像數量。

此參數僅能在輸出連結影像協定設為 VALT_IMAGE2D 時變更。

LinesToSimulate
Type static read/write parameter
Default 1
Range [1, 2^32 - 1]

模擬 1D 輸出串流中的行數。

此參數僅能在輸出協定設為 VALT_IMAGE1D 時 用於模擬期間。

背景資訊：在 VisualApplets 模擬中，一律會建立 2 維影像。 為了能夠模擬行，建立了此參數（僅供模擬使用）。 此參數允許指定要模擬的行數。 在模擬期間，這些行會組合在一起成為一個 2 維「影像」。 透過這種方式，可以模擬個別的行。 在達到 LinesToSimulate 指定的數量之後傳入的所有行都會被捨棄。 模擬將剛好產生一個 2 維輸出影像。

使用範例

operator AppendImage 的使用方式如以下範例所示：

  上一頁     上一層     下一頁  
內容 頂端 首頁