查找表 (LUT)#

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

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

该功能的使用#

运作原理#

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

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

Setting up a user-defined LUT can be useful, e.g., if you want to optimize the luminance of your images. By defining the replacement values in advance and storing them in the camera, you avoid time-consuming calculations by your application. Instead, the camera can simply look up the desired new value in the LUT based on the pixel's initial value.

替换单个 LUT 条目#

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

1. 设置 LUTIndex parameter to the pixel value that you want to replace with a new value.
2. 设置 LUTValue parameter to the new pixel value.
3. 对要替换的所有像素值重复步骤 1 和 2。
4. 设置 LUTEnable parameter to true.

Basler 建议使用编程循环（例如 for 循环）来迭代这些值。请参阅下面的示例代码。

LUT 条目数#

LUT 中可用条目的数量因相机型号而异。

根据 LUT 条目的数量，并非总是可以存储所有可能像素值的替换值。

具有 512 个条目的 LUT#

在大多数 Basler 相机上，用户定义的 LUT 最多可以存储 512 个条目。该大小不足以存储 1,024 或 4,096 个替换值。

因此，存在以下限制：

• On cameras with a maximum pixel bit depth of 10 bit, you can only set the LUTIndex parameter to multiples of two (0, 2, 4, 6, …, 1022). This means that only pixel values of 0, 2, 4, 6, and so on, can be replaced.
• On cameras with a maximum pixel bit depth of 12 bit, you can only set the LUTIndex parameter to multiples of eight (0, 8, 16, 24, …, 4088). This means that only pixel values of 0, 8, 16, 24, and so on, can be replaced.

为了确定剩余的像素值，相机会执行直线插值。

示例：假设相机的最大像素位深度为 12 位。还要假设您已创建了一个 LUT，该 LUT 将 24 的灰度值转换为 20，并将 32 的灰度值转换为 30。在这种情况下，相机将按以下方式确定 24 到 32 之间的像素值：

具有 1024 或 4096 个条目的 LUT#

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

This means that the limitations described in the section above don't apply: You can set the LUTIndex parameter in increments of 1, and no interpolation is performed.

替换所有 LUT 条目#

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

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

1. 设置 LUTValueAll parameter to the desired value.
   Make sure to apply the correct endianness of the 4-byte words (LUT values).
2. 设置 LUTEnable parameter to true.

参数结构取决于相机的最大像素位深度。

12 位相机型号#

On cameras with a maximum pixel bit depth of 12 bit, the LUTValueAll parameter is an array that consists of 4096 x 4 bytes. Each 4-byte word represents a LUTValue parameter value.

即： LUTValue parameter values are sorted by the LUTIndex number in ascending order (0 through 4095).

10 位相机型号#

On cameras with a maximum pixel bit depth of 10 bit, the LUTValueAll parameter is an array that consists of 1024 x 4 bytes. Each 4-byte word represents a LUTValue parameter value.

即： LUTValue parameter values are sorted by the LUTIndex number in ascending order (0 through 1023).

附加参数#

即： LUTSelector parameter allows you to select a lookup table.

由于 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 轻松设置参数。