コンテンツにスキップ

Pixel Format (dart E)#

Pixel Formatカメラ機能を使用すると、カメラから送信される画像データの形式を選択できます。

カメラのモデルや、カメラがカラーかモノクロかによって、ピクセルフォーマットが異なります。

情報

ピクセルフォーマットの詳細については、GenICam Pixel Format Naming Convention 2.1を参照してください。

機能を使用する#

Pixel Formatの選択#

ピクセルフォーマットを選択するには、次の手順に従います。

  1. カメラがアイドル状態であること、つまり画像をキャプチャしていないことを確認します。
  2. パラメーターを PixelFormat 次のいずれかの値(使用している場合)に設定します

Pixel Formatの決定#

To determine the pixel format currently used by the camera, read the value of the PixelFormat parameter.

使用可能なPixel Format#

情報

For a list of the enumeration values, see the Programmer's Guide and Reference Documentation delivered with the Basler pylon Software Suite.

Mono Formats#

モノクロカメラがいずれかのモノクロピクセルフォーマットを使用している場合、1画素あたり8ビット、10ビット、または12ビットのデータが出力されます。

カラーカメラでいずれかのモノクロピクセル形式を使用している場合、各ピクセルの値は最初にYCbCrカラーモデルに変換されます。このモデルのY成分は輝度値を表し、モノクロセンサーのピクセルから得られる値と同じです。つまり、カラーカメラが「Mono 8」などに設定されている場合、8ビットのモノクロ画像が出力されます。

YCbCr Formats#

カラーカメラは、ピクセルデータに基づいて、YCbCr(またはYUV)形式でカラー画像を出力することもできます。

カラーカメラがこの形式を使用している場合、キャプチャされた画像の各ピクセル値は、センサーを出て、カメラを通過するときに、変換プロセスも通過します。このプロセスでは、ピクセル値ごとにY、CB、およびCRのカラー情報が生成されます。

RGBおよびBGR形式#

カラーカメラがRGB 8またはBGR 8ピクセルフォーマットを使用する場合、カメラは取得したフレームの各画素について、8ビットの赤データ、8ビットの緑データ、および8ビットの青データを出力します。

ピクセルフォーマットは、カラーデータ(赤、緑、青または青、緑、赤)の出力シーケンスによって異なります。

Maximum Pixel Bit Depth#

最大画素ビット深度は、カメラで使用可能なピクセルフォーマットの中で最も高いビット深度を持つピクセルフォーマットによって定義されます。

例:カメラで使用できるピクセルフォーマットがMono 8およびMono 12の場合、カメラの最大画素ビット深度は12ビットです。

特性#

カメラモデル SoC/ボード 使用可能なPixel Format
daA2500-60mc i.MX8M Plus YUV422_8
daA2500-60mci NVIDIA Jetson YUV422_8_UYVY
daA2500-60mci i.MX8M Quad YUV422_8_UYVY
daA2500-60mci i.MX8M Plus YUV422_8
daA2500-60mci i.MX8M Mini YUV422_8_UYVY、YCbCr420_8_YY_CbCr_Semiplanar
daA3840-30mc i.MX8M Plus YUV422_8
daA4200-30mci NVIDIA Jetson YUV422_8_UYVY
daA4200-30mci i.MX8M Quad YUV422_8_UYVY
daA4200-30mci i.MX8M Plus YUV422_8
daA4200-30mci i.MX8M Mini YUV422_8_UYVY、YCbCr420_8_YY_CbCr_Semiplanar

サンプルコード#

// Set the pixel format to Mono 8
camera.PixelFormat.SetValue(PixelFormat_Mono8);
INodeMap& nodemap = camera.GetNodeMap();
// Set the pixel format to Mono 8
CEnumParameter(nodemap, "PixelFormat").SetValue("Mono8");
// Set the pixel format to Mono 8
camera.Parameters[PLCamera.PixelFormat].SetValue(PLCamera.PixelFormat.Mono8);
/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
/* Set the pixel format to Mono 8 */
errRes = PylonDeviceFeatureFromString(hdev, "PixelFormat", "Mono8");
CHECK(errRes);
# Set the pixel format to Mono 8
camera.PixelFormat.Value = "Mono8"
/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
/* Set the pixel format to Mono 8 */
errRes = PylonDeviceFeatureFromString(hdev, "PixelFormat", "Mono8");
CHECK(errRes);

pylonViewerアを使用して、パラメーターを簡単に設定することもできます。