Operator AppendLine

Operator Library: Synchronization

「AppendLine」運算子會將輸入影像（連結點 I）中的影像行，併合至輸出影像（連結點 O）中的一條較長行上。 併合至新行中的行數由參數「AppendNumber」定義。 例如，當AppendNumber設定為 2 時，此運算子會將輸入影像中的 2 條連續線段串接成輸出影像中的一條較長新線段。 當輸入影像的高度無法被AppendNumber參數值整除時，輸出影像中的最後一條線段會較短， 且將包含輸入影像中剩餘的最後幾條線段串接而成的內容。

請注意，該運算子既不會改變幀率，也不會改變頻寬。

該運算子的輸出連結影像協定亦可設定為 VALT_PIXEL0D，亦即該運算子會將所有輸入的 行併入一條寬度無限制的行中。 因此，可利用該運算子將 2D 影像串流或 1D 線串流轉換為 0D 像素串流。

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

[警告] 防止圖片尺寸超過最大限制

使用此運算子時，可能會超過輸出連結中定義的最大影像寬度與高度。因此， 請務必確保串接後的輸入行總寬度，不會超過輸出連結所設定的參數化最大影像寬度。 同時也請確認，輸出連結所設定的參數化最大影像高度是否足夠大。 若影像寬度或高度超過連結屬性所指定的限制，後續的運算子可能無法正常運作。

例如，將 3 條寬度為 1024 的輸入線進行拼接。 輸出影像的寬度將為 3072。 必須在輸出連結中指定此寬度，以確保「VisualApplets 」運算子的正常運作。

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_LINE1D} {VALT_IMAGE2D, VALT_LINE1D, VALT_PIXEL0D}
Color Format any as I
Color Flavor any as I
Max. Img Width any any2
Max. Img Height any any

1

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

2

影像的最大寬度必須大於或等於參數 AppendNumber乘以輸入影像寬度的結果。

Parameters

AppendNumber
Type 動態讀取/寫入參數
Default 1
Range 輸入 IMAGE2D：[1, 輸入最大影像高度]；輸入 LINE1D：[1, 輸出最大影像寬度 /Parallelism]

將多少條輸入行拼接成單一行輸出的數量。

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

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

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

此參數僅能在模擬過程中使用，前提是輸入影像協定設定為 VALT_IMAGE2D，且輸出協定設定為 VALT_IMAGE1D。

僅產生一張輸出影像。其餘的輸入行將被捨棄。

PixelsToSimulate
Type 靜態讀取/寫入參數
Default 1
Range [1, 2^32 - 1]

模擬的 0D 輸出串流中的輸入像素數。

此參數僅可在模擬期間使用，且須滿足以下條件：輸入影像通訊協定設定為 VALT_IMAGE2D 或 VALT_IMAGE1D，且輸出通訊協定設定為 VALT_IMAGE0D。

僅會產生一張輸出影像。其餘的輸入像素將被捨棄。

Examples of Use

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

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