Operator TxImageLink

Operator Library: Synchronization

TxImageLink運算子可將影像傳送至一個 RxImageLink 運算子,無論該運算子位於設計中的何處。 這兩者皆可在無需建立連結的情況下建立連線。

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

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

運算子TxImageLink和RxImageLink 不會對資料進行緩衝。因此,在實作迴圈時,您必須特別注意資料緩衝的問題,以避免 死鎖。

VisualApplets 一般所支援的所有影像格式皆受支援。 影像格式保持不變,也就是說,RxImageLink 的輸出格式與 TxImageLink的輸入格式相同。

參數Channel_ID用於定義一個通道 ID,以識別 接收端的RxImageLink運算子。 此參數的值必須是唯一的,且不得與設計中任何其他 TxImageLink 運算子重複。

在該設計中,必須存在且僅存在一個RxImageLink 運算子,該運算子使用相同的通道 ID 並接收影像資料。

設計中的每個TxImageLink運算子皆透過一個通道 ID 連接至恰好一個RxImageLink運算子。 在VisualApplets 的「資源對話方塊」中,您可以看到每組TxImageLink-RxImageLink連接皆使用 一個ImageChannel資源。 ImageChannel資源可控管個別TxImageLink運算子與個別RxImageLink運算子之間的對應關係。 關於可用的ImageChannel資源數量 (這同時也定義了設計中允許的TxImageLink與RxImageLink運算子最大數量), 請參閱 裝置資源。

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

一旦開啟連結屬性對話方塊, 「自動更新」功能便會根據運算子鏈的配置, 調整連結屬性(例如位元寬度或影像尺寸)。TxImageLink的輸入格式 始終決定RxImageLink的輸出格式(100% 自動一致性)。 因此,當您使用TxImageLink和RxImageLink運算子 來實現迴路時,必須特別注意連結格式的參數設定。

範例

實作錯誤,link 參數的值 Bit Width 在每次循環迭代時都會增加:

正確的實作方式:運算子 `castBitWidth` 會在迴圈的每次迭代中,將 `link` 參數的值 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

對於無符號值,輸入位元寬度的範圍為 [1, 64]。 對於有符號輸入,範圍為 [2, 64]。 對於無符號色彩輸入,範圍為 [3, 63];對於有符號色彩輸入,範圍為 [6, 63]。

Parameters

頻道_ID
Type 靜態參數
Default 0
Range [0, 1023]

圖片連結的頻道 ID。 請參閱上方的說明。

Examples of Use

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