Operator TrgPortLine

Operator Library: Hardware Platform

このオペレーターは、カメラのトリガー(Exsync)を生成します。 また、取得したラインを組み合わせて画像を作成する役割も担います。

内部信号ジェネレーター(GrabberControlled)を使用するか、または外部信号によって信号ジェネレーターをトリガーすることが可能です。 外部信号には、トリガー拡張ボード(TTL TriggerボードまたはOPTO Triggerボード)からの入力信号、またはソフトウェアを使用できます。 信号ジェネレーターは、柔軟な遅延、パルス幅、および極性を持つExsync信号を生成できます。 さらに、トリガー拡張ボードで使用可能なフラッシュ信号が生成されます。

このオペレーターは、4つのデジタル出力と、CC信号用の1つのカメラポートを占有します。 したがって、CameraControl型のVisualAppletsリソースが1つ使用されます。 リソースインデックスが0に設定されている場合、デジタル出力0~2とカメラポートAが使用されます。 リソースインデックスが1に設定されている場合、デジタル出力4~6とカメラポートBが使用されます。 出力3および7はこのオペレーターでは使用されません。 他のオペレーターがこれらのハードウェアリソースを使用することはできない点に注意してください。 リソースダイアログでリソースインデックスを設定してください。

ハードウェアプラットフォームで使用可能
microEnable IV VD1-CL/-PoCL
microEnable IV VD4-CL/-PoCL

I/O Property

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

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

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

パラメーター

YOffset
タイプ dynamic/static read/write parameter
Default 0
範囲 [0, 224]

このパラメーターは、フレームの先頭で除外するライン数を定義します。

YLength
タイプ dynamic/static read/write parameter
Default 1024
範囲 [8, 224]

このパラメーターは、1フレームのライン数を定義します。

MaxGatedHeight
タイプ ダイナミック読み取り/書き込みパラメータ
Default restricted
範囲 {restricted, unrestricted}

パラメーター MaxGatedHeight を使用すると、画像トリガーモード(ImgTriggerMode)が ExternSw_Gate に設定されている場合に、最大画像高さを制限できます。

画像トリガーモード(ImgTriggerMode)が ExternSw_Gate に設定されており、かつパラメーター MaxGatedHeight が unrestricted(制限なし)に設定されている場合、画像の高さはゲートが開いている時間、つまり外部画像トリガー信号のパルス幅またはソフトウェアトリガーの値が1である持続時間によって定義されます。 このとき、ゲートが長時間開いていると、画像の高さ大きくなります。 パラメーター MaxGatedHeight が restricted(制限あり)に設定されている場合、ゲートが開いたままであっても、画像の高さは YLength 画像ラインに制限されます。 オペレーターはそれ以降のラインを破棄し、次のゲートが開くのを待って新しいフレームを開始します。

対照的に、パラメーターが unrestricted に設定されている場合、画像の高さはゲートによってのみ定義されます。

[Warning] Link Property違反の可能性があります

unrestricted モードでこのパラメーターを使用すると、VisualAppletsのリンクプロトコル違反が発生する可能性があります。 画像の高さが、TrgPortLine オペレーターの出力リンクで定義されている許可された最大画像高さを超える可能性があります。 unrestricted モードを使用する際は注意してください。 リンクプロパティの詳細については、'Link Properties'を参照してください。

後続の SplitImage オペレーターを使用すると、大きな画像をチャンク(より小さな画像)に分割できます。

LineTriggerMode
タイプ dynamic/static read/write parameter
Default GrabberControlled
範囲 {GrabberControlled, Extern_Trigger, GrabberControlled_Gated_by_Img, Extern_Trigger_Gated_by_Img}

このパラメーターは、内部Exsync信号ジェネレーターの動作モードを選択します。 外部トリガー入力のソースは、パラメーター LineTrgInSourceA および LineTrgInSourceB を介して選択できます(下記参照)。

GrabberControlled: 内部信号ジェネレーターによってExsyncが定期的に生成されます

Extern_Trigger: 外部トリガー信号を使用して、信号ジェネレーターを1回起動します

GrabberControlled_Gated_by_Img: フレームの取り込み中、内部信号ジェネレーターによってExsyncが定期的に生成されます

Extern_Trigger_Gated_by_Img: フレームの取り込み中、外部トリガー信号を使用して信号ジェネレーターをトリガーします

ExsyncEnable
タイプ 動的読み取り/書き込みパラメータ
Default OFF
範囲 {OFF, ON}

カメラへのExsync出力を有効または無効にします。

LineTrgInSourceA
タイプ dynamic/static read/write parameter
Default InSignal0
範囲 {InSignal0, InSignal1, InSignal2, InSignal3, InSignal4, InSignal5, InSignal6, InSignal7}

このパラメーターは、Exsync信号ジェネレーターのトリガーに使用する信号ソースを指定します。 これは、TriggerMode が Extern_Trigger に設定されている場合にのみ有効です。

LineTrgInSourceB
タイプ dynamic/static read/write parameter
Default InSignal0
範囲 {InSignal0, InSignal1, InSignal2, InSignal3, InSignal4, InSignal5, InSignal6, InSignal7}

このパラメーターは、Exsync信号ジェネレーターのトリガーに使用する信号ソースを指定します。 これは、TriggerMode が Extern_Trigger に設定されており、かつ EncoderABMode が Signal_AB_Filter に設定されている場合にのみ有効です。

EncoderABMode
タイプ dynamic/static read/write parameter
Default Signal_A_Only
範囲 {Signal_A_Only, Signal_AB_Filter, Signal_ABx2_Filter, Signal_ABx4_Filter}

このパラメーターは、Exsync生成に単一のトリガー入力(Aのみ)を使用するか、シグナルAおよびBの両方を使用するかを指定します。

シグナルA/Bサポートにより、シャフトエンコーダーの回転方向の特定、および逆回転の抑制と補正が可能になります:

Signal_A_Only: LineTrgInSourceAによって選択されたトリガー入力がExsync生成に使用されます。

Signal_AB_Filter: シャフトエンコーダーの正転に対してシングル解像度でExsyncが生成されます。つまり、LineTrgInSourceAの立ち上がりエッジに対してトリガーパルスが生成されます。

Signal_ABx2_Filter: シャフトエンコーダーの正転に対してダブル解像度でExsyncが生成されます。つまり、LineTrgInSourceAの立ち上がりエッジと立ち下がりエッジに対してトリガーパルスが生成されます。LineTrgInSourceAの両方のエッジが使用されます。

Signal_ABx4_Filter: シャフトエンコーダーの正転に対してクアッド解像度でExsyncが生成されます。つまり、LineTrgInSourceAの立ち上がりおよび立ち下がりエッジ、ならびにLineTrgInSourceBの立ち上がりおよび立ち下がりエッジに対してトリガーパルスが生成されます。

ABサポート有効時の関連パラメーター:

  • EncoderABLead(正転方向の定義を切り替える機能)

パラメータ EncoderABMode を Signal_A_Only に設定すると、シャフトエンコーダをリセットできます。

EncoderABLead
タイプ dynamic/static read/write parameter
Default Signal_AB
範囲 {Signal_AB, Signal_BA}

A foreward movement is defined by a rising edge of signal A before signal B if the parameter is set to Signal_AB, or vice versa:

Signal_AB: B の前の A によって正転が定義されます

Signal_BA: A の前の B によって正転が定義されます

LineTrgInPolarity
タイプ 動的読み取り/書き込みパラメータ
Default LowActive
範囲 {LowActive, HighActive}

このパラメータは、外部入力トリガー信号 LineTrgInSourceA および LineTrgInSourceB の極性を定義します。LowActive に設定した場合、Exsync ジェネレータは ImgTrgInSource パラメータで指定された信号の立ち下がりエッジで開始します。それ以外の場合、Exsync 生成は立ち上がりエッジで開始します。これは、Trigger Mode が Extern_Trigger に設定されている場合にのみ関連します。

LineTrgDownscaler
タイプ dynamic/static read/write parameter
Default 1
範囲 [1, 256]

このパラメータは、Exsync の生成に必要な外部入力トリガー信号の数を指定します。これは、Trigger Mode が外部トリガーモードに設定されている場合にのみ関連します。

LineTrgPhase
タイプ dynamic/static read/write parameter
Default 1
範囲 [1, 256]

このパラメータは、フレームの最初の Exsync を生成するために必要な外部入力トリガー信号の数を指定します。これは、Trigger Mode が Extern_Trigger_Gated_by_Img に設定されている場合にのみ関連します。

ExsyncPeriod
タイプ dynamic/static read/write parameter
Default 100 μs
範囲 [1.024, 4000] μs

このパラメータは、Exsync 信号の周期を指定します。したがって、グラバー制御モードを使用して接続されたカメラをトリガーする場合のライン周波数を定義します。

ExsyncExposure
タイプ dynamic/static read/write parameter
Default 20 μs
範囲 [1.024, 2000] μs。ExsyncPeriod を超えてはなりません

このパラメータは、多くのカメラで Exposure Time を指定するために使用できる Exsync 信号のパルス幅を指定します。したがって、取り込み中であっても、ソフトウェアを介して Exposure Time を調整することが可能です。

Exsync2Delay
タイプ dynamic/static read/write parameter
Default 0 μs
範囲 [0, 2000] μs。ExsyncPeriod を超えてはなりません

このパラメータは、外部トリガー入力に対する、生成された Exsync 信号の遅延を指定します。したがって、Exsync2 信号は Exsync の遅延クローンです(極性、周期などは Exsync と同じです)。

ExsyncPolarity
タイプ dynamic/static read/write parameter
Default LowActive
範囲 {LowActive, HighActive}

このパラメータは、接続されたカメラで受け入れられる極性に Exsync 信号ジェネレータの極性を調整します。カメラが立ち下がりエッジでシャッターを開く場合は LowActive を使用し、それ以外の場合は HighActive を使用します。

ImgTriggerMode
タイプ dynamic/static read/write parameter
Default FreeRun
範囲 {FreeRun, ExternSw_Trigger, ExternSw_Gate}

このパラメータは、内部 Image Gate の動作モードを選択します。

画像トリガー入力信号は、外部(周辺)デバイス(シャフトエンコーダなど)またはソフトウェアによって作成される場合があります。 外部画像トリガー入力のソースは、パラメータ ImgTrgInSource を介して選択できます(下記参照)。

ImgTriggerMode パラメータの値によって、次の動作が引き起こされます。

  • FreeRun:

    • カメラによって伝送されるすべての受信ラインが受け入れられます。

    • Image Gate は無視されます。

    • パラメータ YLength は、フレーム終了(EOF)がいつ生成されるかを定義します。

    • パラメータ yOffset がゼロより大きい場合、 2つの連続する画像間の yOffset ライン数が省略されます。

      例: yOffset = 0, YLength = 2:

      例: yOffset = 2, YLength = 2:

  • ExternSw_Trigger:

    • 受け入れられた画像トリガー入力信号の立ち上がりエッジで、 新しいフレームが開始され、着信ラインが YLength まで画像に追加されます。

    • パラメータ YLength は、フレーム終了(EOF)がいつ生成されるかを定義します。

    • 画像トリガーの新しい立ち上がりエッジは、YLength ラインが追加されて EOF が生成された後にのみ受け入れられます。 YLength ラインが画像に追加されて EOF が生成される前に発生した画像トリガーの新しい立ち上がりエッジは無視されます。

      例: YLength が値 2 に設定されている場合:

  • ExternSw_Gate:

    • ゲートモードでは、画像トリガー入力信号が Image Gate 信号として機能するため、その信号がどれくらいの間アクティブであるかが重要になります。

    • このモードの正確な動作は、パラメータ MaxGatedHeight で定義できます。 (MaxGatedHeightを使用すると、画像の最大画像高さを制限するか無制限にするかを定義できます。 詳細については、パラメータ MaxGatedHeight の説明を参照してください。)

      パラメータ MaxGatedHeight が「Unrestricted」に設定されている場合のExternSW_Gateモードの動作

      • イメージゲート信号がアクティブな間、入力されたラインは画像に追加されます。

      • イメージゲートは、どの画像ラインが有効かを制御します。

        • Image Gate信号がアクティブな間、受信したラインが受け入れられます。(図を参照してください。例:ラインn+8およびn+9。)

        • Image Gate信号がアクティブでない間、受信したラインは無視されます。(図を参照してください。例:ラインn+3。)

        • Image Gate信号がアクティブな間に開始される各ラインは有効です。 (図を参照:n+1、n+2、n+4、n+5、n+6、n+8、n+9は有効です。)

          最後のラインのすべてのデータが取り込まれる前にImage Gateの立ち下がりエッジが発生した場合でも、 そのラインは有効とみなされ、完全に取得されます。(図を参照:n+2およびn+6)

        • 転送されるラインは常に完全なラインです。

        • Image Gateがローの間に開始される各ラインは無効です。 (図を参照:ラインnおよびn+7は無効、ラインn+4は有効です。)

        • ライン終了(EoL)およびフレーム終了(EoF)は、新しいラインの開始直前、 またはImage Gateの立ち下がりエッジで生成されます。

          新しいラインの開始直前のEoL:ラインの立ち下がりエッジがオープンなImage Gate内で発生し、 かつImage Gateが次のラインの開始をカバーしている場合、 EoLは次のラインの立ち上がりエッジの直前に生成されます。(図を参照:n+1、n+4、n+5、n+8。)

          新しいラインの開始直前のEoLとEoFの同時生成:ラインの立ち下がりエッジよりも前にImage Gateの立ち下がりエッジが発生した場合、 EoLとEoFは次のラインの立ち上がりエッジの直前に生成されます。(図を参照:画像mおよび画像m+1。)

          Image Gateの立ち下がりエッジでのEoLとEoFの同時生成:ラインの立ち下がりエッジがオープンなImage Gate内で発生し、 かつ次のラインの立ち上がりエッジよりも前にImage Gateの立ち下がりエッジが発生した場合、 EoLとEoFはImage Gateの立ち下がりエッジの直後に生成されます。(図を参照:画像m+2。)

      パラメータ MaxGatedHeight が「Restricted」に設定されている場合のMode ExternSW_Gateの動作

      パラメータ MaxGatedHeight が「restricted」に設定されている場合、動作は上記で説明した MaxGatedHeight の値が「unrestricted」の場合と同じですが、 以下の点を除きます:

      • Image Gateが開いている間、最大画像高さ YLength に達するまでラインが追加されます。 Image Gate信号の次の立ち上がりエッジまで、後続のすべてのラインは省略されます。

      • YLength分のラインが追加される前にImage Gate信号の立ち下がりエッジが発生した場合: Image Gate信号の立ち下がりエッジが画像の高さを定義します。 たとえ画像がYLengthの高さに達していなくても同様です。 (画像の高さの詳細については、パラメータ MaxGatedHeight を参照してください。)

      • 以下の例(図)は、MaxGatedHeight = restricted および YLength = 3 の場合の動作を示しています。

ImgTrgInSource
タイプ dynamic/static read/write parameter
Default InSignal0
範囲 {InSignal0, InSignal1, InSignal2, InSignal3, InSignal4, InSignal5, InSignal6, InSignal7}

このパラメータは、画像取得のトリガーに使用される信号ソースを指定します。これは、ImgTriggerModeがExternSw_TriggerまたはExternSw_Gateに設定されている場合にのみ関連します。

ImgTrgInPolarity
タイプ 動的読み取り/書き込みパラメータ
Default LowActive
範囲 {LowActive, HighActive}

このパラメータは、外部入力トリガー信号の極性を定義します。

ImgTrgDelay
タイプ 動的読み取り/書き込みパラメータ
Default 0
範囲 {0, 4095}

このパラメータは、指定された画像ライン数だけ画像トリガー信号を遅延させます。

FlashEnable
タイプ 動的読み取り/書き込みパラメータ
Default OFF
範囲 {OFF, ON}

フラッシュ出力を有効または無効にします。 フラッシュ信号のパルス幅は1ライン周期に等しくなります。

FlashPolarity
タイプ dynamic/static read/write parameter
Default LowActive
範囲 {LowActive, HighActive}

The parameter defines the polarity for the generated Flash signal.

FlashDelay
タイプ dynamic/static read/write parameter
Default 0
範囲 {0, 4095}

このパラメータは、外部トリガー入力に対する生成されたフラッシュ信号の遅延ライン数を指定します。 これにより、外部トリガーにフラッシュを同期させることが可能です。

フラッシュ信号のパルス幅は、1ライン周期に等しくなります。

SoftwareTrgPulse
タイプ dynamic/static write parameter
Default
範囲 {1}

このパラメータを1に設定すると、ソフトウェアトリガーが生成されます。これは、Trigger Modeが外部トリガーモードに設定されており、ImgTrgInSourceがSoftwareTriggerに設定されている場合にのみ関連します。

SoftwareTrgInput
タイプ dynamic/static write parameter
Default
範囲 {0, 1}

このパラメータを使用すると、イメージトリガーモード ExternSw_Gate用のソフトウェアゲートを生成できます。

ImgTrgIsBusy
タイプ 動的/静的読み取りパラメータ
Default 0
範囲 {0, 1}

ImgTrgIsBusyパラメータを使用すると、イメージトリガーのビジー状態をソフトウェアで読み出すことができます。 ビジー状態の場合、このパラメータは1に設定され、画像キャプチャが進行中であることを示します。 0に設定されている場合、オペレーターはビジー状態ではありません。

CC1output
タイプ dynamic/static write parameter
Default Exsync
範囲 {Exsync, ExsyncInvert, Hdsync, HdsyncInvert, Flash, FlashInvert, Gnd, Vcc}

このパラメータは、CameraLink ケーブルの CC1 ラインで使用可能なシグナルを指定します。

CC2output
タイプ dynamic/static write parameter
Default Exsync
範囲 {Exsync, ExsyncInvert, Hdsync, HdsyncInvert, Flash, FlashInvert, Gnd, Vcc}

このパラメータは、CameraLink ケーブルの CC2 ラインで使用可能なシグナルを指定します。

CC3output
タイプ dynamic/static write parameter
Default Exsync
範囲 {Exsync, ExsyncInvert, Hdsync, HdsyncInvert, Flash, FlashInvert, Gnd, Vcc}

このパラメータは、CameraLink ケーブルの CC3 ラインで使用可能なシグナルを指定します。

CC4output
タイプ dynamic/static write parameter
Default Exsync
範囲 {Exsync, ExsyncInvert, Hdsync, HdsyncInvert, Flash, FlashInvert, Gnd, Vcc}

このパラメータは、CameraLink ケーブルの CC4 ラインで使用可能なシグナルを指定します。

ImgTrgDebouncingMaxTime
タイプ static write parameter
Default 65.520 us
範囲 [0.016, 1000000] us

このパラメータは、ImgTrgDebouncingMaxTimeパラメータの最大時間を指定します。最大時間が短いほど、デバウンス用Timerを実装するために必要なFPGAリソースが少なくなります。

ImgTrgDebouncingTime
タイプ dynamic/static write parameter
Default 0.112 us
範囲 [0.016, ImgTrgDebouncingMaxTime] us

このパラメータは、入力イメージトリガー信号がそのように検出されるために同じ値を維持する必要があるデバウンス時間を指定します。デバウンス時間内の急速な信号変化はフィルタリングされて除外されます。

LineTrgDebouncingMaxTime
タイプ static write parameter
Default 65.520 us
範囲 [0.016, 1000000] us

このパラメータは、LineTrgDebouncingTimeパラメータの最大時間を指定します。最大時間が短いほど、デバウンス用Timerを実装するために必要なFPGAリソースが少なくなります。

LineTrgDebouncingTime
タイプ dynamic/static write parameter
Default 0.112 us
範囲 [0.016, ImgTrgDebouncingMaxTime] us

このパラメータは、入力ラインスキャン用トリガー信号がそのように検出されるために同じ値を維持する必要があるデバウンス時間を指定します。デバウンス時間内の急速な信号変化はフィルタリングされて除外されます。

使用例

オペレーター TrgPortLineの使用法を次の例に示します: