オペレーター RxImageLink

Operator Library: Synchronization

RxImageLinkオペレーターは、同じデザイン内のTxImageLinkオペレーターから画像を受信するために使用されます。 両方のオペレーターはリンクなしで接続を確立します。 画像フォーマットは同じままであり、つまり、RxImageLinkの出力でのフォーマットは、TxImageLinkが入力で受信するフォーマットと同じです。

TxImageLink オペレーターと RxImageLink オペレーターの間で画像転送を行うことで、デザイン内にループを実装できるようになります。

[注意] ループにはデータバッファリング戦略が必要

オペレーター TxImageLink および RxImageLink はデータをバッファリングしません。そのため、ループを実装する際は、デッドロックを回避するためにデータバッファリングに十分注意する必要があります。

パラメータChannel_IDは、送信側のTxImageLinkオペレーターを指定するためのチャンネルIDを定義します。 パラメータ値は一意である必要があり、デザイン内の他のどのRxImageLinkオペレーターでも使用されてはなりません。

パラメータ値は、同じデザイン内のいずれかのTxImageLinkオペレーターのChannel_IDと一致している必要があります。

デザイン内の各 TxImageLink オペレーターは、1つのチャネルIDを介して正確に1つの RxImageLink オペレーターに接続されます。 VisualAppletsの Resource Dialog で、各 TxImageLink-RxImageLink 接続に対して1つの 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 Property

Property 値
オペレータータイプ M
Input Link I, data input
Output Link O, data output

サポートされているリンクフォーマット

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] です。

パラメーター

Channel_ID
タイプ static パラメータ
Default 0
範囲 [0,1023]

The channel ID of the image link. See descriptions above.

使用例

RxImageLinkオペレーターの使用方法は、以下の例に示されています。