LUT#

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

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

機能を使用する#

仕組み#

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

ルックアップテーブルでは、個々のピクセル値の置換値を定義できます。例えば、グレー値4095（= 12ビットピクセルフォーマットの最大グレー値）をグレー値0（= 最小グレー値）に置き換えることができます。これにより、画像内のすべての完全に白い画素が、完全に黒い画素に変わります。

ユーザー定義のLUTを設定することは、例えば画像の輝度を最適化する場合などに便利です。置き換え値をあらかじめ定義してカメラに保存しておけば、アプリケーションによる時間のかかる計算を回避できます。その代わりに、カメラはピクセルの初期値に基づいてLUTから目的の新しい値を単純にルックアップすることができます。

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 bit、パラメータには 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エントリを使用できます。

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

Replacing All LUT Entries#

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

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

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