LUT#

LUTカメラ機能を使用すると、画像のピクセル値をユーザーが定義した値に置き換えることができます。

これは、ユーザー定義のルックアップテーブル（LUT）を作成することによって実施されます。

機能を使用する#

仕組み#

LUTは、「ルックアップテーブル」の略であり、基本的には数字のインデックス付きリストです。Baslerカメラの場合は、ユーザー定義の「明るさルックアップテーブル」を作成して、画像内のピクセル値（明るさまたはグレー値）を置き換えることができます。

ルックアップテーブルでは、個々のピクセル値の置換値を定義できます。例えば、グレー値4095（= 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.

Replacing Individual LUT Entries#

ルックアップテーブル内の個々のエントリを置き換えるには、次の手順に従います。

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-loopなど）を使用して値を反復処理することを推奨しています。以下のサンプルコードを参照してください。

Number of LUT Entries#

LUTで使用可能なエントリ数は、カメラモデルによって異なります。

LUTエントリの数によっては、可能なすべてのピクセル値の置換値を格納できるとは限りません。

512入力のLUT#

ほとんどのBaslerカメラでは、ユーザー定義LUTに最大512個のエントリを格納できます。このサイズは、1024個または4096個の置換値を保存するのに十分ではありません。

したがって、次の制限が適用されます。

• 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ビットであるとします。また、グレー値24をグレー値20に、グレー値32を値30に変換するLUTを作成したとします。この場合、カメラは次のように24～32のピクセル値を決定します。

1 024または4 096入力のLUT#

一部のBaslerカメラでは、ユーザー定義LUTにすべての置換値のエントリを格納できます。カメラの最大画素ビット深度に応じて、1024または4096エントリを使用できます。

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.

Replacing All LUT Entries#

ルックアップテーブル内のすべてのエントリを1つの操作で置き換えることができます。多くの場合、これはLUT内の個々のエントリを繰り返し変更するよりも高速です。

ルックアップテーブルのすべてのエントリを置き換えるには、次の手順に従います。

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-bit Camera Models#

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-bit Camera Models#

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カメラで使用できるユーザー定義のルックアップテーブルは1つしかないため、現在、このパラメーターは機能しません。

特性#

すべてのカメラモデルを表示します

サンプルコード#

// ** 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を使用して、パラメーターを簡単に設定することもできます。