Data Chunks#

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

该功能的使用#

运作原理#

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

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

下图显示了一组 Data Chunks，其中包含首部图像数据块和附加的 Data Chunks。该示例假设已启用 CRC Checksum Chunk 功能。

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

其他元数据#

除了数据块之外，相机还向各图像添加其他元数据，例如图像高度、图像宽度、图像 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 功能以及触发设置，可以指定哪些行属于一个帧，以及哪些帧属于正确的测试对象。通过组合使用触发、Counter 和 Data Chunks 设置，可以建立所录制帧与相应 chunk 数据之间的连贯性。
有关如何使用 data chunks 和 counters 的信息，请参阅 GigE Line Scan Use Case Descriptions and Diagrams 主题。

可用数据块#

自动亮度状态块#

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

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

• 在 ace 2、boost 和 dart M/R 相机， BslChunkAutoBrightnessStatus 参数可用。它使用以下枚举指示自动亮度状态：

  • Disabled：目标亮度调整已禁用，即 Gain Auto 和 Exposure Auto 设置为 Off.
  • TargetNotReached：目标亮度调整已启用，但尚未达到目标亮度值。
  • TargetReached：目标亮度调整已启用，且已达到目标亮度值。

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

  • 0: 等同于 Disabled 状态，见上文。
  • 1: 等同于 TargetNotReached 状态，见上文。
  • 2: 等同于 TargetReached 状态，见上文。

计数器值块#

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

• 在 ace 2、boost 和 dart M/R 相机， ChunkCounterSelector 参数可用。它允许您选择从中检索数据的 Counter。为此，请将该参数设置为 Counter1 或 Counter2.
• 在其他相机上，相机始终会检索 Counter 1 的当前值，用于对获取的图像数量进行计数。

CRC Checksum Chunk#

如果启用了此 chunk，相机将向每幅图像附加一个 CRC-16（循环冗余校验）校验和。

该校验和使用多项式 x¹⁶ + x¹² + x⁵ + 1 计算得出，初始值为 0x0000。XMODEM 文件传输协议也使用相同的算法。校验和包括图像数据以及所有附加的 chunks（如果有），但 CRC chunk 本身除外。

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

Encoder Value Chunk#

如果此 chunk 可用且已启用，相机将把帧的第一行曝光的编码器位置计数器值附加到每幅图像。
有关如何控制和监控编码器的信息，请参阅 Encoder Control 主题。

曝光时间块#

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

数据块包括 ExposureTime 和 ChunkExposureTimeSelector 参数值。

即： ChunkExposureTimeSelector 参数选择要包含在曝光时间 chunk 中的曝光时间。

合焦指示块#

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

该值范围为 0.0 到 4095.0。值越高，对焦级别越高。计算基于 5×5 清晰度检测算法。

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

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

合焦指示 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 参数值。

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

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

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

时间戳块#

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

• 在 ace 2、boost 和 dart M/R 相机，包含 Timestamp 的参数命名为 BslChunkTimestampValue.
  此外，还提供了 BslChunkTimestampSelector 参数，允许您选择 Timestamp 所指向的事件类型：

  • FrameStart： BslChunkTimestampValue 参数表示当前图像采集开始的时间。
  • ExposureStart： BslChunkTimestampValue 参数表示当前图像曝光开始的时间。在 滚动快门 相机上，该参数表示第一行曝光开始的时间。
  • ExposureEnd： BslChunkTimestampValue 参数表示当前图像曝光结束的时间。在 滚动快门 相机上，此参数不起作用，预设为 0。

• 在 其他相机，包含 Timestamp 的参数命名为 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 轻松设置参数。