Decimation#

「Decimation 」相機功能可讓您減少相機傳輸的感光元件像素列或行數。

此程序亦稱為「子採樣」。它能減少需傳輸的數據量，並可能提高相機的幀率。

使用功能#

運作原理#

您可以選擇水平或垂直的取樣率降低。

垂直Decimation#

若啟用垂直降采樣，則適用以下規定：

• 在單通道攝影機上，若指定垂直抽樣因子為n，攝影機將僅傳輸每 n 行中的一行。例如，當您指定垂直抽樣因子為 2 時，攝影機會傳輸第 1 行、跳過第 2 行、傳輸第 3 行，以此類推：

  

• 在彩色攝影機上，若指定垂直抽樣因子為n，攝影機僅會傳輸每 n 行中的一對行。例如，當指定垂直抽樣因子為 2 時，攝影機會傳輸第 1 行和第 2 行，跳過第 3 行和第 4 行，傳輸第 5 行和第 6 行，依此類推：

  

因此，影像高度會隨之減少。例如，啟用垂直方向的 2 倍降采樣，會使影像高度減半。相機會自動調整影像 ROI設定。

垂直降采樣能顯著提高相機的幀率。

水平Decimation#

若啟用水平降采樣，則適用以下規定：

• 在單色攝影機上，若指定水平降采樣係數為n，則攝影機僅會每 第 n 列列。例如，若將水平降採樣係數設定為 2，相機將傳輸第 1 列、跳過第 2 列、傳輸第 3 列，依此類推：

  

• 在彩色攝影機上，若指定水平取樣因子為n，則攝影機僅會傳輸每 第 n 個一對列。例如，若指定水平降采樣係數為 2，攝影機將傳輸第 1 和第 2 列，跳過第 3 和第 4 列，傳輸第 5 和第 6 列，以此類推：

  

因此，影像寬度會隨之減少。例如，啟用水平方向的 2 倍降采樣，將使影像寬度減半。相機會自動調整影像 ROI設定。

水平降采樣並不會（或僅在極小程度上）提高相機的幀率。

設定Decimation#

要設定降採樣：

1. 請確認相機處於閒置狀態，也就是說，目前並未進行影像擷取。
2. 若支援像素合併功能，請將其關閉。
3. 若支援縮放功能，請將縮放係數設定為 1 以停用縮放。
4. 要進行設定 垂直抽樣, 請為 DecimationVertical 參數中選擇性地指定 HTML 記錄檔 (*.html) 的路徑與檔名。
5. 要進行設定 水平降采樣, 請為 DecimationHorizontal 參數中選擇性地指定 HTML 記錄檔 (*.html) 的路徑與檔名。

參數的數值決定了抽樣因子。根據您的相機型號，可選用的數值如下：

• 1：停用降采樣。
• 2、3、4、……：可啟用以 2、3、4 等為間隔的降採樣。

舉例來說，設定 DecimationHorizontal 將數值設為 3 可實現水平方向以 3 為間隔的降採樣。

使用時的注意事項Decimation#

對 ROI 設定的影響

當您使用降采樣時，影像 ROI及自動功能 ROI的設定所指的，是最終產生的行數與列數。

舉例來說，假設您使用的是配備 1280 x 960 感測器的攝影機，且已啟用水平方向 2 倍降採樣與垂直方向 2 倍降採樣。在此情況下，ROI 的最大寬度為 640，最大高度則為 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

您也可以 use the pylon Viewer 來輕鬆設定參數。