コンテンツにスキップ

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.

情報

ユーザーが定義したLUTの値の範囲(0~1 024または0~4 096)は、現在選択されているピクセル形式には依存しません。これは、カメラの最大ピクセルビット深度に依存します。

お使いのカメラが12ビットピクセルフォーマットをサポートしており、現在8ビットピクセルフォーマットを使用している場合でも、0~4096のピクセル値を入力できます。カメラはこれらの値を変換に使用します。次に、変換された値の最下位4ビットをドロップし、最上位8ビットを送信します。

Replacing Individual LUT Entries#

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

  1. Set the LUTIndex parameter to the pixel value that you want to replace with a new value.
  2. Set the LUTValue parameter to the new pixel value.
  3. 置き換えるすべてのピクセル値について、手順1と2を繰り返します。
  4. Set the 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のピクセル値を決定します。

元のピクセル値 LUTに格納された値 補間された値 新しいピクセル値(四捨五入)
24 20 20 20
25 - 21.25 21
26 - 22.5 22
27 - 23.75 23
28 - 25 25
29 - 26.25 26
30 - 27.5 27
31 - 28.75 28
32 30 30 30

情報

4088より大きいピクセル値は補間されません。代わりに、4088~4095のすべてのピクセル値は、LUTインデックス位置4088で入力されたピクセル値に置き換えられます。

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. Set the LUTValueAll parameter to the desired value.
    Make sure to apply the correct endianness of the 4-byte words (LUT values).
  2. Set the LUTEnable parameter to true.

情報

The LUTValueAll parameter is only available via the pylon API, not via the pylon Viewer feature tree.

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

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.

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

情報

  • 4バイトのワード(LUT値)のエンディアンネスは、カメラのモデルによって異なります。
  • LUTが512エントリに制限されている場合、カメラが実際に使用するのは8 番目ごとの4バイトワード(0、8、16、24、…、4088)のみです。他の4バイトワードは無視されます。例:

    LUTValueAll Parameter Structure (12-Bit Camera Models)

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.

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

情報

  • 4バイトのワード(LUT値)のエンディアンネスは、カメラのモデルによって異なります。
  • LUTが512エントリに制限されている場合、カメラが実際に使用するのは2番目ごとの4バイトワード(0、8、4、6、…、1022)のみです。他の4バイトワードは無視されます。例:

    LUTValueAll Parameter Structure (10-Bit Camera Models)

追加パラメーター#

The LUTSelector parameter allows you to select a lookup table.

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

特性#

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

カメラモデル Number of LUT Entries 4バイトワード(LUT値)のエンディアンネス
a2A640-240gmSWIR 4096 Big-endian
a2A640-240umSWIR 4096 Little-endian
a2A1280-80gmSWIR 4096 Big-endian
a2A1280-125umSWIR 4096 Little-endian
a2A1920-51gcBAS 4096 Big-endian
a2A1920-51gcPRO 4096 Big-endian
a2A1920-51gmBAS 4096 Big-endian
a2A1920-51gmPRO 4096 Big-endian
a2A1920-160ucBAS 4096 Little-endian
a2A1920-160ucPRO 4096 Little-endian
a2A1920-160umBAS 4096 Little-endian
a2A1920-160umPRO 4096 Little-endian
a2A1920-165g5cBAS 4096 Big-endian
a2A1920-165g5mBAS 4096 Big-endian
a2A2440-98g5cBAS 4096 Big-endian
a2A2440-98g5mBAS 4096 Big-endian
a2A2448-23gcBAS 4096 Big-endian
a2A2448-23gcPRO 4096 Big-endian
a2A2448-23gmBAS 4096 Big-endian
a2A2448-23gmPRO 4096 Big-endian
a2A2448-75ucBAS 4096 Little-endian
a2A2448-75ucPRO 4096 Little-endian
a2A2448-75umBAS 4096 Little-endian
a2A2448-75umPRO 4096 Little-endian
a2A2448-105g5cBAS 4096 Big-endian
a2A2448-105g5mBAS 4096 Big-endian
a2A2448-120cc 4096 Little-endian
a2A2448-120cm 4096 Little-endian
a2A2448-210cc 4096 Little-endian
a2A2448-210cm 4096 Little-endian
a2A2590-22gcBAS 4096 Big-endian
a2A2590-22gcPRO 4096 Big-endian
a2A2590-22gmBAS 4096 Big-endian
a2A2590-22gmPRO 4096 Big-endian
a2A2590-60ucBAS 4096 Little-endian
a2A2590-60ucPRO 4096 Little-endian
a2A2590-60umBAS 4096 Little-endian
a2A2590-60umPRO 4096 Little-endian
a2A2600-20gcBAS 4096 Big-endian
a2A2600-20gcPRO 4096 Big-endian
a2A2600-20gmBAS 4096 Big-endian
a2A2600-20gmPRO 4096 Big-endian
a2A2600-64ucBAS 4096 Little-endian
a2A2600-64ucPRO 4096 Little-endian
a2A2600-64umBAS 4096 Little-endian
a2A2600-64umPRO 4096 Little-endian
a2A2840-14gcBAS 4096 Big-endian
a2A2840-14gcPRO 4096 Big-endian
a2A2840-14gmBAS 4096 Big-endian
a2A2840-14gmPRO 4096 Big-endian
a2A2840-14gmUV 4096 Big-endian
a2A2840-48ucBAS 4096 Little-endian
a2A2840-48ucPRO 4096 Little-endian
a2A2840-48umBAS 4096 Little-endian
a2A2840-48umPRO 4096 Little-endian
a2A2840-48umUV 4096 Little-endian
a2A2840-67g5cBAS 4096 Big-endian
a2A2840-67g5mBAS 4096 Big-endian
a2A2840-67g5mUV 4096 Big-endian
a2A2840-86cc 4096 Little-endian
a2A2840-86cm 4096 Little-endian
a2A3840-13gcBAS 4096 Big-endian
a2A3840-13gcPRO 4096 Big-endian
a2A3840-13gmBAS 4096 Big-endian
a2A3840-13gmPRO 4096 Big-endian
a2A3840-45ucBAS 4096 Little-endian
a2A3840-45ucPRO 4096 Little-endian
a2A3840-45umBAS 4096 Little-endian
a2A3840-45umPRO 4096 Little-endian
a2A4096-9gcBAS 4096 Big-endian
a2A4096-9gcPRO 4096 Big-endian
a2A4096-9gmBAS 4096 Big-endian
a2A4096-9gmPRO 4096 Big-endian
a2A4096-30ucBAS 4096 Little-endian
a2A4096-30ucPRO 4096 Little-endian
a2A4096-30umBAS 4096 Little-endian
a2A4096-30umPRO 4096 Little-endian
a2A4096-44g5cBAS 4096 Big-endian
a2A4096-44g5mBAS 4096 Big-endian
a2A4096-67cc 4096 Little-endian
a2A4096-67cm 4096 Little-endian
a2A4200-12gcBAS 4096 Big-endian
a2A4200-12gcPRO 4096 Big-endian
a2A4200-12gmBAS 4096 Big-endian
a2A4200-12gmPRO 4096 Big-endian
a2A4200-40ucBAS 4096 Little-endian
a2A4200-40ucPRO 4096 Little-endian
a2A4200-40umBAS 4096 Little-endian
a2A4200-40umPRO 4096 Little-endian
a2A4504-5gcBAS 4096 Big-endian
a2A4504-5gcPRO 4096 Big-endian
a2A4504-5gmBAS 4096 Big-endian
a2A4504-5gmPRO 4096 Big-endian
a2A4504-18ucBAS 4096 Little-endian
a2A4504-18ucPRO 4096 Little-endian
a2A4504-18umBAS 4096 Little-endian
a2A4504-18umPRO 4096 Little-endian
a2A4504-27g5cBAS 4096 Big-endian
a2A4504-27g5mBAS 4096 Big-endian
a2A4504-42cc 4096 Little-endian
a2A4504-42cm 4096 Little-endian
a2A4508-6gcBAS 4096 Big-endian
a2A4508-6gcPRO 4096 Big-endian
a2A4508-6gmBAS 4096 Big-endian
a2A4508-6gmPRO 4096 Big-endian
a2A4508-20ucBAS 4096 Little-endian
a2A4508-20ucPRO 4096 Little-endian
a2A4508-20umBAS 4096 Little-endian
a2A4508-20umPRO 4096 Little-endian
a2A5320-7gcBAS 4096 Big-endian
a2A5320-7gcPRO 4096 Big-endian
a2A5320-7gmBAS 4096 Big-endian
a2A5320-7gmPRO 4096 Big-endian
a2A5320-23ucBAS 4096 Little-endian
a2A5320-23ucPRO 4096 Little-endian
a2A5320-23umBAS 4096 Little-endian
a2A5320-23umPRO 4096 Little-endian
a2A5320-34g5cBAS 4096 Big-endian
a2A5320-34g5mBAS 4096 Big-endian
a2A5320-52cc 4096 Little-endian
a2A5320-52cm 4096 Little-endian
a2A5328-4gcBAS 4096 Big-endian
a2A5328-4gcPRO 4096 Big-endian
a2A5328-4gmBAS 4096 Big-endian
a2A5328-4gmPRO 4096 Big-endian
a2A5328-15ucBAS 4096 Little-endian
a2A5328-15ucPRO 4096 Little-endian
a2A5328-15umBAS 4096 Little-endian
a2A5328-15umPRO 4096 Little-endian
a2A5328-22g5cBAS 4096 Big-endian
a2A5328-22g5mBAS 4096 Big-endian
a2A5328-35cc 4096 Little-endian
a2A5328-35cm 4096 Little-endian
acA640-121gm 512 Big-endian
acA640-300gc 512 Big-endian
acA640-300gm 512 Big-endian
acA640-750uc 512 Little-endian
acA640-750um 512 Little-endian
acA720-290gc 512 Big-endian
acA720-290gm 512 Big-endian
acA720-520uc 512 Little-endian
acA720-520um 512 Little-endian
acA800-200gc 512 Big-endian
acA800-200gm 512 Big-endian
acA800-510uc 512 Little-endian
acA800-510um 512 Little-endian
acA1280-60gc 512 Big-endian
acA1280-60gm 512 Big-endian
acA1300-60gc 512 Big-endian
acA1300-60gm 512 Big-endian
acA1300-60gmNIR 512 Big-endian
acA1300-75gc 512 Big-endian
acA1300-75gm 512 Big-endian
acA1300-200uc 512 Little-endian
acA1300-200um 512 Little-endian
acA1440-73gc 512 Big-endian
acA1440-73gm 512 Big-endian
acA1440-220uc 512 Little-endian
acA1440-220um 512 Little-endian
acA1600-20gc 512 Big-endian
acA1600-20uc 512 Little-endian
acA1600-60gc 512 Big-endian
acA1600-60gm 512 Big-endian
acA1920-25gc 512 Big-endian
acA1920-25gm 512 Big-endian
acA1920-25uc 512 Little-endian
acA1920-25um 512 Little-endian
acA1920-40gc 512 Big-endian
acA1920-40gm 512 Big-endian
acA1920-40uc 512 Little-endian
acA1920-40ucMED 4096 Little-endian
acA1920-40um 512 Little-endian
acA1920-40umMED 4096 Little-endian
acA1920-48gc 512 Big-endian
acA1920-48gm 512 Big-endian
acA1920-50gc 512 Big-endian
acA1920-50gm 512 Big-endian
acA1920-150uc 512 Little-endian
acA1920-150um 512 Little-endian
acA1920-155uc 512 Little-endian
acA1920-155ucMED 4096 Little-endian
acA1920-155um 512 Little-endian
acA1920-155umMED 4096 Little-endian
acA2000-50gc 512 Big-endian
acA2000-50gm 512 Big-endian
acA2000-165uc 512 Little-endian
acA2000-165um 512 Little-endian
acA2040-25gc 512 Big-endian
acA2040-25gm 512 Big-endian
acA2040-25gmNIR 512 Big-endian
acA2040-35gc 512 Big-endian
acA2040-35gm 512 Big-endian
acA2040-55uc 512 Little-endian
acA2040-55um 512 Little-endian
acA2040-90uc 512 Little-endian
acA2040-90um 512 Little-endian
acA2040-90umNIR 512 Little-endian
acA2040-120uc 512 Little-endian
acA2040-120um 512 Little-endian
acA2440-20gc 512 Big-endian
acA2440-20gm 512 Big-endian
acA2440-35uc 512 Little-endian
acA2440-35ucMED 4096 Little-endian
acA2440-35um 512 Little-endian
acA2440-35umMED 4096 Little-endian
acA2440-75uc 512 Little-endian
acA2440-75ucMED 4096 Little-endian
acA2440-75um 512 Little-endian
acA2440-75umMED 4096 Little-endian
acA2500-14gc 512 Big-endian
acA2500-14gm 512 Big-endian
acA2500-14uc 512 Little-endian
acA2500-14um 512 Little-endian
acA2500-20gc 512 Big-endian
acA2500-20gcMED 512 Big-endian
acA2500-20gm 512 Big-endian
acA2500-20gmMED 512 Big-endian
acA2500-60uc 512 Little-endian
acA2500-60um 512 Little-endian
acA3088-16gc 512 Big-endian
acA3088-16gm 512 Big-endian
acA3088-57uc 512 Little-endian
acA3088-57ucMED 4096 Little-endian
acA3088-57um 512 Little-endian
acA3088-57umMED 4096 Little-endian
acA3800-10gc 512 Big-endian
acA3800-10gm 512 Big-endian
acA3800-14uc 512 Little-endian
acA3800-14um 512 Little-endian
acA4024-8gc 512 Big-endian
acA4024-8gm 512 Big-endian
acA4024-29uc 512 Little-endian
acA4024-29um 512 Little-endian
acA4096-11gc 512 Big-endian
acA4096-11gm 512 Big-endian
acA4096-30uc 512 Little-endian
acA4096-30ucMED 4096 Little-endian
acA4096-30um 512 Little-endian
acA4096-30umMED 4096 Little-endian
acA4096-40uc 512 Little-endian
acA4096-40ucMED 4096 Little-endian
acA4096-40um 512 Little-endian
acA4096-40umMED 4096 Little-endian
acA4112-8gc 512 Big-endian
acA4112-8gm 512 Big-endian
acA4112-20uc 512 Little-endian
acA4112-20ucMED 4096 Little-endian
acA4112-20um 512 Little-endian
acA4112-20umMED 4096 Little-endian
acA4112-30uc 512 Little-endian
acA4112-30ucMED 4096 Little-endian
acA4112-30um 512 Little-endian
acA4112-30umMED 4096 Little-endian
acA5472-5gc 512 Big-endian
acA5472-5gm 512 Big-endian
acA5472-17uc 512 Little-endian
acA5472-17ucMED 4096 Little-endian
acA5472-17um 512 Little-endian
acA5472-17umMED 4096 Little-endian
boA1936-400cc 4096 Little-endian
boA1936-400cm 4096 Little-endian
boA2448-250cc 4096 Little-endian
boA2448-250cm 4096 Little-endian
boA2832-190cc 4096 Little-endian
boA2832-190cm 4096 Little-endian
boA4096-93cc 4096 Little-endian
boA4096-93cm 4096 Little-endian
boA4096-180cc 4096 Little-endian
boA4096-180cm 4096 Little-endian
boA4112-68cc 4096 Little-endian
boA4112-68cm 4096 Little-endian
boA4500-45cc 4096 Little-endian
boA4500-45cm 4096 Little-endian
boA4504-100cc 4096 Little-endian
boA4504-100cm 4096 Little-endian
boA5120-150cc LUT機能はサポートされていません N/A
boA5120-150cm LUT機能はサポートされていません N/A
boA5120-230cc LUT機能はサポートされていません N/A
boA5120-230cm LUT機能はサポートされていません N/A
boA5320-150cc 4096 Little-endian
boA5320-150cm 4096 Little-endian
boA5328-100cc 4096 Little-endian
boA5328-100cm 4096 Little-endian
boA6500-36cc 4096 Little-endian
boA6500-36cm 4096 Little-endian
boA8100-16cc 4096 Little-endian
boA8100-16cm 4096 Little-endian
boA9344-30cc LUT機能はサポートされていません N/A
boA9344-30cm LUT機能はサポートされていません N/A
boA9344-70cc LUT機能はサポートされていません N/A
boA9344-70cm LUT機能はサポートされていません N/A
boA13440-17cm LUT機能はサポートされていません LUT機能はサポートされていません
daA720-520uc LUT機能はサポートされていません LUT機能はサポートされていません
daA720-520um LUT機能はサポートされていません LUT機能はサポートされていません
daA1280-54uc LUT機能はサポートされていません LUT機能はサポートされていません
daA1280-54um LUT機能はサポートされていません LUT機能はサポートされていません
daA1440-220uc LUT機能はサポートされていません LUT機能はサポートされていません
daA1440-220um LUT機能はサポートされていません LUT機能はサポートされていません
daA1600-60uc LUT機能はサポートされていません LUT機能はサポートされていません
daA1600-60um LUT機能はサポートされていません LUT機能はサポートされていません
daA1920-15um LUT機能はサポートされていません LUT機能はサポートされていません
daA1920-30uc LUT機能はサポートされていません LUT機能はサポートされていません
daA1920-30um LUT機能はサポートされていません LUT機能はサポートされていません
daA1920-160uc LUT機能はサポートされていません LUT機能はサポートされていません
daA1920-160um LUT機能はサポートされていません LUT機能はサポートされていません
daA2448-70uc LUT機能はサポートされていません LUT機能はサポートされていません
daA2448-70um LUT機能はサポートされていません LUT機能はサポートされていません
daA2500-14uc LUT機能はサポートされていません LUT機能はサポートされていません
daA2500-14um LUT機能はサポートされていません LUT機能はサポートされていません
daA3840-45uc LUT機能はサポートされていません LUT機能はサポートされていません
daA3840-45um LUT機能はサポートされていません LUT機能はサポートされていません
dmA720-290gc 4096 Big-endian
dmA720-290gm 4096 Big-endian
dmA1440-73gc 4096 Big-endian
dmA1440-73gm 4096 Big-endian
dmA1920-51gc 4096 Big-endian
dmA1920-51gm 4096 Big-endian
puA1280-54uc LUT機能はサポートされていません LUT機能はサポートされていません
puA1280-54um LUT機能はサポートされていません LUT機能はサポートされていません
puA1600-60uc LUT機能はサポートされていません LUT機能はサポートされていません
puA1600-60um LUT機能はサポートされていません LUT機能はサポートされていません
puA1920-30uc LUT機能はサポートされていません LUT機能はサポートされていません
puA1920-30um LUT機能はサポートされていません LUT機能はサポートされていません
puA2500-14uc LUT機能はサポートされていません LUT機能はサポートされていません
puA2500-14um LUT機能はサポートされていません LUT機能はサポートされていません

サンプルコード#

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