Data Chunks#

相机的 Data Chunks 功能使您可以生成补充图像数据，并将该数据附加到所采集的所有图像上。

该功能的使用#

运作原理#

数据块使您可以为各个采集到的图像添加补充信息。系统会生成所需的补充信息，并将其作为数据块附加到图像数据中。

图像数据也被视为“块”。这种“图像数据块”不能禁用，并且始终是相机传输的第一个块。如果启用了一个或多个数据块，则其他块将作为第 2 个、第 3 个块进行传输。

下图显示了一组带有前导图像数据块和附加数据块的块。该示例假定启用了 CRC 校验和块功能。

数据块传输到计算机后，必须检索这些数据块才能获得其信息。具体步骤视相机型号和应用所采用的编程语言而定。如需详细了解如何检索数据块，请参阅“pylonAPI 文档”。

其他元数据#

除了数据块之外，相机还向各图像添加其他元数据，例如图像高度、图像宽度、图像 ROI 偏移和所用像素格式。可以通过 pylon API 访问采集结果数据来检索此信息。

启用和检索 Data Chunks#

1. 设置 ChunkModeActive parameter to true.
2. 设置 块选择器 参数设置为要启用的块的类型（如果可用）：
   • AutoBrightnessStatus
   • CounterValue
   • ExposureTime
   • FocusIndicator
   • Framecounter
   • FrameID
   • Gain
   • LineStatusAll
   • PayloadCRC16
   • SequenceSetIndex 或 SequencerSetActive
   • Timestamp
   • Triggerinputcounter
3. Enable the selected chunk by setting the ChunkEnable parameter to true.
4. 对每个所需块重复步骤 2 和 3。
5. 在您的应用中实现块检索。
   如需了解如何实现块检索，请参阅 pylon API 文档。

可用数据块#

自动亮度状态块#

如果此块可用并已启用，则相机会将目标亮度调整的状态附加到每个图像。

只要启用了自动功能 Exposure Auto 和/或 Gain Auto，就会执行目标亮度调整。

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

  • Disabled: Target brightness adjustments are disabled, i.e., Gain Auto and Exposure Auto are set to 熄灭.
  • TargetNotReached: Target brightness adjustments are enabled, but the target brightness value has not been reached.
  • TargetReached: Target brightness adjustments are enabled, and the target brightness value has been reached.

• 在其他相机上，使用以下值表示状态：

  • 0: Equals the Disabled status, see above.
  • 1: Equals the TargetNotReached status, see above.
  • 2: Equals the TargetReached status, see above.

计数器值块#

如果此块可用并已启用，则相机会将其计数器的当前值附加到每张图像。

• 在 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 或 Counter2.
• 在其他相机上，相机始终会检索 Counter 1 的当前值，用于对获取的图像数量进行计数。

曝光时间块#

如果启用了此块，则相机会将用于图像采集的曝光时间附加到每个图像。

The data chunk includes the ExposureTime 和 ChunkExposureTimeSelector parameter values.

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

合焦指示块#

如果此块可用并已启用，则相机会附加一个值，指示所采集的所有图像的合焦水平。

取值范围是 0.0 至 4095.0。较高的值表示较高的合焦水平。计算基于 5x5 清晰度检测算法。

合焦指示块的典型用例是在镜头对焦时监视块值的变化。例如，如果连续增加后的值开始减小，则可能表明已达到良好的合焦水平。

场景中的变化（例如，亮度增加）将影响块值。因此，在监视块值时，请确保目标场景没有变化。

合焦指示 ROI#

默认情况下，相机使用几乎全部 Image ROI 来计算合焦水平。

您可以更改此设置，并最多可指定用于计算合焦水平的传感器阵列的两个部分。这样做类似于设置 Auto Function ROI。有两个合焦指示 ROI。

要配置合焦指示 ROI：

1. 设置 BslFocusIndicatorROISelector parameter to the desired focus indicator ROI, e.g., ROI1.
2. 设置 BslFocusIndicatorROIEnable parameter to true to enable the focus indicator ROI selected.
   By default, ROI 1 is enabled and ROI 2 is disabled.
3. 输入以下参数的值以指定 所选合焦指示 ROI 的 位置：
   • AutoFunctionROIOffsetX (see note below)
   • AutoFunctionROIOffsetY
4. 输入以下参数的值以指定 图像 ROI 的 位置：
   • AutoFunctionROIWidth
   • AutoFunctionROIHeight

帧计数器块#

如果此块可用并已启用，则相机会将采集到的图像数量附加到每个图像。

为此，相机将获取 Counter 2 计数器的当前值。在带有帧 Counter 块的相机上，Counter 2 会对采集到的图像进行计数。

要手动重置计数器，请重置 Counter 2。

帧 ID 块#

如果此块可用并已启用，则相机会附加帧 ID 以显示曝光的图像数量。

帧 ID 从 0 开始，对于每张曝光的图像则递增 1，直到关闭相机电源为止。最大值为 2^48。

Gain Chunk (= GainAll Chunk)#

如果此块可用并已启用，则相机会将用于图像采集的增益附加到每个图像。

The data chunk includes the Gain parameter value.

全部线路状态块#

如果启用了此块，则相机会在触发图像采集时将所有 I/O 线路的状态附加到每个图像。

The data chunk includes the LineStatusAll parameter value.

有效负载 CRC 16 块#

如果启用了此块，则相机会将 CRC（循环冗余校验）校验和附加到每个图像。

校验和是使用 X-modem 方法计算的，并且包括图像数据和所有附加块（如果有），CRC 块本身除外。

CRC 校验和块始终是附加到图像数据的最后一个块。

定序器集激活块（= 序列集索引块）#

如果此块可用并已启用，则相机会将用于图像采集的定序器集附加到每个图像。

The data chunk includes the SequencerSetActive 或 SequenceSetIndex parameter value (depending on your camera model).

时间戳块#

如果启用了此块，则相机会将某个事件的内部时间戳（以滴答声为单位）附加到每张图像。

• 在 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: The BslChunkTimestampValue parameter indicates when acquisition of the current image started.
  • ExposureStart: The BslChunkTimestampValue parameter indicates when exposure of the current image started. On rolling shutter cameras, the parameter indicates when exposure of the first row started.
  • ExposureEnd: The BslChunkTimestampValue parameter indicates when exposure of the current image ended. On rolling shutter cameras, this parameter serves no function and is preset to 0.

• 在 other cameras, the parameter including the timestamp is named ChunkTimestamp. It always indicates when acquisition of the current image started.

触发输入计数器块#

如果此块可用并已启用，则相机会将接收到的硬件帧开始触发信号数附加到每个图像。

为此，相机将获取 Counter 1 计数器的当前值。在带有触发输入 Counter 块的相机上，Counter 1 会对接收到的硬件触发信号进行计数。

详情#

显示所有相机型号

示例代码#

// 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 轻松设置参数。