Multiple ROI#

Multiple ROIカメラ機能を使用すると、単一の画像として送信されるセンサーアレイ上の複数の領域を定義できます。

これらの領域からのピクセルデータのみが転送されます。これにより、カメラのフレームレートが増加します。

The Multiple ROI feature is similar to the Stacked ROI feature, which is only available on Basler ace cameras.

機能を使用する#

仕組み#

このMultiple ROI機能を使用すると、センサーアレイに領域を定義できます。領域の最大数は、カメラのモデルによって異なります。

画像を取得すると、領域内のピクセル情報のみがセンサーから読み取られ、単一の画像として送信されます。

領域のサイズと位置を個別に定義する代わりに、センサー配列に行と列を定義します。その後、列と行の各交差によって領域が作成されます。

次の例では、2つの行と2つの列が定義されています。これにより、次の4つの領域が作成されます：

Region 11、Region 21、Region12、およびRegion 22内のピクセル情報は、1つの画像として送信されます。

Configuring the Rows and Columns#

行と列は次のように設定します。

1. カメラがアイドル状態であること、つまり画像をキャプチャしていないことを確認します。
2. Reverse X and Reverse Y機能が無効になっていること
   を確認します。行と列を設定した後で、画像ミラーリングを再度有効にできます。
3. 列を設定します。
   1. 単一の列を定義する場合、
      1. パラメーターを BslMultipleROIColumnsEnable parameter to false.
      2. パラメーターを OffsetX parameter to the desired horizontal offset of the column. This value is applied to all regions.
      3. パラメーターを Width parameter to the desired width of the column. This value is applied to all regions.
   2. 複数の列を定義する場合：
      1. パラメーターを BslMultipleROIColumnsEnable parameter to true.
      2. パラメーターを BslMultipleROIColumnSelector parameter to the desired column, e.g., Column1.
      3. パラメーターを BslMultipleROIColumnOffset parameter to the desired horizontal offset of the column, e.g., 100.
      4. パラメーターを BslMultipleROIColumnSize parameter to the desired width of the column, e.g., 50.
      5. 設定するすべての列について、上記の手順を繰り返します。
         注：望ましくない副作用を避けるため、列は常に昇順に設定してください。つまり、列1から始めて、列2を設定して続けます。
4. 行を設定する：
   1. 1つの行を定義する場合：
      1. パラメーターを BslMultipleROIRowsEnable parameter to false.
      2. パラメーターを OffsetY parameter to the desired vertical offset of the row. This value is applied to all regions.
      3. パラメーターを Height parameter to the desired height of the row. This value is applied to all regions.
   2. 複数の行を定義する場合：
      1. パラメーターを BslMultipleROIRowsEnable parameter to true.
      2. パラメーターを BslMultipleROIRowSelector parameter to the desired row, e.g., Row1.
      3. パラメーターを BslMultipleROIRowOffset parameter to the desired vertical offset of the row, e.g., 100.
      4. パラメーターを BslMultipleROIRowSize parameter to the desired height of the row, e.g., 50.
      5. 設定するすべての行について、上記の手順を繰り返します。
         注： 望ましくない副作用を避けるため、行は常に昇順に設定してください。つまり、行1から始めて、行2を設定して続けます。
5. 必要に応じて、Reverse X and Reverse Yを再度有効にします。
   これにより、列と行の位置がミラー画像に自動的に調整されます。

Considerations When Using the Multiple ROI Feature#

• There's a sensor-specific minimum width and height for all regions combined, i.e., for the images created by the Multiple ROI feature. During configuration, the camera automatically adjusts the parameter values and ranges to meet the minimum width and height. The last column is always used to reach the minimum total width. Because the increment of the BslMultipleROIColumnSize parameter is also taken into account, the resulting total width may be larger than the minimum.
  例： The sensor of your camera has a minimum total width of 530 and allows you to configure up to two columns. If you set the width of column 1 to 200, the camera automatically sets the minimum width of column 2 to 330.
  Example 2: Assume you are using the same sensor as in the example above. Also assume the resolution of that sensor is 1920 x 1200. Now, if you'd set the vertical offset of column 0 to 900, there wouldn't be enough space to define a region that meets the minimum width requirement. Therefore, the camera automatically sets the maximum vertical offset for any column to 670 (1200 sensor width minus 530 minimum total region width).
• 上記の制約のため、Baslerでは、列と行を昇順に設定することを強くお勧めします。つまり、列1から始めて、列2を設定して続けます。
• カラーカメラでは、ピクセルフォーマットがデベイヤリングを伴うフォーマット（RGBまたはYCbCrのピクセルフォーマット）に設定されている場合、デベイヤリング領域のサイズ以上の領域（3x3ピクセルなど）では、カメラが意味のあるカラー情報のみを計算できることを考慮してください。

• If the BslMultipleROIColumnsEnable parameter is set to true, the following parameters become read-only:

  • OffsetX: The parameter is set to the horizontal offset of column 1.
  • Width: The parameter is set to the total width of all regions, i.e., the width of the images created by the Multiple ROI feature.

• If the BslMultipleROIRowsEnable parameter is set to true, the following parameters become read-only:

  • OffsetY: The parameter is set to the vertical offset of row 1.
  • Height: The parameter is set to the total height of all regions, i.e., the height of the images created by the Multiple ROI feature.

• 画像サイズに影響を与えるその他のカメラ機能（BinningまたはPixel Beyond）は、Multiple ROI機能の後に適用されます。したがって、行と列を構成するときに、これらの機能の効果を考慮する必要はありません。

• イメージ auto function ROI positions and sizes automatically adapt to the output of the Multiple ROI feature. For example, if the width of all regions combined is 500, the maximum value of the AutoFunctionROIWidth parameter will be 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

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