Data Chunks#

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

该功能的使用#

运作原理#

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

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

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

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

其他元数据#

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

启用和检索 Data Chunks#

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

可用数据块#

自动亮度状态块#

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

只要启用了自动功能 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： 等于已禁用状态，请参见上文。
  • 1： 等于 TargetNotReached 状态，请参见上文。
  • 2： 等于 TargetReached 状态，请参见上文。

计数器值块#

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

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

曝光时间块#

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

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.

合焦指示块#

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

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

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

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

合焦指示 ROI#

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

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

要配置合焦指示 ROI：

1. 将 BslFocusIndicatorROISelector 参数设置为所需的合焦指示 ROI，例如 ROI1。
2. 将 BslFocusIndicatorROIEnable 参数设置为 true 可启用选定的合焦指示 ROI。
   默认情况下，启用 ROI 1 而禁用 ROI 2。
3. 输入以下参数的值以指定 所选合焦指示 ROI 的 位置：
   • AutoFunctionROIOffsetX（请参阅下方说明）
   • AutoFunctionROIOffsetY
4. 输入以下参数的值以指定 图像 ROI 的 位置：
   • AutoFunctionROIWidth
   • AutoFunctionROIHeight

帧计数器块#

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

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

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

帧 ID 块#

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

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

Gain Chunk (= GainAll Chunk)#

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

数据块包含 Gain 参数值。

全部线路状态块#

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

数据块包含 LineStatusAll 参数值。

有效负载 CRC 16 块#

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

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

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

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

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

数据块包含 SequencerSetActive 或 SequenceSetIndex 参数值（具体取决于您的相机型号）。

时间戳块#

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

• 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。它总是指示何时开始获取当前图像。

触发输入计数器块#

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

为此，相机将获取 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 轻松设置参数。