LUT#

LUT相機功能可讓您將影像中的像素值替換為您自行定義的數值。

這是透過建立一個使用者自訂查找表（LUT）來實現的。

使用功能#

運作原理#

LUT 是「查閱表」（lookup table）的縮寫，基本上是一種帶有索引的數字清單。對於 Basler 相機，您可以建立一個自訂的「亮度查閱表」，用以替換影像中的像素值，也就是亮度或灰階值。

在查表中，您可以針對個別像素值定義替換值。例如，您可以將灰階值 4 095（即 12位元像素格式的最大灰階值）替換為灰階值 0（即最小灰階值）。此操作會將影像中所有純白像素全部轉換為純黑像素。

設定自訂 LUT 可能相當實用，例如當您想優化影像的亮度時。透過預先定義替換值並將其儲存於相機中，即可避免應用程式進行耗時的計算。取而代之的是，相機可根據像素的初始值，直接從 LUT 中查詢所需的新值。

替換個別 LUT 項目#

若要替換查表中的個別項目：

1. 將相機中的 LUTIndex 要以新值取代的像素值的參數。
2. 將相機中的 LUTValue 將該參數設定為新的像素值。
3. 針對所有您想要替換的像素值，請重複步驟 1 和 2。
4. 將相機中的 LUTEnable 參數設為 true.

Basler 建議使用程式設計迴圈（例如 for 迴圈）來遍歷這些值。請參閱以下範例程式碼。

LUT 條目數量#

LUT 中可用的條目數量因相機型號而異。

視LUT 條目數量而定，並非總能為所有可能的像素值儲存對應的替代值。

包含 512 個條目的 LUT#

在大多數Basler 相機上，使用者自訂的 LUT 最多可儲存 512 個條目。此容量不足以儲存 1 024 或 4 096 個替代值。

因此，適用以下限制：

• 在配備 最大像素位元深度 的項 10 位元, 您只能設定 LUTIndex 參數設定為 2 的倍數（0、2、4、6、……、1022）。這表示僅能替換為 0、2、4、6 等數值的像素。
• 對於最大像素位元深度為 12 位元, 您只能設定 LUTIndex 參數限定為 8 的倍數（0、8、16、24、……、4088）。這表示只有 0、8、16、24 等像素值才能被替換。

為了確定其餘像素的值，相機會執行直線插值。

範例：假設相機的最大像素位元深度為 12 位元。另假設您已建立一個 LUT，該 LUT 會將灰度值 24 轉換為 20，並將灰度值 32 轉換為 30。在此情況下，相機會依照以下方式確定 24 至 32 之間的像素值：

包含 1 024 或 4 096 個條目的 LUT#

在某些Basler 相機上，使用者自定義的 LUT 可以儲存所有替換值的條目。根據相機的最大像素位元深度，可提供 1 024 或 4 096 個條目。

這表示上節所述的限制不適用：您可以設定該 LUTIndex 參數以 1 為增量，且不進行插值。

替換所有 LUT 條目#

您可以透過單一操作，將查找表中的所有項目一併替換。在許多情況下，這比反覆修改查找表中的個別項目來得更快。

若要替換查找表中的所有條目：

1. 將相機中的 LUTValueAll 參數設定為所需的數值。
   請務必使用正確的 字節序 4 位元組的字（LUT 值）。
2. 將相機中的 LUTEnable 參數設為 true.

參數結構取決於您的相機的最大像素位元深度。

12 位元相機型號#

在配備 最大像素位元深度 為 12 位元，該 LUTValueAll 該參數是一個由 4096 × 4 位元組組成的陣列。每個 4 位元組的字代表一個 LUTValue 參數值。

當 LUTValue 參數值是根據 LUTIndex 按升序排列的數字（0 至 4095）。

10 位元相機型號#

在配備 最大像素位元深度 10 位元，該 LUTValueAll 該參數是一個由 1024 × 4 位元組組成的陣列。每個 4 位元組的字代表一個 LUTValue 參數值。

當 LUTValue 參數值是根據 LUTIndex 按升序排列的數字（0 至 1023）。

其他參數#

當 LUTSelector 此參數可讓您選取查閱表。

由於 Basler 攝影機上僅提供一個使用者自訂查閱表，因此該參數目前並無任何功能。

詳細資料#

顯示所有相機型號

範例程式碼#

// ** Replacing individual LUT entries **
// The following lookup table causes an inversion of the pixel values
// (bright -> dark, dark -> bright)
// Only applies to cameras with a maximum pixel bit depth of 12 bit
for (int i=0; i<4096; i+=8)
{
    camera.LUTIndex.SetValue(i);
    camera.LUTValue.SetValue(4095-i);
}
// Enable the LUT
camera.LUTEnable.SetValue(true);

// ** Replacing all LUT entries in a single operation **
// The following lookup table inverts the pixel values
// (bright -> dark, dark -> bright)
// Only applies to cameras with a maximum pixel bit depth of 12 bit
// Note: This is a simplified code sample.
// You should always check the camera interface and
// the endianness of your system before using LUTValueAll.
// For more information, see the 'LUTValueAll' code sample
// in the pylon API Documentation.
uint32_t lutValues[4096];
for (int i=0; i<4096; i+=8)
{
   lutValues[i] = 4095-i;
}
camera.LUTValueAll.SetValue(lutValues);
// Enable the LUT
camera.LUTEnable.SetValue(true);

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

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