Operator AppendImage

Operator Library: Synchronization

「AppendImage」運算子會將輸入影像拼接成一張較大的輸出影像。 在輸出鏈結 O 處拼接的影像數量，由參數AppendNumber 決定。 例如，當AppendNumber設定為 2 時， 該運算子會將兩張連續的影像拼接成一張新的、較大的影像。

請注意，此運算子在維持原始頻寬的同時，會降低其輸出的幀率。 幀率將按AppendNumber 的倍數降低。

該運算子的輸出連結影像協定亦可設定為 VALT_LINE1D。 在此情況下，該運算子會將所有輸入影像併接成一張高度不限的影像。 如此一來，即可利用該運算子將 2D 影像串流轉換為 1D 線性串流。 若在「VisualApplets 」模擬中使用 2D 至 1D 轉換，則不會將影像串接。 在模擬中，每張輸入影像都會產生一張輸出影像。

在資料擷取執行期間動態變更AppendNumber值時， 操作員會確保影像的完整性。 操作員會保留舊的AppendNumber值，直到當前輸出幀處理完畢為止。 當前輸出幀處理完畢後，操作員將開始使用新的AppendNumber值進行後續的合併作業。

[注意] 超出最大圖片高度

請注意，使用此運算子時，可能導致影像高度超過輸出鏈路中定義的最大值。 請務必確保串接後的輸入影像高度不超過輸出鏈路中設定的最大影像高度。 若影像高度超過限制，後續的運算子可能會無法正常運作。

舉例來說，將 3 張高度為 1024 的輸入影像進行拼接。 輸出影像的高度將為 3072。 因此，必須將輸出鏈路中的最大影像高度設定為 3072 或更高， 以確保「VisualApplets 」運算子的功能運作正常。

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

若要執行一維轉二維的轉換，您可以使用 SplitImage 運算子。請參閱 SplitImage 運算子的文件。

I/O Properties

Property Value
Operator Type P
Input Link I，資料輸入
Output Link O，資料輸出

Supported Link Format

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將被停用。

Parameters

AppendNumber
Type 動態讀取/寫入參數
Default 1
Range [1，最大影像高度（輸出連結）]

將多少張輸入影像拼接成單張輸出影像。

只有當輸出連結的影像協定設定為 VALT_IMAGE2D 時，才可變更此參數。

LinesToSimulate
Type 靜態讀取/寫入參數
Default 1
Range [1, 2³² - 1]

模擬的一維輸出資料流中的行數。

此參數僅在以下情況下才可在模擬過程中使用： 當輸出協定設定為 VALT_IMAGE1D 時。

背景資訊：在VisualApplets 模擬中，系統總是會產生二維影像。 為了能夠模擬線條，因此建立了此參數（僅供模擬使用）。 此參數可指定要模擬的線條數量。 在模擬過程中，這些線條會被組合成一張 2 維「影像」。 如此一來，便能模擬個別的線條。 當達到 `LinesToSimulate` 所指定的數量後，所有後續輸入的線條都會被捨棄。 模擬過程中，會產生且僅產生一張 2 維輸出影像。

Examples of Use

以下範例展示了 AppendImage 運算子的使用方式：

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