LUT#

LUT 相機功能可讓您使用您所定義的值來取代影像中的像素值。

這是透過建立使用者定義的查找表 (LUT) 來完成的。

使用功能#

運作原理#

LUT 是「lookup table」（查找表）的簡稱，基本上是一個索引數字清單。對於 Basler 相機，您可以建立使用者定義的「亮度查找表」來取代影像中的像素值（即亮度或灰階值）。

在查找表中，您可以為個別像素值定義取代值。例如，您可以將 4 095 的灰階值（12 位元 Pixel Format 的最大灰階值）取代為 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 bit，您只能將 LUTIndex 參數設為二的倍數 (0, 2, 4, 6, …, 1022)。這表示只能取代 0、2、4、6 等像素值。
• 在具有最大像素位元深度的相機上 12 bit，您只能將 LUTIndex 參數設為八的倍數 (0, 8, 16, 24, …, 4088)。這表示只能取代 0、8、16、24 等像素值。

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

範例：假設相機的最大像素位元深度為 12 bit。同時假設您已建立一個 LUT，將 24 的灰階值轉換為 20 的灰階值，並將 32 的灰階值轉換為 30 的值。在這種情況下，相機會依下列方式決定 24 到 32 之間的像素值：

具有 1 024 或 4 096 個條目的 LUT#

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

這表示上述章節中所述的限制並不適用：您可以將 LUTIndex 參數以 1 為單位進行遞增，且不會執行插補。

替換所有 LUT 項目#

您可以透過單一操作取代對照表中的所有條目。在許多情況下，這比重複變更 LUT 中的個別條目更快。

若要取代對照表中的所有條目：

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

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

12 位元相機型號#

在具有以下規格的相機上 最大像素位元深度 為 12 bit 時， LUTValueAll 參數是一個由 4096 x 4 位元組組成的陣列。每個 4 位元組字組代表一個 LUTValue 參數值。

當 LUTValue 參數值會依 LUTIndex 編號以升冪排序（0 到 4095）。

10 位元相機型號#

在具有以下規格的相機上 最大像素位元深度 對於 10-bit， LUTValueAll 參數是一個包含 1024 x 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 來輕鬆設定參數。