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パラメーターに、新しい値に置き換えるピクセル値を設定します。
2. LUTValueパラメーターを新しいピクセル値に設定します。
3. 置き換えるすべてのピクセル値について、手順1と2を繰り返します。
4. LUTEnableパラメーターをtrueに設定します。

Baslerは、プログラミングループ（for-loopなど）を使用して値を反復処理することを推奨しています。以下のサンプルコードを参照してください。

Number of LUT Entries#

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

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

512入力のLUT#

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

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

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

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

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

これは、上記のセクションで説明した制限が適用されないことを意味します。LUTIndexパラメーターは1単位で設定でき、補間は実行されません。

Replacing All LUT Entries#

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

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

1. LUTValueAllパラメーターを目的の値に設定します。
   4バイトワード（LUT値）の正しいエンディアンネスを適用するようにしてください。
2. LUTEnableパラメーターをtrueに設定します。

パラメーターの構造は、カメラの最大画素ビット深度によって異なります。

12-bit Camera Models#

最大画素ビット深度が12ビットのカメラでは、LUTValueAllパラメーターは4096 x 4バイトで構成される配列です。4バイトの各ワードは、LUTValueパラメーター値を表します。

LUTValueパラメーター値は、LUTIndex番号で昇順（0～4095）にソートされます。

10-bit Camera Models#

最大画素ビット深度が10ビットのカメラでは、LUTValueAllパラメーターは1024 x 4バイトで構成される配列です。4バイトの各ワードは、LUTValueパラメーター値を表します。

LUTValueパラメーター値は、LUTIndex番号で昇順（0～1023）にソートされます。

追加パラメーター#

LUTSelectorパラメーターを使用すると、ルックアップテーブルを選択できます。

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