Operator RxImageLink

Operator Library: Synchronization

RxImageLink運算子用於從 TxImageLink 運算子傳送影像。 這兩項運算子均會在無需建立連結的情況下建立連線。 影像格式保持不變,也就是說,RxImageLink 的輸出格式與TxImageLink的輸入格式相同。

透過 TxImageLink 與 RxImageLink 運算子之間的影像傳輸, 即可在設計中實作迴圈。

[注意] 迴圈需要資料緩衝策略

運算子 TxImageLink 與 RxImageLink 不會 進行資料緩衝。因此,在實作迴圈時,您必須特別注意資料緩衝,以避免 發生死結。

參數Channel_ID用於定義一個通道 ID,用以識別 發送端的TxImageLink運算子。 該參數的值必須是唯一的,且設計中不得有任何其他 RxImageLink 運算子使用該值。

該參數值必須與同一設計中某個 TxImageLink運算子的Channel_ID相符。

設計中的每個 TxImageLink 運算子都透過一個通道 ID 連線至剛好一個 RxImageLink 運算子。 在 VisualApplets 的 Resource Dialog 中,您可以看到每個 TxImageLink-RxImageLink 連線都會使用一個 ImageChannel 資源。 資源 ImageChannel 可讓您控制個別 TxImageLink 運算子對應至個別 RxImageLink 運算子的指派狀況。 關於可用 ImageChannel 資源的數量 (這也定義了設計中允許的最大 TxImageLink 與 RxImageLink 運算子數量), 請參閱 Device Resources。

[重要] 迴圈中連線格式的參數化

一旦開啟連線屬性對話方塊, 「自動更新」(automatic update) 功能就會根據運算子鏈的組態調整連線屬性(例如 Bit Width 或影像尺寸)。TxImageLink 的輸入格式 永遠會定義 RxImageLink 的輸出格式(100% 自動一致性)。 因此,當您使用運算子 TxImageLink 和 RxImageLink 來實作迴圈時,您必須特別注意連線格式的參數化。

範例

錯誤的實作方式,連線參數 Bit Width 的值 在每次迴圈迭代時都會增加:

正確的實作方式,運算子 CastBitWidth 會將連線參數 Bit Width 的值在每次迴圈迭代時改回原始值:

[重要] 在不同階層式設計層級之間同步通道

若您使用 TxImageLink/RxImageLink 配對來建立不同層級設計之間的数据傳輸通道, 此連接將被視為 M 運算子。因此,您可能需要實作額外的同步元件 (直接連接則無此需求。)

I/O Properties

Property Value
Operator Type M
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_PIXEL0D, VALT_SIGNAL} as I
Color Format any as I
Color Flavor any as I
Max. Img Width any as I
Max. Img Height any as I

1

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

Parameters

Channel_ID
Type 靜態參數
Default 0
Range [0,1023]

影像連線的通道 ID。 請參閱上述說明。

Examples of Use

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