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.
For information about how to use data chunks and counters, see the GigE Line Scan Use Case Descriptions and Diagrams topic.

使用可能な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の値を取得します。これにより、取得された画像の数がカウントされます。

Encoder Value Chunk#

If this chunk is available and enabled, the camera appends the value of the encoder position counter for the first exposed line of a frame to every image.
For information about how to control and monitor an encoder, see the Encoder Control topic.

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を使用して、パラメーターを簡単に設定することもできます。