Decimation#

透過 Decimation 相機功能，您可以減少相機傳輸的感光元件像素欄或列數。

此程序也稱為「子取樣」(subsampling)。它能減少要傳輸的資料量，並可能提高相機的 frame rate。

使用此功能#

運作原理#

您可以選擇水平或垂直 Decimation。

Vertical Decimation#

如果您啟用垂直 Decimation，則適用以下規則：

• 在 mono 相機上，如果您指定垂直 Decimation 係數為 n，則相機僅傳輸每隔 nth 個 row。例如，當您指定的垂直 Decimation 係數為 2 時，相機將傳輸第 1 行、跳過第 2 行、傳輸第 3 行，依此類推：

  

• 在 color 相機上，如果您指定垂直 Decimation 係數為 n，則相機僅傳輸每隔 nth 對 row。例如，當您指定的垂直 Decimation 係數為 2 時，相機將傳輸第 1 和第 2 行、跳過第 3 和第 4 行、傳輸第 5 和第 6 行，依此類推：

  

因此，影像高度會減少。例如，啟用 2 倍垂直 Decimation 會使影像高度減半。相機會自動調整 Image ROI 設定。

垂直 Decimation 會顯著提高相機的 frame rate。

Horizontal Decimation#

如果您啟用水平 Decimation，則適用以下規則：

• 在 mono 相機上，如果您指定水平 Decimation 係數為 n，則相機僅傳輸每隔 nth 個 column。例如，如果您設定水平 Decimation 係數為 2，相機將傳輸第 1 欄、跳過第 2 欄、傳輸第 3 欄，依此類推：

  

• 在 color 相機上，如果您指定水平 Decimation 係數為 n，則相機僅傳輸每隔 nth 對 column。例如，如果您指定水平 Decimation 係數為 2，相機將傳輸第 1 和第 2 欄、跳過第 3 和第 4 欄、傳輸第 5 和第 6 欄，依此類推：

  

因此，影像寬度會減少。例如，啟用 2 倍水平 Decimation 會使影像寬度減半。相機會自動調整 Image ROI 設定。

水平 Decimation 不會（或僅在極小程度上）提高相機的 frame rate。

設定 Decimation#

若要設定 Decimation：

1. 請確保相機處於閒置狀態，也就是未擷取影像。
2. 停用 Binning（如果可用）。
3. 將 scaling 係數設為 1，藉此停用 Scaling（如果可用）。
4. 若要設定 垂直 Decimation，請輸入 DecimationVertical 參數的值。
5. 若要設定 水平 Decimation 的數值，請輸入 DecimationHorizontal 參數的值。

參數值定義了 Decimation 係數。根據您的相機型號，可使用下列數值：

• 1：停用 Decimation。
• 2、3、4、…：啟用 2、3、4 等倍數的 Decimation。

例如，將 DecimationHorizontal 設為 3 可啟用水平 3 倍 Decimation。

使用 Decimation 的注意事項#

對 ROI 設定的影響

當您使用 Decimation 時，Image ROI 和 Auto Function ROI 的設定是指產生的行數與列數。

例如，假設您使用的是具備 1280 x 960 感光元件的相機。啟用了水平 2 倍 Decimation 與垂直 2 倍 Decimation。在此情況下，最大 ROI 寬度將為 640，最大 ROI 高度將為 480。

降低解析度

使用 Decimation 會實際降低相機影像感光元件的解析度。例如，如果您將具備 1280 x 960 感光元件的相機設為使用水平 2 倍與垂直 2 倍 Decimation，感光元件的有效解析度就會降低至 640 x 480。

可能的影像失真

唯有在垂直與水平 Decimation 係數相同時，物件才會在影像中正常顯示而不失真。對於所有其他組合，物件都會變形。例如，如果您將垂直 2 倍 Decimation 與水平 4 倍 Decimation 結合，目標物件就會看起來遭到擠壓。

詳細資料#

顯示所有相機型號

範例程式碼#

// 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 來輕鬆設定參數。