Data Chunks#

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

機能を使用する#

仕組み#

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

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

次の図は、先頭の画像データチャンクと追加されたデータチャンクを含む一連のチャンクを示しています。この例では、CRCチェックサムチャンク機能が有効になっていると想定しています。

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

Using Data Chunks for Line Scan GigE Cameras#

The Data Chunks and Counter features, in combination with the trigger settings, can be used to specify which lines belong to a frame and which frames belong to the correct test object. The combination of trigger, counter, and data chunks settings makes it possible to create a coherence between the frames recorded and the corresponding chunk data.

使用可能なData Chunks#

Auto Brightness Status Chunk#

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

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

• On ace 2, boost, and dart M/R cameras, the BslChunkAutoBrightnessStatus parameter is available. It indicates the auto brightness status using the following enumeration:

  • Disabled：ターゲットの輝度調整が無効になります（例：Gain AutoとExposure AutoがOffに設定される）。
  • TargetNotReached：ターゲットの輝度調整は有効ですが、目標の輝度値に達していません。
  • TargetReached：ターゲットの輝度調整が有効になり、目標の輝度値に達しました。

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

  • 0：Disabledステータスに等しい。上記参照。
  • 1：TargetNotReachedステータスに等しい。上記参照。
  • 2：TargetReachedステータスに等しい。上記参照。

Counter Value Chunk#

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

• On ace 2, boost, and dart M/R cameras, the ChunkCounterSelector parameter is available. It allows you to choose which counter to retrieve data from. To do so, set the parameter to Counter1 or Counter2.
• 他のカメラでは、カメラは常に現在のCounter1の値を取得します。これにより、取得された画像の数がカウントされます。

Exposure Time Chunk#

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

The data chunk includes the ExposureTime and the ChunkExposureTimeSelector parameter values.

The ChunkExposureTimeSelector parameter selects the exposure time to be included in the exposure time chunk.

Focus Indicator Chunk#

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

The value can range from 0.0 to 4095.0. A higher value indicates a higher level of focus. Calculations are based on a 5×5 sharpness detection algorithm.

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

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

フォーカスインジケーター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
   • AutoFunctionROI Height

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パラメーター値が含まれます。

Payload CRC 16 Chunk#

このチャンクが有効になっている場合、カメラはCRC（Cyclic Redundancy Check）チェックサムを各画像に追加します。

チェックサムはX-modem方式を使用して計算され、CRCチャンク自体を除く、画像データとすべての追加チャンク（存在する場合）を含みます。

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

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

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

データチャンクには、SequencerSetActiveまたはSequenceSetIndexパラメーター値が含まれます（カメラモデルによって異なります）。

Timestamp Chunk#

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

• On ace 2, boost, and dart M/R cameras, the parameter including the timestamp is named BslChunkTimestampValue.
  Also, the BslChunkTimestampSelector parameter is available, which allows you to choose the type of event that the timestamp should refer to:

  • FrameStart：BslChunkTimestampValueパラメーターは、現在の画像の取得が開始された時間を示します。
  • ExposureStart：BslChunkTimestampValueパラメーターは、現在の画像の露出がいつ開始されたかを示します。ローリングシャッターカメラでは、最初の列の露出が開始されたタイミングをこのパラメーターで示します。
  • ExposureEnd：BslChunkTimestampValueパラメーターは、現在の画像の露出がいつ終了したかを示します。ローリングシャッターカメラでは、このパラメーターは機能せず、0にプリセットされています。

• 他のカメラでは、タイムスタンプを含むパラメーターの名前は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を使用して、パラメーターを簡単に設定することもできます。