Multiple ROI#

「Multiple ROI 」相機功能可讓您在感光元件陣列上定義多個區域，這些區域將被整合為單一影像進行傳輸。

系統僅會傳輸這些區域的像素資料。這能提高相機的幀率。

Multiple ROI 功能與 Stacked ROI 功能，該功能僅適用於Basler ace相機。

使用功能#

運作原理#

「Multiple ROI 」功能可讓您在感測器陣列上定義區域。區域的最大數量取決於您的相機型號。

當擷取影像時，感測器僅會讀取來自這些區域內的像素資訊，並將其作為單一影像傳輸出去。

無需分別定義各區域的大小與位置，而是直接在感測器陣列上定義行與列。接著，每條列與每行交會之處即形成一個區域。

在以下範例中，已定義兩行兩列。這將產生四個區域：

來自區域 11、區域 21、區域 12 及區域 22 的像素資訊，會以單一影像的形式傳輸。

設定行與列#

要設定列與行：

1. 請確保相機處於閒置狀態，也就是未擷取影像。
2. 請確保 Reverse X and Reverse Y 此功能已停用。
   您可以在設定好行數與列數後，重新啟用影像鏡像功能。
3. 設定欄位：
   1. 若要定義單一欄位：
      1. 將相機中的 BslMultipleROIColumnsEnable 參數設為 false.
      2. 將相機中的 OffsetX 將參數設定為欄位的目標水平偏移量。此值將套用至所有區域。
      3. 將相機中的 Width 將參數設定為欄位的目標寬度。此值將套用至所有區域。
   2. 若要定義多個欄位：
      1. 將相機中的 BslMultipleROIColumnsEnable 參數設為 true.
      2. 將相機中的 BslMultipleROIColumnSelector 將參數設定為所需的欄位，例如： Column1.
      3. 將相機中的 BslMultipleROIColumnOffset 將參數設定為欄位的目標水平偏移量，例如 100。
      4. 將相機中的 BslMultipleROIColumnSize 將參數設定為欄位的所需寬度，例如 50。
      5. 請針對您要設定的每一欄重複上述步驟。
         注意：為避免產生不必要的副作用，請務必按升序設定各欄，也就是說，先從第 1 欄開始，接著設定第 2 欄，依此類推。
4. 設定列：
   1. 若要定義單一行：
      1. 將相機中的 BslMultipleROIRowsEnable 參數設為 false.
      2. 將相機中的 OffsetY 將參數設定為該列所需的垂直偏移量。此數值將套用至所有區域。
      3. 將相機中的 Height 將參數設定為行的高度。此值將套用至所有區域。
   2. 若要定義多行：
      1. 將相機中的 BslMultipleROIRowsEnable 參數設為 true.
      2. 將相機中的 BslMultipleROIRowSelector 將參數設定為目標列，例如： Row1.
      3. 將相機中的 BslMultipleROIRowOffset 將參數設定為該行所需的垂直偏移量，例如 100。
      4. 將相機中的 BslMultipleROIRowSize 將參數設定為所需行高，例如 50。
      5. 請針對您要設定的每一行重複上述步驟。
         注意：為避免產生不期望的副作用，請務必按升序設定各行，也就是說，先從第 1 行開始，接著設定第 2 行，依此類推。
5. 如有需要，請重新啟用 Reverse X and Reverse Y。
   這會自動將欄與行的位置調整為鏡像狀態。

使用「Multiple ROI 」功能時的注意事項#

• 針對所有區域的總和（即由「Multiple ROI 」功能所生成的影像），存在一個特定於感測器的最小寬度和高度限制。在 設定, 相機會自動調整參數值與範圍，以符合最小寬度和高度的要求。最後一欄總是會被用來達到最小總寬度。由於的增量為 BslMultipleROIColumnSize 若將該參數一併考量在內，最終的總寬度可能會大於最小值。
  範例： 您的攝影機感測器總寬度至少為 530，並可設定最多兩欄。若將第 1 欄的寬度設定為 200，攝影機會自動將第 2 欄的最小寬度設定為 330。
  範例 2： 假設您使用的是與上述範例相同的感測器。同時假設該感測器的解析度為 1920 x 1200。此時，若將第 0 欄的垂直偏移量設定為 900，將沒有足夠的空間來定義一個符合最小寬度要求的區域。 因此，相機會自動將任何欄位的最大垂直偏移量設定為 670（1200 感測器寬度減去 530 的最小區域總寬度）。
• 鑑於上述限制，Basler 強烈建議將欄與列依升序進行設定，也就是說，應從第 1 欄開始，接著設定第 2 欄，依此類推。
• 在彩色攝影機上，若像素格式設定為需進行去拜爾處理的格式（即 RGB 或 YCbCr 像素格式），請注意：唯有當該區域的大小至少等於去拜爾處理區域（例如 3x3 像素）時，攝影機才能計算出有意義的色彩資訊。

• 若 buffer operator 的 BslMultipleROIColumnsEnable 參數設為 true, 以下參數將變為唯讀：

  • OffsetX: 此參數設定為第 1 欄的水平偏移量。
  • Width: 此參數設定為所有區域的總寬度，亦即由「Multiple ROI 」功能所建立之影像的寬度。

• 若 buffer operator 的 BslMultipleROIRowsEnable 參數設為 true, 以下參數將變為唯讀：

  • OffsetY: 此參數設定為第 1 行的垂直偏移量。
  • Height: 此參數設定為所有區域的總高度，亦即由「Multiple ROI 」功能所產生之影像的高度。

• 其他會影響影像大小的相機功能，例如： Binning 或 Pixel Beyond，都會在「Multiple ROI 」功能之後套用。因此，在設定行數與列數時，無需將這些功能所產生的影響納入考量。

• 當 自動功能 ROI 位置和大小會自動適應「Multiple ROI 」功能的輸出結果。例如，若所有區域的總寬度為 500，則 AutoFunctionROIWidth 該參數將設定為 500。

詳細資料#

顯示所有相機型號

範例程式碼#

// ** In this example, we define two regions in horizontal direction
// that will be transmitted as a single image. **
// Enable the ability to configure multiple columns
camera.BslMultipleROIColumnsEnable.SetValue(true);
// Select column 1
camera.BslMultipleROIColumnSelector.SetValue(BslMultipleROIColumnSelector_Column1);
// The first region should have a horizontal offset of 100 and a width of 300 pixels
camera.BslMultipleROIColumnOffset.SetValue(100);
camera.BslMultipleROIColumnSize.SetValue(300);
// Select column 2
camera.BslMultipleROIColumnSelector.SetValue(BslMultipleROIColumnSelector_Column2);
// The second region should have a horizontal offset of 500 and a width of 400 pixels
camera.BslMultipleROIColumnOffset.SetValue(500);
camera.BslMultipleROIColumnSize.SetValue(400);
// We only need one row, so disable the ability to configure multiple rows
camera.BslMultipleROIRowsEnable.SetValue(false);
// Both regions should have a vertical offset of 200 and a height of 500
camera.OffsetY.SetValue(200);
camera.Height.SetValue(500);

INodeMap& nodemap = camera.GetNodeMap();
// ** In this example, we define two regions in horizontal direction
// that will be transmitted as a single image. **
// Enable the ability to configure multiple columns
CBooleanParameter(nodemap, "BslMultipleROIColumnsEnable").SetValue(true);
// Select column 1
CEnumParameter(nodemap, "BslMultipleROIColumnSelector").SetValue("Column1");
// The first region should have a horizontal offset of 100 and a width of 300 pixels
CIntegerParameter(nodemap, "BslMultipleROIColumnOffset").SetValue(100);
CIntegerParameter(nodemap, "BslMultipleROIColumnSize").SetValue(300);
// Select column 2
CEnumParameter(nodemap, "BslMultipleROIColumnSelector").SetValue("Column2");
// The second region should have a horizontal offset of 500 and a width of 400 pixels
CIntegerParameter(nodemap, "BslMultipleROIColumnOffset").SetValue(500);
CIntegerParameter(nodemap, "BslMultipleROIColumnSize").SetValue(400);
// We only need one row, so disable the ability to configure multiple rows
CBooleanParameter(nodemap, "BslMultipleROIRowsEnable").SetValue(false);
// Both regions should have a vertical offset of 200 and a height of 500
CIntegerParameter(nodemap, "OffsetY").SetValue(200);
CIntegerParameter(nodemap, "Height").SetValue(500);

// ** In this example, we define two regions in horizontal direction
// that will be transmitted as a single image. **
// Enable the ability to configure multiple columns
camera.Parameters[PLCamera.BslMultipleROIColumnsEnable].SetValue(true);
// Select column 1
camera.Parameters[PLCamera.BslMultipleROIColumnSelector].SetValue(PLCamera.BslMultipleROIColumnSelector.Column1);
// The first region should have a horizontal offset of 100 and a width of 300 pixels
camera.Parameters[PLCamera.BslMultipleROIColumnOffset].SetValue(100);
camera.Parameters[PLCamera.BslMultipleROIColumnSize].SetValue(300);
// Select column 2
camera.Parameters[PLCamera.BslMultipleROIColumnSelector].SetValue(PLCamera.BslMultipleROIColumnSelector.Column2);
// The second region should have a horizontal offset of 500 and a width of 400 pixels
camera.Parameters[PLCamera.BslMultipleROIColumnOffset].SetValue(500);
camera.Parameters[PLCamera.BslMultipleROIColumnSize].SetValue(400);
// We only need one row, so disable the ability to configure multiple rows
camera.Parameters[PLCamera.BslMultipleROIRowsEnable].SetValue(false);
// Both regions should have a vertical offset of 200 and a height of 500
camera.Parameters[PLCamera.OffsetY].SetValue(200);
camera.Parameters[PLCamera.Height].SetValue(500);

/* 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 */
/* ** In this example, we define two regions in horizontal direction */
/* that will be transmitted as a single image. ** */
/* Enable the ability to configure multiple columns */
errRes = PylonDeviceSetBooleanFeature(hdev, "BslMultipleROIColumnsEnable", 1);
CHECK(errRes);
/* Select column 1 */
errRes = PylonDeviceFeatureFromString(hdev, "BslMultipleROIColumnSelector", "Column1");
CHECK(errRes);
/* The first region should have a horizontal offset of 100 and a width of 300 pixels */
errRes = PylonDeviceSetIntegerFeature(hdev, "BslMultipleROIColumnOffset", 100);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "BslMultipleROIColumnSize", 300);
CHECK(errRes);
/* Select column 2 */
errRes = PylonDeviceFeatureFromString(hdev, "BslMultipleROIColumnSelector", "Column2");
CHECK(errRes);
/* The second region should have a horizontal offset of 500 and a width of 400 pixels */
errRes = PylonDeviceSetIntegerFeature(hdev, "BslMultipleROIColumnOffset", 500);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "BslMultipleROIColumnSize", 400);
CHECK(errRes);
/* We only need one row, so disable the ability to configure multiple rows */
errRes = PylonDeviceSetBooleanFeature(hdev, "BslMultipleROIRowsEnable", 0);
CHECK(errRes);
/* Both regions should have a vertical offset of 200 and a height of 500 */
errRes = PylonDeviceSetIntegerFeature(hdev, "OffsetY", 200);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "Height", 500);
CHECK(errRes);

# ** In this example, we define two regions in horizontal direction
# that will be transmitted as a single image. **
# Enable the ability to configure multiple columns
camera.BslMultipleROIColumnsEnable.Value = True
# Select column 1
camera.BslMultipleROIColumnSelector.Value = "Column1"
# The first region should have a horizontal offset of 100 and a width of 300 pixels
camera.BslMultipleROIColumnOffset.Value = 100
camera.BslMultipleROIColumnSize.Value = 300
# Select column 2
camera.BslMultipleROIColumnSelector.Value = "Column2"
# The second region should have a horizontal offset of 500 and a width of 400 pixels
camera.BslMultipleROIColumnOffset.Value = 500
camera.BslMultipleROIColumnSize.Value = 400
# We only need one row, so disable the ability to configure multiple rows
camera.BslMultipleROIRowsEnable.Value = False
# Both regions should have a vertical offset of 200 and a height of 500
camera.OffsetY.Value = 200
camera.Height.Value = 500

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