Line Pitch#

Line Pitch camera feature 允許您增加每像素行傳輸的位元組數。若要增加 line pitch，相機將會在每行附加數個值為零的位元組。

如果您想將影像資料對齊至固定大小的位元群組（例如 4 位元組 (32 位元) 或 8 位元組 (64 位元) 的字組），此功能將非常有用。資料對齊可提升效能。

使用此功能#

運作原理#

像素資料是從感光元件逐行讀取。對於每個影像行，相機都會根據 Image ROI 寬度和所使用的 Pixel Format 傳輸特定數量的位元組。

Line Pitch 功能允許您增加每行傳輸的位元組數。若要增加 line pitch，相機將會在每行附加值為零的位元組。這可讓您將影像資料對齊至（例如）4 位元組或 8 位元組的字組。

範例：如果您將 Image ROI 寬度設為 250 像素，並將 Pixel Format 設為 Mono 8，則每行傳輸的像素資料量為 250 位元組（250 像素 x 8 位元深度 = 250 位元組）。

此資料無法對齊至 4 位元組或 8 位元組的字組，因為 250 不是 4 或 8 的倍數。若要將影像資料對齊至 4 位元組的字組，您必須將 line pitch 從 250 位元組增加到至少 252 位元組（252 是 4 的下一個倍數）。若要將影像資料對齊至 8 位元組的字組，您必須將 line pitch 增加到至少 256 位元組。

資訊

如果啟用了 Data Chunks，調整 line pitch 將不會影響 chunk 資料。零只會新增至影像資料中，而不會新增至 chunk 資料中。

決定 Line Pitch#

若要決定目前的 line pitch，請取得以下項目的值： LinePitch 參數的值。

這一定會傳回以位元組為單位的目前 line pitch，而不受以下項目影響： LinePitchEnable Property 設定。

設定 Line Pitch，將影像資料對齊至 4 位元組 (Byte) 字組#

若要將影像資料對齊至 4 位元組的字組：

將 Pixel Format 設定為任何格式，但封裝 12 位元像素格式（例如 Mono 12p 或 Bayer 12p）除外。
將 LinePitchEnable 參數設為 true.

如果目前的 line pitch 不是 4 的倍數，line pitch 將自動設定為 4 的下一個倍數。此時影像資料已對齊至 4 位元組的字組 (32 位元字組)。

設定 Line Pitch，將影像資料對齊至任何字組大小#

若要設定 line pitch 並將影像資料對齊至任何字組大小：

將 Pixel Format 設定為任何格式，但封裝 12 位元像素格式（例如 Mono 12p 或 Bayer 12p）除外。
將 LinePitchEnable 參數設為 true.
如果目前的 line pitch 不是 4 的倍數，line pitch 將自動設定為 4 的下一個倍數。
取得 LinePitch 參數的值。
這會傳回 line pitch 調整的最小可能值。
將 LinePitch 參數設定為所需的值。
若要進行 4 位元組、8 位元組、16 位元組等字組對齊，請將參數值設定為從步驟 2 中決定的最小可能值開始算起的 4、8、16 等的下一個倍數。 範例： 如果在步驟 2 中決定的值為 252，且您想要將影像資料對齊至 8 位元組的字組，請將 LinePitch 參數設定為 256（= 8 的下一個倍數）。

範例程式碼#

C++ (Native)

// Enable the line pitch feature
camera.LinePitchEnable.SetValue(true);
// Get the current line pitch
int64_t i = camera.LinePitch.GetValue();
// Set the Line Pitch parameter value to the next multiple of 8
camera.LinePitch.SetValue(((i+7)/8)*8);

此範例程式碼僅提供 C++ 語言版本。

您也可以使用 pylon Viewer 來輕鬆設定參數。