查找表 (LUT)#

相机的 LUT 功能允许您用自己定义的值替换图像中的像素值。

这是通过创建用户定义的查找表 (LUT) 来完成的。

该功能的使用#

运作原理#

LUT 是“查找表”的简称，它基本上是数字的索引列表。对于 Basler 相机，您可以创建用户定义的“亮度查找表”以替换图像中的像素值，即亮度或灰度值。

在查找表中，您可以为单个像素值定义替换值。例如，您可以将灰度值 4 095（= 12 位像素格式的最大灰度值）替换为灰度值 0（= 最小灰度值）。这会将图像中的所有全白像素更改为全黑像素。

设置用户自定义 LUT 非常有用，例如，当您想要优化图像的亮度时。通过预先定义替换值并将其存储在相机中，您可以避免应用程序进行耗时的计算。相反，相机可以直接根据像素的初始值在 LUT 中查找所需的新值。

替换单个 LUT 条目#

要替换ace查找表中的单个条目：

1. 设置 LUTIndex 参数设置为您想要替换为新值的像素值。
2. 设置 LUTValue 参数设置为新的像素值。
3. 对要替换的所有像素值重复步骤 1 和 2。
4. 设置 LUTEnable acquisition mode 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 位。还要假设您已创建了一个 LUT，该 LUT 将 24 的灰度值转换为 20，并将 32 的灰度值转换为 30。在这种情况下，相机将按以下方式确定 24 到 32 之间的像素值：

具有 1024 或 4096 个条目的 LUT#

在一些 Basler 相机上，用户定义的 LUT 可以存储所有替换值的条目。根据相机的最大像素位深度，可以使用 1,024 或 4,096 个条目。

这意味着上述部分中描述的限制不适用：您可以将 LUTIndex 参数以 1 为增量进行设置，并且不执行插值。

替换所有 LUT 条目#

您可以通过一次操作替换ace查找表中的所有条目。在很多情况下，这比在 LUT 中反复更改各个条目更快。

要替换ace查找表中的所有条目：

1. 设置 LUTValueAll 参数设置为所需的值。
   确保应用正确的 字节序 （针对 4 字节字，即 LUT 值）。
2. 设置 LUTEnable acquisition mode 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++ 语言。

您也可以使用 pylon Viewer 轻松设置参数。