Data Chunks#

Data Chunksカメラ機能を使用すると、補助的な画像データを生成し、取得する各画像にそのデータを追加できます。

機能を使用する#

仕組み#

データチャンクを使用すると、個々の画像取得に補足情報を追加できます。必要な補足情報が生成され、データチャンクとして画像データに追加されます。

画像データも「チャンク」と見なされます。この「画像データチャンク」は無効にできず、常にカメラによって送信される最初のチャンクとなります。1つ以上のデータチャンクが有効になっている場合、これらのチャンクはチャンク2、3などとして送信されます。

下の図は、先頭の画像データチャンクと、それに追加されたデータチャンクのセットを示しています。この例では、CRC Checksum Chunk機能が有効になっていることを前提としています。

データチャンクがコンピューターに送信されたら、データチャンクを検索して、情報を取得する必要があります。正確な手順は、お使いのカメラモデルとアプリケーションで使用するプログラミング言語によって異なります。データチャンク検索の詳細については、「pylon APIドキュメント」を参照してください。

追加メタデータ#

データチャンクの他に、カメラは、画像の高さ、画像の幅、画像ROIのオフセット、使用されているピクセルフォーマットなど、個々の画像に追加のメタデータを追加します。この情報は、pylon APIを介してグラブ結果データにアクセスすることで取得できます。

Data Chunksの有効化と取得#

1. パラメーターを ChunkModeActive パラメータを true.
2. パラメーターを ChunkSelector 有効にしたいタイプのチャンクのパラメーター（（使用している場合）に設定します：
   • AutoBrightnessStatus
   • CounterValue
   • ExposureTime
   • FocusIndicator
   • Framecounter
   • FrameID
   • Gain
   • LineStatusAll
   • PayloadCRC16
   • SequenceSetIndex または SequencerSetActive
   • Timestamp
   • Triggerinputcounter
3. を設定して、選択したチャンクを有効にします。 ChunkEnable パラメータを true.
4. 目的のチャンクごとに手順2と3を繰り返します。
5. お使いのアプリケーションにチャンク取得を実装します。
   チャンク取得の実装については、「pylon APIドキュメント」を参照してください。

ラインスキャンGigEカメラでのData Chunksの使用#

Data ChunksおよびCounter機能をトリガー設定と組み合わせて使用することで、どのラインがどのフレームに属し、どのフレームが正しいテスト対象物に属しているかを指定できます。トリガー、カウンター、およびデータチャンクの設定を組み合わせることで、記録されたフレームと対応するチャンクデータの間の整合性を持たせることができます。
データチャンクとカウンターの使用方法については、GigE Line Scan Use Case Descriptions and Diagramsのトピックを参照してください。

使用可能なData Chunks#

Auto Brightness Status Chunk#

このチャンクが使用可能で有効になっている場合、カメラは目標の明るさ調整のステータスを各画像に追加します。

目標の明るさ調整は、Exposure AutoまたはGain Autoオートファンクション、あるいはその両方が有効になっている場合に実行されます。

• On ace 2、boost、およびdart M/Rカメラでは、 BslChunkAutoBrightnessStatus パラメータを使用できます。これは、次の列挙型を使用して自動明るさのステータスを示します。

  • Disabled: 目標輝度の調整が無効になっています。つまり、Gain AutoとExposure Autoが次のように設定されています。 Off.
  • TargetNotReached: 目標輝度の調整は有効になっていますが、目標輝度値に達していません。
  • TargetReached: 目標輝度の調整が有効になっており、目標輝度値に達しています。

• 他のカメラでは、ステータスは次の値を使用して示されます。

  • 0: と等しい Disabled ステータス（上記を参照）。
  • 1: と等しい TargetNotReached ステータス（上記を参照）。
  • 2: と等しい TargetReached ステータス（上記を参照）。

Counter Value Chunk#

このチャンクが使用可能で有効になっている場合、カメラはすべての画像にカメラのカウンターの現在の値を追加します。

• On ace 2、boost、およびdart M/Rカメラでは、 ChunkCounterSelector パラメータを使用できます。これにより、データを取得するカウンターを選択できます。これを行うには、パラメータを次のように設定します。 Counter1 または Counter2.
• 他のカメラでは、カメラは常に現在のCounter1の値を取得します。これにより、取得された画像の数がカウントされます。

CRC Checksum Chunk#

このチャンクが有効になっている場合、カメラはすべての画像にCRC-16（巡回冗長検査）チェックサムを追加します。

チェックサムは、初期値0x0000の多項式 x¹⁶ + x¹² + x⁵ + 1 を使用して計算されます。同じアルゴリズムがXMODEMファイル転送プロトコルで使用されます。チェックサムには、画像データと、存在する場合は追加されたすべてのチャンクが含まれます（CRCチャンク自体を除く）。

CRCチェックサムチャンクは、常に画像データに追加された最後のチャンクです。

Encoder Value Chunk#

このチャンクが利用可能で有効な場合、カメラはフレームの最初の露光ラインのエンコーダー位置カウンターの値をすべての画像に追加します。
エンコーダーの制御および監視方法については、Encoder Controlのトピックを参照してください。

Exposure Time Chunk#

このチャンクが有効な場合、カメラは画像取得に使用された露光時間を各画像に追加します。

データチャンクには、 ExposureTime および ChunkExposureTimeSelector パラメータ値が含まれます。

イメージ ChunkExposureTimeSelector パラメータは、露光時間チャンクに含める露光時間を選択します。

Focus Indicator Chunk#

このチャンクが使用可能で有効になっている場合、カメラは、取得されたすべての画像のフォーカスレベルを示す値を追加します。

値の範囲は0.0～4095.0です。値が大きいほど、焦点のレベルが高いことを示します。計算は5×5のシャープネス検出アルゴリズムに基づいています。

フォーカスインジケーターチャンクの一般的な使用例としては、レンズのフォーカス中にチャンク値の変化を監視することが挙げられます。たとえば、連続的に増加した後の値が減少し始めた場合、これは適切なレベルのフォーカスに達したことを示している可能性があります。

シーンの変化（明るさの増加など）はチャンク値に影響します。したがって、チャンク値を監視しながら、ターゲットシーンが変更されないようにしてください。

フォーカスインジケーターROI#

デフォルトでは、カメラはほぼフル画像ROIを使用して焦点のレベルを計算します。

これを変更して、フォーカスのレベルの計算に使用するセンサーアレイの部分を最大2つまで指定できます。これは、Auto Function ROIの設定に似ています。2つのフォーカスインジケーターROIを使用できます。

フォーカスインジケーターROIを設定するには：

1. パラメーターを BslFocusIndicatorROISelector パラメータを目的のフォーカスインジケーターROIに設定します（例： ROI1.
2. パラメーターを BslFocusIndicatorROIEnable パラメータを true 選択したフォーカスインジケーターROIを有効にするため）。
   デフォルトでは、ROI 1が有効で、ROI 2が無効になっています。
3. 以下のパラメーターの値を入力し、 位置 選択したフォーカスインジケーターROIのうち、
   • AutoFunctionROIOffsetX （下の注記を参照）
   • AutoFunctionROIOffsetY
4. 以下のパラメーターの値を入力し、 サイズ 選択したフォーカスインジケーターROIのうち、
   • AutoFunctionROIWidth
   • AutoFunctionROIHeight

Frame Counter Chunk#

このチャンクが使用可能で有効になっている場合、カメラは取得された画像の数を各画像に追加します。

これを行うために、カメラはCounter2カウンターの現在の値を取得します。Frame Counterチャンクを持つカメラで、Counter 2は、取得された画像の数をカウントします。

カウンターを手動でリセットするには、Counter2をリセットします。

フレームIDチャンク#

このチャンクが使用可能で有効になっている場合、カメラは、露出された画像の番号を示すフレームIDを追加します。

フレームIDは0から始まり、カメラの電源がオフになるまで、公開された各画像に対して1ずつ増加し続けます。最大値は2^48です。

Gain Chunk (= GainAll Chunk)#

このチャンクが使用可能で有効な場合、カメラは、画像取得に使用されるゲインを各画像に追加します。

データチャンクには、 Gain パラメータ値を指定します。

Line Status All Chunk#

このチャンクが有効になっている場合、カメラは画像取得がトリガーされた瞬間にすべてのI/Oラインステータスを各画像に追加します。

データチャンクには、 LineStatusAll パラメータ値を指定します。

Sequencer Set Active Chunk (= Sequence Set Index Chunk)#

このチャンクが使用可能で有効な場合、カメラは、画像取得に使用されるシーケンサーセットを各画像に追加します。

データチャンクには、 SequencerSetActive または SequenceSetIndex パラメータ値（以下に応じて、 お使いのカメラモデルを使用します。

Timestamp Chunk#

このチャンクが有効になっている場合、カメラは特定のイベントの内部タイムスタンプ（ティック単位）をすべての画像に追加します。

• On ace 2、boost、およびdart M/RカメラTimestampを含むパラメータの名前は次のようになります BslChunkTimestampValue.
  また、 BslChunkTimestampSelector パラメータを使用すると、Timestampが参照するイベントの種類を選択できます：

  • FrameStart: The BslChunkTimestampValue パラメータは、現在の画像の取り込みが開始された時刻を示します。
  • ExposureStart: The BslChunkTimestampValue パラメータは、現在の画像の露光が開始された時刻を示します。 ローリングシャッター カメラの場合、このパラメータは最初の行の露光が開始された時刻を示します。
  • ExposureEnd: The BslChunkTimestampValue パラメータは、現在の画像の露光が終了した時刻を示します。 ローリングシャッター カメラの場合、このパラメータは機能せず、0に事前設定されています。

• On その他のカメラTimestampを含むパラメータの名前は次のようになります ChunkTimestamp。これは常に現在の画像の取り込みが開始された時刻を示します。

Trigger Input Counter Chunk#

このチャンクが使用可能で有効な場合、カメラは、受信したハードウェアフレーム開始トリガー信号の数を各画像に追加します。

これを行うために、カメラは、Counter1カウンターの現在の値を取得します。Trigger Input Counterチャンクを持つカメラで、Counter1は、受信したハードウェアトリガー信号の数をカウントします。

特性#

すべてのカメラモデルを表示します

サンプルコード#

// Enable data chunks
camera.ChunkModeActive.SetValue(true);
// Select a chunk, e.g., the Exposure Time chunk
camera.ChunkSelector.SetValue(ChunkSelector_ExposureTime);
// Enable the selected chunk
camera.ChunkEnable.SetValue(true);
// Now, you must implement chunk retrieval in your application.
// For C++, C, and .NET sample implementations, see the "Grab_ChunkImage" and
// "Chunks" code samples in the pylon API Documentation

INodeMap& nodemap = camera.GetNodeMap();
// Enable data chunks
CBooleanParameter(nodemap, "ChunkModeActive").SetValue(true);
// Select a chunk, e.g., the Exposure Time chunk
CEnumParameter(nodemap, "ChunkSelector").SetValue("ExposureTime");
// Enable the selected chunk
CBooleanParameter(nodemap, "ChunkEnable").SetValue(true);
// Now, you must implement chunk retrieval in your application.
// For C++, C, and .NET sample implementations, see the "Grab_ChunkImage" and
// "Chunks" code samples in the pylon API Documentation

// Enable data chunks
camera.Parameters[PLCamera.ChunkModeActive].SetValue(true);
// Select a chunk, e.g., the Exposure Time chunk
camera.Parameters[PLCamera.ChunkSelector].SetValue(PLCamera.ChunkSelector.ExposureTime);
// Enable the selected chunk
camera.Parameters[PLCamera.ChunkEnable].SetValue(true);
// Now, you must implement chunk retrieval in your application.
// For C++, C, and .NET sample implementations, see the "Grab_ChunkImage" and
// "Chunks" code samples in the pylon API Documentation

/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
/* Enable data chunks */
errRes = PylonDeviceSetBooleanFeature(hdev, "ChunkModeActive", 1);
CHECK(errRes);
/* Select a chunk, e.g., the Exposure Time chunk */
errRes = PylonDeviceFeatureFromString(hdev, "ChunkSelector", "ExposureTime");
CHECK(errRes);
/* Enable the selected chunk */
errRes = PylonDeviceSetBooleanFeature(hdev, "ChunkEnable", 1);
CHECK(errRes);
/* Now, you must implement chunk retrieval in your application. */
/* For C++, C, and .NET sample implementations, see the "Grab_ChunkImage" and */
/* "Chunks" code samples in the pylon API Documentation */

# Enable data chunks
camera.ChunkModeActive.Value = True
# Select a chunk, e.g., the Exposure Time chunk
camera.ChunkSelector.Value = "ExposureTime"
# Enable the selected chunk
camera.ChunkEnable.Value = True
# Now, you must implement chunk retrieval in your application.
# For C++, C, and .NET sample implementations, see the "Grab_ChunkImage" and
# "Chunks" code samples in the pylon API Documentation

pylon Viewerを使用して、パラメーターを簡単に設定することもできます。