Data Chunks#

透過 Data Chunks camera feature，您可以產生補充的影像資料，並將該資料附加到您所擷取的每個影像中。

使用此功能#

運作原理#

Data chunks 允許您將補充資訊新增至個別的影像擷取中。所需的補充資訊會作為 data chunks 產生並附加到影像資料中。

影像資料也被視為一個「chunk」。此「image data chunk」無法停用，且永遠是相機傳輸的第一個 chunk。如果啟用了一或多個 data chunks，這些 chunks 將會作為 chunk 2、3 等進行傳輸。

下圖顯示了一組 chunks，其中包含領先的 image data chunk 以及附加的 data chunks。此範例假設已啟用 CRC Checksum Chunk 功能。

將 data chunks 傳輸至電腦後，必須將其擷取以取得其資訊。確切的程序取決於您的相機型號以及應用程式所使用的程式語言。如需有關擷取 data chunks 的詳細資訊，請參閱 pylon API Documentation。

額外詮釋資料#

除了 data chunks 之外，相機還會在個別影像中新增其他後設資料 (metadata)，例如影像高度、影像寬度、Image ROI 偏移量以及所使用的 Pixel Format。存取 pylon API 中的擷取結果資料即可擷取此資訊。

啟用與擷取 Data Chunks#

1. 將 ChunkModeActive 參數設為 true.
2. 將 ChunkSelector 參數設為您想要啟用的 chunk 類型 (（如果可用)：
   • AutoBrightnessStatus
   • CounterValue
   • ExposureTime
   • FocusIndicator
   • Framecounter
   • FrameID
   • Gain
   • LineStatusAll
   • PayloadCRC16
   • SequenceSetIndex 或 SequencerSetActive
   • Timestamp
   • Triggerinputcounter
3. 透過將 ChunkEnable 參數設為 true.
4. 針對每個所需的 chunk 重複步驟 2 和 3。
5. 在您的應用程式中實作 chunk 擷取。
   如需有關實作 chunk 擷取的資訊，請參閱 pylon API Documentation。

針對線幅掃描 GigE 相機使用 Data Chunks#

結合使用 Data Chunks 與 Counter 功能以及觸發設定，可以用來指定哪些行屬於某個影格，以及哪些影格屬於正確的測試物件。觸發、counter 與 data chunks 設定的結合，使得建立所錄製影格與對應 chunk 資料之間的一致性成為可能。
如需有關如何使用 data chunks 和 counters 的資訊，請參閱 GigE Line Scan Use Case Descriptions and Diagrams 主題。

可用 Data Chunks#

Auto Brightness Status Chunk#

如果此 chunk available 且已啟用，相機會將target brightness adjustments 的狀態附加到每個影像。

只要啟用 Exposure Auto 或 Gain Auto 自動功能 (或兩者皆啟用)，就會執行 target brightness adjustments。

Counter Value Chunk#

如果此區塊可用且已啟用，相機將會在每個影像附加相機當前的 Counter 值。

• 在 ace 2、boost 與 dart M/R 相機上， ChunkCounterSelector 參數可用。它允許您選擇要從哪個 Counter 擷取資料。若要這麼做，請將參數設定為 Counter1 或 Counter2.
• 在其他相機上，相機一律會擷取 Counter 1 的當前值，該 Counter 會計算已擷取的影像數量。

CRC Checksum Chunk#

如果此區塊已啟用，相機將會在每個影像附加 CRC-16（循環冗餘檢查）檢查碼。

檢查碼是使用多項式 x¹⁶ + x¹² + x⁵ + 1 與初始值 0x0000 計算得出。XMODEM 檔案傳輸協定也使用相同的演算法。檢查碼包含影像資料以及所有附加的區塊（如果有），但 CRC 區塊本身除外。

CRC 檢查碼區塊一律附加在影像資料的最後一個區塊。

Encoder Value Chunk#

如果此區塊可用且已啟用，相機將會在每個影像附加影格中第一個曝光行的編碼器位置 Counter 值。
關於如何控制與監控編碼器的資訊，請參閱 Encoder Control 主題。

Exposure Time Chunk#

如果此區塊已啟用，相機將會在每個影像附加用於影像擷取的 Exposure Time。

資料區塊包含 ExposureTime 會設為 ChunkExposureTimeSelector parameter values，來決定最後擷取之影像的 payload 大小與壓縮比。

影像 ChunkExposureTimeSelector 參數可選擇要包含在 Exposure Time 區塊中的 Exposure Time。

Focus Indicator Chunk#

如果此區塊可用且已啟用，相機將會在每個擷取的影像中附加一個表示對焦水準的數值。

數值範圍可從 0.0 到 4095.0。數值越高表示對焦水準越高。計算基礎為 5×5 銳利度偵測演算法。

對焦指示器區塊的典型使用情境是在調整鏡頭對焦時監控區塊數值的變化。例如，如果數值在持續增加後開始下降，這可能表示已達到良好的對焦水準。

場景的變化（例如亮度增加）會影響區塊數值。因此，在監控區塊數值時，請確保目標場景沒有改變。

Focus Indicator ROIs#

根據預設，相機使用幾乎完整的 Image ROI 來計算對焦水準。

您可以變更此設定，並指定最多兩個應用於計算對焦水準的感光元件陣列部分。這樣做類似於設定 Auto Function ROI。提供兩個 Focus Indicator ROI。

若要設定 Focus Indicator ROIs：

1. 將 BslFocusIndicatorROISelector 參數設為所需的 Focus Indicator ROI，例如 ROI1.
2. 將 BslFocusIndicatorROIEnable 參數設為 true 以啟用所選的 Focus Indicator ROI。
   根據預設，ROI 1 已啟用，ROI 2 已停用。
3. 請輸入以下參數的值以指定 位置 所選對焦指示器 ROI 的：
   • AutoFunctionROIOffsetX (請參閱下文備註)
   • AutoFunctionROIOffsetY
4. 請輸入以下參數的值以指定 大小 所選對焦指示器 ROI 的：
   • AutoFunctionROIWidth
   • AutoFunctionROIHeight

Frame Counter Chunk#

如果此 chunk 可用且已啟用，相機會將擷取的影像數量附加至每張影像。

為此，相機會擷取 Counter 2 counter 的目前值。在具備 Frame Counter chunk 的相機上，Counter 2 會計算已擷取的影像數量。

若要手動重設計數器，請重設 Counter 2。

Frame ID Chunk#

如果此 chunk 可用且已啟用，相機會附加指示已曝光影像編號的 frame ID。

frame ID 從 0 開始，並且每個曝光的影像都會遞增 1，直到相機關閉電源為止。最大值為 2^48。

Gain Chunk (= GainAll Chunk)#

如果此 chunk 可用且已啟用，相機會將用於影像擷取的增益附加至每張影像。

資料區塊包含 Gain 參數值。

Line Status All Chunk#

如果啟用此 chunk，相機會在觸發影像擷取的瞬間，將所有 I/O 線路的狀態附加至每張影像。

資料區塊包含 LineStatusAll 參數值。

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

如果此 chunk 可用且已啟用，相機會將用於影像擷取的 Sequencer set 附加至每張影像。

資料區塊包含 SequencerSetActive 或 SequenceSetIndex 參數值（取決於 您的相機型號)。

Timestamp Chunk#

若啟用此 chunk，相機將會在每個影像附加特定事件的內部 Timestamp（以 tick 為單位）。

• 在 ace 2、boost 與 dart M/R 相機，包含 Timestamp 的參數命名為 BslChunkTimestampValue.
  此外， BslChunkTimestampSelector 參數可用於選擇 Timestamp 所參照的事件類型：

  • FrameStart之後： BslChunkTimestampValue 參數表示目前影像擷取何時開始。
  • ExposureStart之後： BslChunkTimestampValue 參數表示目前影像的 Exposure Time 何時開始。在 rolling shutter 相機上，該參數表示第一行曝光何時開始。
  • ExposureEnd之後： BslChunkTimestampValue 參數表示目前影像的 Exposure Time 何時結束。在 rolling shutter 相機上，此參數沒有作用且預設為 0。

• 在 其他相機，包含 Timestamp 的參數命名為 ChunkTimestamp。它一律表示目前影像擷取何時開始。

Trigger Input Counter Chunk#

若此 chunk 可用且已啟用，相機將會在每個影像附加接收到的硬體 Frame Start 觸發訊號數量。

為此，相機將擷取 Counter 1 counter 的目前值。在具備 Trigger Input Counter chunk 的相機上，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 來輕鬆設定參數。