Operator CXPQuadCamera

Operator Library: Hardware Platform

このオペレーターは、CXPクアッドチャネルカメラとVisualAppletsの間の画像データインターフェースを表します。

ハードウェアプラットフォームで使用可能
mE5 marathon VCX-QP
mE5 ironman VQ8-CXP6D
mE5 ironman VQ8-CXP6B

オペレーターは出力Oに画像データを提供します。この出力は常に存在します。

この標準出力ポートに加えて、オプションの入力および出力のセットを設定できます。

オペレーターのインスタンス化時に、次のポップアップダイアログが表示されます。

ここでは、CXPケーブルを介した汎用入出力用のオプションポートや、カメラとの間のオプショントリガーポートを指定できます。

特定のGPI(General Purpose Inputs)、特定のGPO(General Purpose Outputs)、トリガー入力ポート、およびトリガー出力ポートの有効性を定義できます。

ポートの可用性を「0」(デフォルト)に設定した場合、 ポートはオペレーター内に存在しません。 ポートの可用性を1に設定した場合、特定のポートがオペレーターインターフェースで利用可能になります。

オペレーターは CameraPort 型のリソースを4つ使用します。

[重要] 画像幅(Image Width)と画像高(Image Height)の変更

カメラ固有の設定に合わせて幅と高さを変更できます。ただし、オペレーターポートOの最大画像幅は、ポートOの Parallelism で割り切れる必要があります。

最大画像幅がポートOの Parallelism で割り切れることを確認してください。

[重要] Parallelism の値

ポートOの Parallelism は、少なくとも最小値(パラメータ MinimalParallelism に記載されている値)に設定する必要があります。これより低い Parallelism の値は許可されません。最小 Parallelism は、このオペレーターの他のパラメータに定義した値に基づいて VisualApplets によって計算されます。これにより、受信データを常に正しく受け取ることができます。

[重要] ダミーピクセル

出力データにはダミーピクセルが含まれる場合があります。これは、オペレーターが Parallelism の変換を2回行う可能性があるために発生します。まず、オペレーターは内部で、自身が計算しパラメータ MinimalParallelism 内で読み取り専用値として提供する最小 Parallelism に変換します。これにより、Parallelism 変換により追加された可能性のあるダミー値を含め、MinimalParallelism で割り切れる内部画像幅になります。次に、最初の Parallelism 変換の結果得られたパディング済み画像幅が O.Parallelism の倍数でない場合、オペレーターは Parallelism を O.Parallelism に変換し、さらにダミー値を追加する可能性があります。したがって、出力データにダミーピクセルが含まれるかどうかは、MinimalParallelism パラメータ、画像幅、および O.Parallelism によって異なります。Parallelism の変換ごとにダミーピクセルが追加される可能性があります。追加されたダミーピクセルには未定義のデータ値が含まれており、実際の画像幅から逸脱した画像幅になります。

例:MinimalParallelism が20、O.Parallelism が32、転送される画像幅が128ピクセルの場合、MinimalParallelism パラメータで定義された20という内部 Parallelism により、オペレーターは内部的に幅140の画像ラインを作成します。出力の場合、データベクターは Parallelism 32(O.Parallelism)に変換され、その結果、画像ライン幅は160ピクセルになります。

ダミーピクセルがあるため、期待される出力画像幅は次のようになります。

[重要] Bit Width とフォーマットタイプ

ポートO(画像ポート)の Bit Width は、選択したフォーマットタイプ(パラメータ FormatType)によって異なります。

  • FormatType = Gray の場合:Bit Width は任意の値を取ることができます(VAF_Gray および FL_NONE)。
  • FormatType = RGB の場合:Bit Width は3の倍数です(VAF_Color および FL_RGB)。
  • FormatType = RGBA の場合:Bit Width は4の倍数です(VAF_Gray および FL_NONE)。
  • FormatType = RAW の場合:Bit Width は32です(VAF_Gray および FL_NONE)。

I/O Property

Property 値
オペレータータイプ M
入力リンク - TriggerI(オプション)、CXPチャンネルを介してフレームグラバーからカメラに送信されるトリガー。このポートは、ラインスキャンカメラのトリガーによく使用されます。
- GPIx(オプション)、CXPチャンネルを介してフレームグラバーからカメラに送信される汎用入力 [x]。GPI0、GPI1、GPI2、GPI3、GPI4、GPI5、GPI6、およびGPI7を利用できます。
Output Links - O、画像データ出力
- TriggerO(オプション)、CXPチャンネルを介してカメラからフレームグラバーに送信されるトリガー。
- GPOx(オプション)、CXPチャンネルを介してカメラからフレームグラバーに送信される汎用出力 [x]。GPO0、GPO1、GPO2、GPO3、GPO4、GPO5、GPO6、およびGPO7を利用できます。

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

Link Parameter 出力リンク - O 入力リンク - TriggerI(オプション) 出力リンク - TriggerO(オプション) 入力リンク - GPIx(オプション) 出力リンク - GPOx(オプション)
Bit Width any 1 1 1 1
Arithmetic unsigned unsigned unsigned unsigned unsigned
Parallelism any1 1 1 1 1
Kernel Columns 1 1 1 1 1
Kernel Rows 1 1 1 1 1
Img Protocol {VALT_IMAGE2D, VALT_LINE1D} (default: VALT_IMAGE2D) VALT_SIGNAL VALT_SIGNAL VALT_SIGNAL VALT_SIGNAL
Color Format {VAF_GRAY, VAF_COLOR}

VAF_GRAY = FL_NONE

VAF_COLOR = FL_RGB

(Color FormatがVAF_GRAYの場合、Color FlavorはFL_NONEになります。 Color FormatがVAF_COLORの場合、Color FlavorはFL_RGBになります。)

VAF_GRAY VAF_GRAY VAF_GRAY VAF_GRAY
Color Flavor {FL_NONE, FL_RGB}

VAF_GRAY = FL_NONE

VAF_COLOR = FL_RGB

(Color FormatがVAF_GRAYの場合、Color FlavorはFL_NONEになります。 Color FormatがVAF_COLORの場合、Color FlavorはFL_RGBになります。)

FL_NONE FL_NONE FL_NONE FL_NONE
Max. Img Width 任意(デフォルト: 1024) 1 1 1 1
Max. Img Height 任意(デフォルト: 1024) 1 1 1 1

1

パラメータMinimalParallelismで指定されている最小値以上に設定する必要があります。

MinimalParallelismとO.Paralleismが異なる場合、Parallelismは2回変換され、その都度ダミー値が追加される可能性があります。 これらのダミーピクセルにより、期待される出力画像幅は次のようになります。

パラメーター

CameraID
タイプ static write parameter
Default
範囲 {-1, 0, 1, 2, 3}

CameraIDパラメータは、カメラオペレータのファームウェアへのCXPマスターポートIDを定義し、自動CXPトポロジ検出(カメラからアプレット、およびアプレットからカメラ)を可能にします。

このパラメータを使用すると、オペレータ内でIDを直接指定できます。 ただし、Resourcesダイアログでオペレータのリソースを指定することをお勧めします。 (Resourcesダイアログを開くには、カメラオペレータを選択した状態で、DesignメニューからResourcesメニュー項目を選択します。) CameraIDパラメータは、リソースダイアログのパラメータを使用して、正しいマスターポートに自動的に更新されます。 次の例では、1台のシングルカメラと1台デュアルカメラを使用しています。

module3(シングルカメラ)のCameraID(CXPマスターポートID)は2です。 module5(デュアルカメラ)のCameraID(CXPマスターポートID)は1です。

デュアルカメラには2つのCXPカメラポートが必要です(クアッドカメラには4つのポートが必要です)。 マスターポートのみがオペレータのCameraIDパラメータに反映されます。

可能な数(最大4つ)を超えるCameraPortリソースを定義した場合(例:5つの「CXPSingleCamera」オペレータをインスタンス化した場合)、 最後にCameraPortリソースを要求したカメラオペレータ(利用可能な4つのポートがすでにすべて占有されている状態)は、 そのCameraIDを-1に設定します。 この場合、デザインルールチェックでエラーが報告されます。

ParameterのCameraIDは範囲{-1, 0, 1, 2, 3}です。

MinimalParallelism
タイプ 静的読み取りパラメータ
Default 20
範囲 [1 : 512]

データの損失なしにカメラの最大帯域幅を転送できる、出力リンクOの最小Parallelismを提供する読み取り専用パラメータです。最小Parallelismは自動的に計算されます。

値は、パラメータFormatModeで選択したピクセルフォーマットによって異なります。

パラメータFormatModeをdynamicパラメータとして定義した場合(以下のパラメータFormatModeの説明を参照)、発生する可能性のある最小のMinimalParallelismが計算されます。

最小Parallelismにより、ダミーピクセルが作成される場合があります。これは、オペレータがParallelismを2回変換し、その過程でダミー値を追加する可能性があるためです。これらのダミーピクセルのため、期待される出力画像幅は次のようになります。

Status
タイプ 動的リードパラメータ
Default
範囲 {0; 2^7-1}

Statusパラメータは、カメラオペレーターの現在のステータスを反映するための実行時読み取り専用パラメータです。 Bit[0]はCXPストリームパケット損失の検出を示します。 Bit[1]はCXPストリームパケットのシングルバイトエラー訂正を示します。 Bit[2]はCXPストリームパケットのマルチバイトエラー検出を示します。 Bit[3..6]は予約されています。 このパラメータは将来のバージョンで変更される可能性があります。

FormatType
タイプ 静的書き込みパラメータ
Default GRAY
範囲 GRAY, RGB, RGBA, RAW

ここでは、受信するPixel Formatの種類(CXP仕様で定義されているもの)を選択できます。 ここで選択した値によって、パラメータFormatModeで選択できるPixel Formatが決まります。 したがって、このパラメータの設定はパラメータFormatModeに直接影響します。 以下のパラメータFormatModeのドキュメントも参照してください。

FormatMode
タイプ 静的または動的(ユーザー定義)書き込みパラメータ
Default Mono8
範囲 {Mono8, Mono10, Mono12, Mono14, Mono16, BayerGR8, BayerGR10, BayerGR12, BayerGR14, BayerGR16, BayerRG8, BayerRG10, BayerRG12, BayerRG14, BayerRG16, BayerGB8, BayerGB10, BayerGB12, BayerGB14, BayerGB16, BayerBG8, BayerBG10, BayerBG12, BayerBG14, BayerBG16, RGB8, RGB10, RGB12, RGB14, RGB16, RGBA8, RGBA10, RGBA12, RGBA14, RGBA16, Raw}

このパラメータでは、パラメータFormatTypeで選択したフォーマットタイプに属するすべてのPixel Format(CXP仕様で定義されているもの)が提供されます。

ここで選択できるPixel Formatは、パラメータFormatTypeの設定によって異なります。 したがって、利用できるのは常に全値範囲の一部のプリセットのみとなります。

別のPixel Formatセットを取得するには、パラメータFormatTypeの設定を変更します。 上記のパラメータFormatTypeのドキュメントも参照してください。

具体的には、パラメータFormatTypeの以下の設定により、パラメータFormatModeで以下のPixel Formatが提供されます:

FormatType == GRAY: {Mono8, Mono10, Mono12, Mono14, Mono16, BayerGR8, BayerGR10, BayerGR12, BayerGR14, BayerGR16, BayerRG8, BayerRG10, BayerRG12, BayerRG14, BayerRG16, BayerGB8, BayerGB10, BayerGB12, BayerGB14, BayerGB16, BayerBG8, BayerBG10, BayerBG12, BayerBG14, BayerBG16}

FormatType == RGB: {RGB8, RGB10, RGB12, RGB14, RGB16}

FormatType == RGBA: {RGBA8, RGBA10, RGBA12, RGBA14, RGBA16}

FormatType == RAW: {Raw} Pixel format Raw has a fix bit width of 32Bit. The data are interpreted as received.

このパラメータを動的パラメータとして使用するか、静的パラメータとして使用するかを決定できます。「Parameter Type」列で選択します:

TxTriggerPacketMode
タイプ 動的書き込みパラメータ
Default CxpStandard
範囲 {CxpStandard, RisingEdgeOnly}

パラメータTxTriggerPacketModeを使用すると、フレームグラバーとカメラを接続するCXPケーブルの帯域幅を増やすことができます。 帯域幅の増加は、カメラトリガー信号の解釈をわずかに変更することで達成されます。

この機能は、この機能をサポートする特定のカメラでのみ使用できます。 詳細については、最寄りの代理店またはBaslerサポート部門にお問い合わせください。

パラメータTxTriggerPacketModeでは、2つの値(CxpStandard、RisingEdgeOnly)を使用できます:

  • CxpStandard: 推奨される設定はCxpStandardです。 CxpStandardに設定した場合、カメラトリガーはCXP仕様に従って動作します。 (CXP仕様では、カメラを1回トリガーするために、フレームグラバーがCXPケーブルを介して2つのパケットをカメラに送信するように規定されています。)

  • RisingEdgeOnly: RisingEdgeOnlyに設定した場合、カメラを1回トリガーするために、フレームグラバーは1つのパケットのみをカメラに送信します。 その結果、帯域幅が広がり、ラインレートが向上します。

TxTriggerEventCount
タイプ 動的リードパラメータ
Default 0
範囲 {0;2^20-1}

TxTriggerEventCountパラメータは、カメラに送信されたトリガーエッジイベントの数を示します。

TxTriggerAcknowledgementCount
タイプ 動的リードパラメータ
Default 0
範囲 {0;2^20-1}

TxTriggerAcknowledgementCountパラメータは、(以前に送信されたトリガーエッジパケットに対する応答として)カメラから送信されたトリガー確認応答パケットがフレームグラバーによっていくつ受信されたかを示します。

TxTriggerWaveformViolation
タイプ 動的リードパラメータ
Default 0
範囲 {0,1}

トリガーエッジ間の距離が最小エッジ周波数に違反しているとカメラオペレーターがTriggerIポート上で検知した場合、このパラメータはカメラオペレーターによって1に設定されます。 最小エッジ周波数は、すべてのmicroEnable 5プラットフォームにおいて550 ns(ナノ秒)です。 このパラメータは、読み取られるまでその値を保持します。 読み取られた後、パラメータは値を更新します。 周波数制御は常時実行されており、パラメータの読み取りステータスによる影響を受けません。

使用例

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