Data Chunks#

「Data Chunks 」相機功能可讓您產生補充影像資料，並將該資料附加至您所拍攝的每一張影像上。

使用功能#

運作原理#

資料塊可讓您為個別影像擷取新增補充資訊。所需的補充資訊會被產生，並作為資料塊附加至影像資料中。

影像資料也被視為一個「資料塊」。這個「影像資料塊」無法停用，且總是相機傳輸的第一个資料塊。若啟用了一個或多個資料塊，這些資料塊將分別作為第 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 文件。

在線掃描 GigE 攝影機上使用Data Chunks #

Data Chunks 以及 Counter 功能，結合觸發器設定，可用於指定哪些資料行屬於某個幀，以及哪些幀屬於正確的測試對象。透過觸發器、計數器與資料區塊設定的組合，可使記錄的幀與對應的資料區塊之間建立一致性。
有關如何使用資料區塊與計數器的資訊，請參閱「GigE 線掃描用例說明與圖解」主題。

有貨Data Chunks#

自動亮度狀態區塊#

如果此區塊可用且已啟用，相機便會將目標亮度調整的狀態附加至每張照片中。

每當 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 狀態，請參閱上文。

Counter 值區塊#

如果此區塊可用且已啟用，相機便會將相機計數器的當前值附加至每張影像中。

• 開啟 ace 2、boost 以及 dart M/R 攝影機， ChunkCounterSelector 此參數已提供。它可讓您選擇要從哪個計數器擷取資料。要執行此操作，請將該參數設定為 Counter1 或 Counter2.
• 在其他相機上，相機會始終讀取 `Counter 1` 的當前值，該變數用於統計已擷取的影像數量。

CRC 校驗和區塊#

若啟用此區塊，相機將在每張影像後附加一個 CRC-16（循環冗餘檢查）校驗和。

校驗和是透過多項式^x16+^x12+^x5+ 1 並以初始值 0x0000 計算得出的。XMODEM 檔案傳輸協定亦採用相同的演算法。校驗和涵蓋影像資料以及所有附加的區塊（如有），但不包括 CRC 區塊本身。

CRC 校驗和區塊總是作為最後一個區塊附加在映像資料之後。

編碼器值區塊#

如果此區塊可用且已啟用，相機會將幀中第一條曝光行的編碼器位置計數器值附加到每張影像上。
有關如何控制和監控編碼器的資訊，請參閱 Encoder Control 主題。

Exposure Time 塊#

若啟用此區塊，相機將在每張影像後附加用於擷取該影像的曝光時間。

該資料區塊包含 ExposureTime 及 ChunkExposureTimeSelector 參數值。

當 ChunkExposureTimeSelector 此參數用於選取要納入曝光時間區塊中的曝光時間。

焦點指示器區塊#

如果此區塊可用且已啟用，相機會在每張擷取的影像中附加一個值，用以指示對焦等級。

該數值範圍為 0.0 至 4095.0。數值越高，表示對焦程度越高。計算是基於 5×5 銳度偵測演算法。

對焦指示器區塊的一個典型應用情境，是在鏡頭對焦過程中監控該區塊數值的變化。例如，如果數值在持續增加後開始下降，這可能表示已達到適當的對焦程度。

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

對焦指示器 ROI#

預設情況下，相機會使用幾乎整個影像 ROI來計算對焦程度。

您可以變更此設定，並指定最多兩個應用于計算對焦程度的感測器陣列區域。此操作與設定自動功能 ROI 的方式類似。共有兩個對焦指示器 ROI 可用。

要設定對焦指示器 ROI：

1. 將相機中的 BslFocusIndicatorROISelector 將參數設定為所需的焦點指標 ROI，例如： ROI1.
2. 將相機中的 BslFocusIndicatorROIEnable 參數設為 true 以啟用所選的對焦指示器 ROI。
   預設情況下，ROI 1 處於啟用狀態，而 ROI 2 則處於停用狀態。
3. 請輸入以下參數的數值，以指定 職位 所選對焦指示器 ROI 的：
   • AutoFunctionROIOffsetX （參見下文註釋）
   • AutoFunctionROIOffsetY
4. 請輸入以下參數的數值，以指定 大小 所選對焦指示器 ROI 的：
   • AutoFunctionROIWidth
   • AutoFunctionROIHeight

FrameCounter Chunk#

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

為此，攝影機會讀取「Counter 」2 計數器的當前值。在具備「Frame」Counter 區塊的攝影機上，「Counter 」2 用來統計已擷取的影像數量。

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

幀 ID 區塊#

如果此區塊可用且已啟用，相機便會追加一個幀識別碼，用以標示已曝光影像的編號。

幀 ID 從 0 開始，並隨著每張曝光影像增加 1，直至相機關機為止。最大值為 2^48。

增益區塊（＝GainAll 區塊）#

如果此區塊可用且已啟用，相機將會將用於影像擷取的增益值套用至每張影像。

該資料區塊包含 Gain 參數值。

Line Status 所有區塊#

若啟用此區塊，相機將在每張影像中附加影像擷取觸發當下所有 I/O 線路的状态。

該資料區塊包含 LineStatusAll 參數值。

Sequencer 設定有效區塊（即「序列集索引區塊」）#

如果此區塊可用且已啟用，相機會將用於影像擷取的序列器設定附加至每張影像。

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

Timestamp 塊#

若啟用此區段，相機將在每張影像中附加特定事件的內部時間戳記（以 tick 為單位）。

• 開啟 ace 2、boost 以及 dart M/R 攝影機，包含時間戳記的參數名為 BslChunkTimestampValue.
  此外，該 BslChunkTimestampSelector 提供了一個參數，可讓您選擇時間戳應對應的事件類型：

  • FrameStart: BslChunkTimestampValue 此參數表示當前影像的擷取何時開始。
  • ExposureStart: BslChunkTimestampValue 此參數表示當前影像的曝光何時開始。在 捲簾門 在相機方面，此參數表示第一行開始曝光的時間。
  • ExposureEnd: BslChunkTimestampValue 此參數表示當前影像的曝光何時結束。在 捲簾門 在相機方面，此參數沒有任何作用，且預設值為 0。

• 開啟 其他相機，包含時間戳記的參數名為 ChunkTimestamp. 它總是標示當前影像的擷取何時開始。

觸發輸入「Counter 」模組#

如果此區塊可用且已啟用，相機會將接收到的硬體幀起始觸發訊號數量附加至每張影像中。

為此，攝影機會讀取「Counter 1」計數器的當前值。在配備「Trigger InputCounter 」模組的攝影機上，「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

您也可以 use the pylon Viewer 來輕鬆設定參數。