Pixel Format#

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

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

機能を使用する#

Pixel Formatの選択#

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

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

Pixel Formatの決定#

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

使用可能なPixel Format#

Mono Formats#

If a monochrome camera uses one of the mono pixel formats, it outputs 8, 10, 12, or 14 bits of data per pixel.

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

使用できるモノラル形式は、お使いのカメラのモデルによって異なります。

Bayer Formats#

カラーカメラには、Bayerカラーフィルターが装備されており、Bayerのピクセルフォーマットに基づいてカラー画像を出力することができます。

カラーカメラがBayerのいずれかのピクセルフォーマットを使用している場合、1ピクセルあたり8ビット、10ビット、または12ビットのデータが出力されます。各ピクセルは、赤、緑、青のいずれかの色のみを記録するようにフィルタ処理されます。ピクセルデータは、どのような方法でも処理または補間されません。このタイプのピクセルデータは、「生」出力と呼ばれることもあります。

どのBayerフォーマットを使用できるかは、お使いのカメラのモデルによって異なります。

YCbCr Formats#

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

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

RGBおよびBGR形式#

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

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

BiColor BGRG and RGBG Formats#

The color cameras with BiColor pixel formats are equipped with a color filter array as displayed in the example figure below. The color filter array of the sensor has the red and blue color components on the first line, and the green component on the second line.

The camera combines this color information and outputs the data as shown in the example figure below.

If a color camera uses one of the BiColor pixel formats, it outputs 8 bit of data per pixel. Each pixel is filtered to record only one of the colors red, green, and blue. The pixel data is not processed or interpolated in any way. This type of pixel data is sometimes referred to as "raw" output. The pixel formats differ by the output sequences for the color data (blue, green, red, green or red, green, blue, green).

Which BiColor formats are available depends on your camera model.

Maximum Pixel Bit Depth#

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

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

Unpacked and Packed Pixel Formats#

カメラがアンパックされたピクセルフォーマット（例：Bayer 12）を使用している場合、画素データは常に8ビットに整列されます。次の8ビット境界に到達するために、必要に応じてパディングビット（ゼロ）が挿入されます。

例（簡略版）：

12ビットのアンパックされたピクセルフォーマットを選択したとします。カメラは、画素あたり16ビットを出力します。画素データは12ビット、パディングビットは4ビットで、次の8ビット境界に到達します。

カメラがパックされたピクセルフォーマット（例：Bayer 12p）を使用している場合、画素データは整列されません。つまり、パディングビットは挿入されず、1バイトに複数の画素のデータを含めることができます。

例（簡略版）：

12ビットのパックされたピクセルフォーマットを選択したとします。カメラは、1画素あたり12ビットを出力します。その結果、2画素のデータは常に3バイトに分散されます。

特性#

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

サンプルコード#

// 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"

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