Pixel Format (dart E)#

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

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

機能を使用する#

Pixel Formatの選択#

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

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

Pixel Formatの決定#

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

使用可能なPixel Format#

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ビットです。

特性#

サンプルコード#

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