オペレーター ImageInjector

Operator Library: Debugging

オペレーター ImageInjector を使用すると、オペレーターの画像データ出力に画像をインジェクションできます。 画像はファイルから直接インジェクションできます(ファイル形式:*.tif)。 インジェクションのコマンドは、Framegrabber APIまたはFramegrabber SDK ツールであるmicroDisplayを介して送信できます。

オペレーター ImageInjector は、VisualAppletsでデザインをシミュレーションする際に使用する Simulation Sources と同様に機能しますが、オペレーター ImageInjector は実行時のテストに使用される点が異なります。

インジェクションには、挿入(Insertion)と置き換え(Replacement)の2つの方法がサポートされています。

Insert modes: いずれかの挿入モードが有効な場合、入力リンクはブロックされます。

Replacement modes: いずれかの置き換えモードが有効な場合、 オペレーターは 画像インジェクション中にイメージシンクとして機能します。 入力リンクはブロックされません。

インジェクションされた画像データは、WritePixel および WriteFlag レジスタへの書き込みによってピクセル単位で挿入されます。 書き込みレジスタは、パラメータ ReadyForInjection が「yes」に切り替えられている場合にのみ有効になります。(パラメータ ReadyForInjection が「yes」に設定されるタイミングについては、パラメータ Mode を参照してください。)

インジェクションされた画像の各行の終わり(最終行を除く)には、EndOfLine フラグをWriteFlagレジスタに書き込む必要があります。 最終行の終わりに達したら、EndOfFrame フラグを WriteFlagレジスタに書き込む必要があります。

CurrXPos および CurrYPos パラメータは、 現在アクティブなピクセル位置を指します。

[注] パラメータ EnableInsertModes は、オペレーターの種類をMタイプからPタイプに変更します。

オペレーター ImageInjector はMタイプのオペレーターです。ただし、EnableInsertModes を「no」に設定した場合、オペレーターはVisualAppletsによってPタイプと同様に処理されます。

[注] インジェクションモードの無効化

デフォルトモードの FlowThrough に切り替える(つまり、あらゆる種類のインジェクションを無効にする)ことは、 パラメータ ReadyForFlowThrough が「yes」に設定されている場合にのみ 許可されます。

[重要] ランタイムテスト

この operator は、ランタイム時にデザインをテストおよび解析するように設計されています。 operator をデバッグに使用する前に、デザインをビルド(合成)し、ターゲットハードウェアにロードして、実際の画像処理を開始する必要があります。

この operator は、VisualApplets 内でのデザインシミュレーションを目的としたものではありません。

I/O Property

Property 値
オペレータータイプ M
Input Link I、画像データ入力
Output Link O、画像データ出力

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

Link Parameter Input Link I Output Link O
Bit Width [1, 64] as I
Arithmetic {unsigned, signed} as I
Parallelism 1 as I
Kernel Columns 1 1
Kernel Rows 1 1
Img Protocol {VALT_IMAGE2D, VALT_LINE1D} as I
Color Format any as I
Color Flavor any as I
Max. Img Width any as I
Max. Img Height any as I

パラメーター

モード
タイプ 動的書き込みパラメータ
Default FlowThrough
範囲 {FlowThrough, InsertAfterEof, InsertAfterEol, ReplaceAfterEof, ReplaceAfterEol}

このモードパラメータは、画像のインジェクションを有効または無効にします。 画像インジェクション中、オペレーターは入力リンクをブロックするか(InsertAfterEof、InsertAfterEol)、 インジェクション中に到来する画像データを破棄します(ReplaceAfterEof、ReplaceAfterEol)。

Inject: このモードでは、オペレーターは即座に入力リンクをブロックし、パラメータ ReadyForInjection を「yes」に設定します。 ReadyForInjection が「yes」に設定されるとすぐに、ファイルから画像をインジェクションできます。

FlowThrough: 画像インジェクションが無効になります。 デフォルトモードのFlowThroughに切り替える(つまり、あらゆる種類のインジェクションを無効にする)ことは、パラメータ ReadyForFlowThrough が「yes」に設定されている場合にのみ許可されます。

InsertAfterEof: このモードに設定すると、オペレーターはEnd-of-Frame(EoF)フラグを検索します。 EoFフラグが見つかると(つまり、現在の画像の終わりに達したとき)、 オペレーターは入力リンクをブロックし、パラメータ ReadyForInjection を「yes」に設定します。ReadyForInjection が「yes」に設定されるとすぐに、ファイルから画像をインジェクションできます。 このモードは、LINE-1Dイメージプロトコルでは使用できません。 このモードは、パラメータ EnableInsertModes が「yes」に設定されている場合のみ使用可能であり、 これはオペレーターがMタイプであることを意味します。

InsertAfterEol: このモードに設定すると、オペレーターはEnd-of-Line(EoL)フラグを検索します。 EoLフラグが見つかると(つまり、現在の行の終わりに達したとき)、 オペレーターは入力リンクをブロックし、パラメータ ReadyForInjection を「yes」に設定します。ReadyForInjection が「yes」に設定されるとすぐに、ファイルから画像をインジェクションできます。 このモードは、パラメータ EnableInsertModes が「yes」に設定されている場合のみ使用可能であり、 これはオペレーターがMタイプであることを意味します。

When set to one of the two available relacement modes, the operator acts as an image sink during image injection.

ReplaceAfterEof: オペレーターは現在の画像の終了を待ちます。 EoFフラグが見つかり次第、オペレーターはパラメータ ReadyForInjection を「yes」に設定します。ReadyForInjection が「yes」に設定されるとすぐに、ファイルから画像をインジェクションできます。 インジェクション中、到来する画像データは破棄されます。 LINE-1Dイメージプロトコルでは使用できません。

ReplaceAfterEol: オペレーターは現在の行の終了を待ちます。 EoLフラグが見つかり次第、オペレーターはパラメータ ReadyForInjection を「yes」に設定します。ReadyForInjection が「yes」に設定されるとすぐに、ファイルから画像をインジェクションできます。 インジェクション中、到来する画像データは破棄されます。

EnableInsertModes
タイプ static write parameter
Default いいえ
範囲 {yes, no}

「yes」に設定した場合、パラメータ Mode を挿入モードである InsertAfterEof または InsertAfterEol に設定できます。この場合、 オペレーターはMタイプになります。 「no」に設定した場合、これら2つの挿入モードをパラメータ Mode に設定することはできず、 オペレーターはPタイプになります。

ReadyForInjection
タイプ 動的リードパラメータ
Default いいえ
範囲 {yes, no}

パラメータ Mode が挿入または置き換えモードのときに、 ピクセルまたはフラグを書き込む準備ができていることを示します。 パラメータ WritePixel および WriteFlag を有効にするには、「yes」に設定する必要があります。

ReadyForFlowThrough
タイプ 動的リードパラメータ
Default いいえ
範囲 {yes, no}

(パラメーターModeの)FlowThrough モードに戻す準備ができていることを示します。

WriteFlagパラメータを指定すると、パラメータは自動的に「yes」に設定されます。

  • IMAGE-2DモードではEndOfFrameが書き込まれるか、
  • LINE-1Dモードでは、EndOfLineが書き込まれます。

CurrXPos
タイプ 動的リードパラメータ
Default 0
範囲 [0, MaxImageWidth-1]

現在の行位置を表示します。

CurrYPos
タイプ 動的リードパラメータ
Default 0
範囲 [0, MaxImageHeight-1]

現在の画像の高さ位置を表示します。

ライトピクセル
タイプ 動的書き込みパラメータ
Default 0
範囲 [0, 2^ビット幅-1]

ピクセル値。24ビットカラー形式を使用する場合は、次のビットマッピングを適用する必要があります。赤 = [0, 7]、緑 = [9,15]、青 = [16,23]。

書き込みフラグ
タイプ 動的書き込みパラメータ
Default 行末
範囲 {行末、フレーム末}

挿入する各行の末尾にEndOfLineフラグを書き込む必要があります。ただし、画像の最後の行の末尾には書き込む必要はありません。

挿入された画像の最終行の末尾にEndOfFrameフラグを書き込む必要があります。

このパラメータは、 ReadyForFlowThroughパラメータにも影響を与えます。

パラメーターReadyForFlowThroughが「yes」に設定されているときは、

  • IMAGE-2DモードではEndOfFrameが書き込まれるか、
  • LINE-1Dモードでは、EndOfLineが書き込まれます。

[注] 一度に1つの旗のみを使用してください

画像の最後に、このパラメータにEndOfFrameフラグのみを書き込みます。

EoLとEoFを一緒に記述しないでください。EoFは常にEoL+EoFを含みます。

画像ファイル
タイプ 動的書き込みパラメータ
Default 画像.tif
範囲

挿入する画像ファイル。画像サイズは、出力リンクプロパティで指定されたサイズ以下である必要があります。画像ファイルのピクセル深度は、コンポーネントごとに8ビットまたは16ビットです。コンポーネントごとの画像ピクセル深度が、リンクプロパティで定義されたコンポーネントごとのビット幅と等しくない場合、画像コンポーネントは、リンクプロパティで定義されたピクセルコンポーネントに最上位ビット(MSB)が揃うようにシフトされます。microDisplayでファイルを選択するには、ファイルパスを手動で設定するか、このパラメータを右クリックしてファイル選択メニューを開きます。

InjectFromFile
タイプ 動的書き込みパラメータ
Default いいえ
範囲 {いいえ、はい}

"yes"に設定すると、イメージファイルが出力リンクにインジェクトされます。FlowThroughモード(つまり、パラメータModeがFlowThroughに設定されている場合)では無効になります。

使用例

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