VisualApplets
オペレーターリファレンス

Operator Library: Hardware Platform

このオペレーターは、CXPカメラとVisualApplets間の画像データインターフェースを表します。このオペレーターは、シングルチャンネル、デュアルチャンネル、またはクアッドチャンネルのCXPインターフェースで使用できます。インターフェースのタイプは、ConnectionCount パラメータによって選択されます。カメラが配信するフォーマットに関係なく、オペレーターは常に未処理の画像データ（raw）を出力します。その後、この画像データをカメラから送信されたフォーマットに変換する必要があります。画像データを変換するには、未処理のバイト値をピクセル値に集約およびキャストするための適切なオペレーターを使用します。稼働中の特定の状況は、後述するようにイベントシステムを介して通知される場合があります。さらに、このオペレーターには、カメラとの接続ステータスを示すさまざまなパラメータがあります。

フレームが、CXP画像ヘッダーでカメラから通知されたサイズよりも大きいか小さいことをオペレーターが検出すすと、安全回路が作動します。その後、オペレーターは超過したピクセルとラインを切り捨てるため、VisualAppletsには常に画像ヘッダーで定義されたフレームサイズが認識されます。フレームの寸法が画像ヘッダーで指定されたものよりも小さい場合、オペレーターは受信したフレームを未定義データで埋めて、画像ヘッダーで定義された指定フレーム寸法を実現します。小さいフレームを埋めると、後続のフレームが失われる原因になることがあります。データの損失はイベントごとにソフトウェアにレポートされ、サイズの不一致もイベントを引き起こします。

VisualAppletsでのインスタンス化

オペレーターは出力 O に画像データを提供します。この出力は常時存在します。この標準出力ポートに加えて、CXPヘッダーのメタデータ用のオプションの MetaDataO 出力を設定できます。オペレーターのインスタンス化時に、次のポップアップダイアログが表示されます。

ここで、オプションのメタデータポートを指定できます。ポートの可用性を「0」（デフォルト）に設定した場合、ポートはオペレーター内に存在しません。ポートの可用性を1に設定すると、オペレーターインターフェースでメタデータポートを利用できるようになります。

オプションの MetaDataO ポート

32ビット出力のフォーマットを次の図に示します。

各CXPフレームには、対応するエラーのない画像ヘッダーが含まれています。画像ヘッダーが正しくない場合、イメージストリームデータはVisualAppletsパイプラインに供給されません。圧縮された画像ヘッダーは6ワードで構成されています。最後のバイトは追加情報用に使用され、内部使用のみを目的としています。特に、HeaderError ビットは、画像ヘッダー自体にエラーが発生したかどうかを通知します。

デバイスリソースの使用状況

オペレータは、パラメータConnectionCountの選択に応じて、 CameraPortタイプのリソースを 1 つ以上使用します。イベントシステムでは、 EventPortタイプのリソースが使用されます。ConnectionCountがX4 (クワッド チャンネル) に設定されている場合、リソース ダイアログは次のようになります。

エラーハンドリングとイベントシステム

オペレータが、受信した再構成フレームがCXPイメージヘッダーでカメラによって指定されたサイズよりも大きいか小さいかを検出すると、安全回路が作動します。オペレータは、超過したピクセルとラインを切り捨て、後続の処理パイプラインが常にイメージヘッダーで定義されたフレームサイズを認識するようにします。受信したフレームの寸法がイメージヘッダーで指定された寸法よりも小さい場合、オペレータは、イメージヘッダーで定義された指定されたフレーム寸法になるように、受信したフレームを未定義のデータで埋めます。小さいフレームを埋めると、後続のフレームが失われる可能性があります。その損失は、イベントごとにソフトウェアに報告されます（次の段落を参照）。サイズの不一致もイベントを引き起こします。

For a set of very critical errors, the operator will forward asynchronous events to the host runtime software (Framegrabber SDK). The event name in the Framegrabber API is <hierarchical operator name>\CxpStreamStatus, e.g. Device1\Process0\Camera\CxpStreamStatus. The event payload is provided as four 16-bit data words. The event format is defined as follows:

イベントには、破損したエンティティに関するイベントと、失われたエンティティに関するイベントの2種類があります。word 3 の bit 0 は、発生したイベントの種類を示します。イベントバッファがいっぱいになると、イベントが失われることがあります。破損したエンティティを示すイベントが失われた場合、word 3 の bit 1 が設定されます。失われたエンティティを示すイベントが失われた場合、word 3 の bit 2 が設定され、bit 3 から 15 にはフレームの損失を示す失われたイベントの数が提供されます。bit 2 が設定されているにもかかわらず Counter が 0 の場合は、Counter のオーバーフローが発生したことを意味します。

すべてのイベントによってソフトウェア割り込みが発生します。イベントの数を減らすため、同じフレームタグを持つ複数のイベントが統合される場合があります。その場合、一部のエラーフラグが結合されます。イベントが失われた場合、失われたイベントの前のイベントには失われたイベントに関する情報が含まれており、同じフレームタグを持つ後続のイベントと統合することはできません。

CRC エラーが原因で発生したイベントはフレームタグを報告しますが、これは CRC エラーが発生したフレームと正確には一致しない場合があります。フレームタグは、先行または後続のフレームのものである可能性があります。これは、カメラが 2 つ以上のフレーム間の移行を含む CXP パケットを送信する場合にのみ発生します。CRC の計算はパケットの終了時に終了しますが、ストリームデータはオンザフライで再構築されます。つまり、オペレータによって先行フレームがすでに送信された後に CRC エラーが検出されるという状況が発生する可能性があります。カメラパケットに進行中のフレームの終了部分と次のフレームの開始部分の両方のデータが含まれていない通常の状況では、CRC エラー時のフレームタグは常に正しくなります。完全なフレームストリームデータが最大パケットサイズの 8k 未満であるその他のすべての場合では、1 つのパケット内で 1 つのフレームがオーバーラップするだけです。その場合、ソフトウェアアプリケーションは、フレームタグ - 1 の先行フレームおよびフレームタグ + 1 の後続フレームも破損している可能性があると見なす必要があります。