Decimation#

Decimationカメラ機能を使用すると、カメラから送信されるセンサー画素の列または行の数を減らすことができます。

この手順は、「サブサンプリング」とも呼ばれます。これにより、転送されるデータ量が減少するので、カメラのフレームレートが上がる可能性があります。

機能を使用する#

仕組み#

水平デシメーションと垂直デシメーションのいずれかを選択できます。

垂直Decimation#

垂直デシメーションを有効にすると、以下が適用されます。

• モノカメラでは、垂直デシメーション係数nを指定すると、カメラはn行ごとにのみ送信します。例えば、垂直デシメーション係数2を指定すると、カメラは行1を送信し、行2をスキップし、行3を送信するという具合です。

  

• カラーカメラでは、垂直デシメーション係数nを指定すると、カメラはnペア行ごとにのみ送信します。例えば、垂直デシメーション係数2を指定すると、カメラは行1と2を送信し、行3と4をスキップし、行5と6を送信するという具合です。

  

その結果、画像の高さが低くなります。例えば、垂直デシメーションを2で有効にすると、画像の高さが半分になります。カメラは自動的に画像ROI設定を調整します。

垂直デシメーションにより、カメラのフレームレートが大幅に上がります。

水平Decimation#

水平デシメーションを有効にすると、以下が適用されます。

• モノクロカメラでは、水平方向のデシメーション係数nを指定すると、カメラは毎nth列だけを送信します。たとえば、水平方向のデシメーション係数を2に指定すると、カメラは列1を送信し、列2をスキップし、列3を送信するというように動作します。

  

• カラーカメラでは、水平方向のデシメーション係数nを指定すると、カメラは毎nthのペア列だけを送信します。たとえば、水平方向のデシメーション係数を2に指定した場合、カメラは列1と2を送信し、列3と4をスキップし、列5と6を送信するというように動作します。

  

その結果、画像の幅が狭くなります。例えば、水平デシメーションを2で有効にすると、画像の幅が半分になります。カメラは自動的に画像ROI設定を調整します。

水平デシメーションでは、カメラのフレームレートは上がりません（または非常にわずかだけ上がります）。

Decimationの設定#

デシメーションを設定するには、次の手順に従います。

1. カメラがアイドル状態であること、つまり画像をキャプチャしていないことを確認します。
2. ビニングを無効にします（使用可能な場合）。
3. スケーリング係数を1に設定することで、スケーリングを無効にします（使用可能な場合）。
4. To configure vertical decimation, enter a value for the DecimationVertical parameter.
5. To configure horizontal decimation, enter a value for the DecimationHorizontal parameter.

パラメーターの値は、デシメーション係数を定義します。お使いのカメラのモデルに応じて、次の値を使用できます。

• 1：デシメーションを無効にします。
• 2、3、4…：2、3、4などのデシメーションを有効にします。

For example, setting DecimationHorizontal to 3 enables horizontal decimation by 3.

Decimation使用時に考慮すること#

ROI設定への影響

デシメーションを使用している場合、画像ROIとオートファンクションROIの設定は、結果として得られる行数と列数を参照します。

例えば、1280 x 960センサーを搭載したカメラを使用しているとします。水平デシメーション2、垂直デシメーション2が有効です。この場合、最大ROI幅は640で、最大ROI高さは480になります。

解像度の低下

デシメーションを使用すると、カメラのイメージセンサーの解像度が効果的に低下します。例えば、1280 x 960センサーを搭載したカメラで、水平デシメーションを2、垂直デシメーションを2に設定する場合、センサーの有効解像度は640 x 480に低下します。

画像の歪みの可能性

オブジェクトは、垂直および水平のデシメーション係数が等しい場合にのみ、画像内で歪みのない状態で表示されます。その他の組み合わせでは、オブジェクトは歪んで表示されます。例えば、垂直デシメーション2、水平デシメーション4で結合すると、対象オブジェクトが押しつぶされて表示されます。

特性#

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

サンプルコード#

// Enable horizontal decimation by 2
camera.DecimationHorizontal.SetValue(2);
// Enable vertical decimation by 2
camera.DecimationVertical.SetValue(2);
// Disable horizontal decimation
camera.DecimationHorizontal.SetValue(1);
// Disable vertical decimation
camera.DecimationVertical.SetValue(1);

INodeMap& nodemap = camera.GetNodeMap();
// Enable horizontal decimation by 2
CIntegerParameter(nodemap, "DecimationHorizontal").SetValue(2);
// Enable vertical decimation by 2
CIntegerParameter(nodemap, "DecimationVertical").SetValue(2);
// Disable horizontal decimation
CIntegerParameter(nodemap, "DecimationHorizontal").SetValue(1);
// Disable vertical decimation
CIntegerParameter(nodemap, "DecimationVertical").SetValue(1);

// Enable horizontal decimation by 2
camera.Parameters[PLCamera.DecimationHorizontal].SetValue(2);
// Enable vertical decimation by 2
camera.Parameters[PLCamera.DecimationVertical].SetValue(2);
// Disable horizontal decimation
camera.Parameters[PLCamera.DecimationHorizontal].SetValue(1);
// Disable vertical decimation
camera.Parameters[PLCamera.DecimationVertical].SetValue(1);

/* 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 */
/* Enable horizontal decimation by 2 */
errRes = PylonDeviceSetIntegerFeature(hdev, "DecimationHorizontal", 2);
CHECK(errRes);
/* Enable vertical decimation by 2 */
errRes = PylonDeviceSetIntegerFeature(hdev, "DecimationVertical", 2);
CHECK(errRes);
/* Disable horizontal decimation */
errRes = PylonDeviceSetIntegerFeature(hdev, "DecimationHorizontal", 1);
CHECK(errRes);
/* Disable vertical decimation */
errRes = PylonDeviceSetIntegerFeature(hdev, "DecimationVertical", 1);
CHECK(errRes);

# Enable horizontal decimation by 2
camera.DecimationHorizontal.Value = 2
# Enable vertical decimation by 2
camera.DecimationVertical.Value = 2
# Disable horizontal decimation
camera.DecimationHorizontal.Value = 1
# Disable vertical decimation
camera.DecimationVertical.Value = 1

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