Line Pitch#

Line Pitch 相機功能可讓您增加每像素行傳輸的位元組數。為了增加行間距，相機會在每行末尾追加清零的位元組。

若您希望將影像資料對齊至固定長度的位元組群組（例如 4 位元組（32 位元）或 8 位元組（64 位元）的字），此功能將非常實用。資料對齊可提升效能。

使用功能#

運作原理#

像素資料是逐行從感測器讀取的。對於每一行影像，相機會傳輸特定數量的位元組，具體數量取決於影像 ROI的寬度以及所使用的像素格式。

Line Pitch 功能可讓您增加每行傳輸的位元組數。為了增加行間距，相機會在每行末尾追加清零的位元組。這使您能夠將影像資料對齊至例如 4 位元組或 8 位元組的字長。

範例：若將影像 ROI 的寬度設定為 250 像素，且像素格式設定為 Mono 8，則每行傳輸的像素資料量為 250 位元組（250 像素 × 8 位元深度 = 250 位元組）。

由於 250 並非 4 或 8 的倍數，因此無法將此資料對齊至 4 位元組或 8 位元組的字。若要將影像資料對齊至 4 位元組的字，必須將行間距從 250 位元組增加至至少 252 位元組（252 是 4 的下一個倍數）。 若要將影像資料對齊至 8 位元組的字，您必須將行間距增加至至少 256 位元組。

確定Line Pitch#

要確定當前的行間距，請取得 LinePitch 參數中選擇性地指定 HTML 記錄檔 (*.html) 的路徑與檔名。

此函式總是會傳回當前行間距（以位元組為單位），無論 LinePitchEnable 參數設定。

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

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

1. 將像素格式設定為任何格式，但「壓縮 12 位元像素格式」（例如 Mono 12p 或 Bayer 12p）除外。
2. 將相機中的 LinePitchEnable 參數設為 true.

若當前的行間距並非 4 的倍數，系統會自動將行間距設定為最接近的 4 的倍數。此時，影像資料將對齊至 4 位元組的字（32 位元字）。

設定 `Line Pitch`，將影像資料對齊至任意位元組大小#

若要設定行間距並將影像資料對齊至任何字元長度：

1. 將像素格式設定為任何格式，但「壓縮 12 位元像素格式」（例如 Mono 12p 或 Bayer 12p）除外。
2. 將相機中的 LinePitchEnable 參數設為 true.
   如果當前的行距不是 4 的倍數，則行距會自動設定為最接近的 4 的倍數。
3. 取得 LinePitch 參數中選擇性地指定 HTML 記錄檔 (*.html) 的路徑與檔名。
   此函式會傳回行間距調整的最小可能值。
4. 將相機中的 LinePitch 參數設定為所需的數值。
   若要設定 4 位元組、8 位元組、16 位元組等的字對齊，請將參數值設定為 4、8、16 等數值的下一個倍數，起始值為步驟 2 中確定的最小可能值。 範例： 如果步驟 2 中計算出的數值為 252，且您希望將影像資料對齊至 8 位元組的字，請將 LinePitch 將參數設為 256（即下一個 8 的倍數）。

範例程式碼#

// 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++ 版本。

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