跳转到内容

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 功能允许您在传感器阵列上定义分区。最大分区数量取决于您的相机型号

采集图像时,仅从传感器读出分区内的像素信息,然后作为单个图像发送。

无需单独定义分区的大小和位置,而是在传感器阵列上定义行和列。然后,在行和列的每个交叉点创建一个分区。

在下例中,已定义了两行和两列。这将创建四个分区:

Multiple ROI 示例

将 Region 11、Region 21、Region 12 和 Region 22 中的像素信息作为单个图像发送。

配置行和列#

信息

On some camera models, you can only configure rows and not columns when you're creating regions. In this case, each region covers the entire sensor width and can be considered to have a single column.

配置行和列:

  1. 确保相机空闲,即未在捕获图像。
  2. 确保 Reverse X and Reverse Y 功能已禁用。
    配置行和列后,可以重新启用图像镜像。
  3. 配置列:
    1. 如果要定义单个列:
      1. Set the BslMultipleROIColumnsEnable parameter to false.
      2. Set the OffsetX parameter to the desired horizontal offset of the column. This value is applied to all regions.
      3. Set the Width parameter to the desired width of the column. This value is applied to all regions.
    2. 如果要定义多个列:
      1. Set the BslMultipleROIColumnsEnable parameter to true.
      2. Set the BslMultipleROIColumnSelector parameter to the desired column, e.g., Column1.
      3. Set the BslMultipleROIColumnOffset parameter to the desired horizontal offset of the column, e.g., 100.
      4. Set the BslMultipleROIColumnSize parameter to the desired width of the column, e.g., 50.
      5. 对要配置的每一列重复上述步骤。
        注意:为避免意外的边缘效应,请始终按升序配置列,即从第 1 列开始配置,然后配置第 2 列,依此类推。
  4. 配置行:
    1. 如果要定义单个行:
      1. Set the BslMultipleROIRowsEnable parameter to false.
      2. Set the OffsetY parameter to the desired vertical offset of the row. This value is applied to all regions.
      3. Set the Height parameter to the desired height of the row. This value is applied to all regions.
    2. 如果要定义多个行:
      1. Set the BslMultipleROIRowsEnable parameter to true.
      2. Set the BslMultipleROIRowSelector parameter to the desired row, e.g., Row1.
      3. Set the BslMultipleROIRowOffset parameter to the desired vertical offset of the row, e.g., 100.
      4. Set the BslMultipleROIRowSize parameter to the desired height of the row, e.g., 50.
      5. 对要配置的每一行重复上述步骤。
        注意:为避免意外的边缘效应,请始终按升序配置行,即从第 1 行开始配置,然后配置第 2 行,依此类推。
  5. 如果需要,请重新启用 Reverse X and Reverse Y
    这将使列和行的位置自动适应镜像图像。

Multiple ROI 功能使用注意事项#

  • 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.
    Example: 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.
  • 其他影响图像尺寸的相机功能,例如,BinningPixel Beyond,是在 Multiple ROI 功能之后应用。因此,在配置行和列时,您不必考虑这些功能的影响。

  • The 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.

详情#

显示所有相机型号

相机型号 Maximum Number of Regions (Rows x Columns)
a2A640-240gmSWIR 64 (8 x 8)
a2A640-240umSWIR 64 (8 x 8)
a2A1280-80gmSWIR 64 (8 x 8)
a2A1280-125umSWIR 64 (8 x 8)
a2A1920-51gcBAS 4 (2 x 2)
a2A1920-51gcPRO 4 (2 x 2)
a2A1920-51gmBAS 4 (2 x 2)
a2A1920-51gmPRO 4 (2 x 2)
a2A1920-160ucBAS 4 (2 x 2)
a2A1920-160ucPRO 4 (2 x 2)
a2A1920-160umBAS 4 (2 x 2)
a2A1920-160umPRO 4 (2 x 2)
a2A1920-165g5cBAS 4 (2 x 2)
a2A1920-165g5mBAS 4 (2 x 2)
a2A2440-98g5cBAS 64 (8 x 8)
a2A2440-98g5mBAS 64 (8 x 8)
a2A2448-23gcBAS 64 (8 x 8)
a2A2448-23gcPRO 64 (8 x 8)
a2A2448-23gmBAS 64 (8 x 8)
a2A2448-23gmPRO 64 (8 x 8)
a2A2448-75ucBAS 64 (8 x 8)
a2A2448-75ucPRO 64 (8 x 8)
a2A2448-75umBAS 64 (8 x 8)
a2A2448-75umPRO 64 (8 x 8)
a2A2448-105g5cBAS 64 (8 x 8)
a2A2448-105g5mBAS 64 (8 x 8)
a2A2590-22gcBAS 不支持 Multiple ROI 功能
a2A2590-22gcPRO 不支持 Multiple ROI 功能
a2A2590-22gmBAS 不支持 Multiple ROI 功能
a2A2590-22gmPRO 不支持 Multiple ROI 功能
a2A2590-60ucBAS 不支持 Multiple ROI 功能
a2A2590-60ucPRO 不支持 Multiple ROI 功能
a2A2590-60umBAS 不支持 Multiple ROI 功能
a2A2590-60umPRO 不支持 Multiple ROI 功能
a2A2600-20gcBAS 16 (16 x 1)a
a2A2600-20gcPRO 16 (16 x 1)a
a2A2600-20gmBAS 16 (16 x 1)a
a2A2600-20gmPRO 16 (16 x 1)a
a2A2600-64ucBAS 16 (16 x 1)a
a2A2600-64ucPRO 16 (16 x 1)a
a2A2600-64umBAS 16 (16 x 1)a
a2A2600-64umPRO 16 (16 x 1)a
a2A2840-14gcBAS 64 (8 x 8)
a2A2840-14gcPRO 64 (8 x 8)
a2A2840-14gmBAS 64 (8 x 8)
a2A2840-14gmPRO 64 (8 x 8)
a2A2840-48ucBAS 64 (8 x 8)
a2A2840-48ucPRO 64 (8 x 8)
a2A2840-48umBAS 64 (8 x 8)
a2A2840-48umPRO 64 (8 x 8)
a2A2840-67g5cBAS 64 (8 x 8)
a2A2840-67g5mBAS 64 (8 x 8)
a2A3840-13gcBAS 不支持 Multiple ROI 功能
a2A3840-13gcPRO 不支持 Multiple ROI 功能
a2A3840-13gmBAS 不支持 Multiple ROI 功能
a2A3840-13gmPRO 不支持 Multiple ROI 功能
a2A3840-45ucBAS 不支持 Multiple ROI 功能
a2A3840-45ucPRO 不支持 Multiple ROI 功能
a2A3840-45umBAS 不支持 Multiple ROI 功能
a2A3840-45umPRO 不支持 Multiple ROI 功能
a2A4096-9gcBAS 64 (8 x 8)
a2A4096-9gcPRO 64 (8 x 8)
a2A4096-9gmBAS 64 (8 x 8)
a2A4096-9gmPRO 64 (8 x 8)
a2A4096-30ucBAS 64 (8 x 8)
a2A4096-30ucPRO 64 (8 x 8)
a2A4096-30umBAS 64 (8 x 8)
a2A4096-30umPRO 64 (8 x 8)
a2A4096-44g5cBAS 64 (8 x 8)
a2A4096-44g5mBAS 64 (8 x 8)
a2A4200-12gcBAS 16 (16 x 1)a)
a2A4200-12gcPRO 16 (16 x 1)a
a2A4200-12gmBAS 16 (16 x 1)a
a2A4200-12gmPRO 16 (16 x 1)a
a2A4200-40ucBAS 16 (16 x 1)a
a2A4200-40ucPRO 16 (16 x 1)a
a2A4200-40umBAS 16 (16 x 1)a
a2A4200-40umPRO 16 (16 x 1)a
a2A4504-5gcBAS 64 (8 x 8)
a2A4504-5gcPRO 64 (8 x 8)
a2A4504-5gmBAS 64 (8 x 8)
a2A4504-5gmPRO 64 (8 x 8)
a2A4504-18ucBAS 64 (8 x 8)
a2A4504-18ucPRO 64 (8 x 8)
a2A4504-18umBAS 64 (8 x 8)
a2A4504-18umPRO 64 (8 x 8)
a2A4504-27g5cBAS 64 (8 x 8)
a2A4504-27g5mBAS 64 (8 x 8)
a2A4508-6gcBAS 16 (16 x 1)a
a2A4508-6gcPRO 16 (16 x 1)a
a2A4508-6gmBAS 16 (16 x 1)a
a2A4508-6gmPRO 16 (16 x 1)a
a2A4508-20ucBAS 16 (16 x 1)a
a2A4508-20ucPRO 16 (16 x 1)a
a2A4508-20umBAS 16 (16 x 1)a
a2A4508-20umPRO 16 (16 x 1)a
a2A5320-7gcBAS 64 (8 x 8)
a2A5320-7gcPRO 64 (8 x 8)
a2A5320-7gmBAS 64 (8 x 8)
a2A5320-7gmPRO 64 (8 x 8)
a2A5320-23ucBAS 64 (8 x 8)
a2A5320-23ucPRO 64 (8 x 8)
a2A5320-23umBAS 64 (8 x 8)
a2A5320-23umPRO 64 (8 x 8)
a2A5320-34g5cBAS 64 (8 x 8)
a2A5320-34g5mBAS 64 (8 x 8)
a2A5328-4gcBAS 64 (8 x 8)
a2A5328-4gcPRO 64 (8 x 8)
a2A5328-4gmBAS 64 (8 x 8)
a2A5328-4gmPRO 64 (8 x 8)
a2A5328-15ucBAS 64 (8 x 8)
a2A5328-15ucPRO 64 (8 x 8)
a2A5328-15umBAS 64 (8 x 8)
a2A5328-15umPRO 64 (8 x 8)
a2A5328-22g5cBAS 64 (8 x 8)
a2A5328-22g5mBAS 64 (8 x 8)
acA640-121gm 不支持 Multiple ROI 功能
acA640-300gc 不支持 Multiple ROI 功能
acA640-300gm 不支持 Multiple ROI 功能
acA640-750uc 不支持 Multiple ROI 功能
acA640-750um 不支持 Multiple ROI 功能
acA720-290gc 不支持 Multiple ROI 功能
acA720-290gm 不支持 Multiple ROI 功能
acA720-520uc 不支持 Multiple ROI 功能
acA720-520um 不支持 Multiple ROI 功能
acA800-200gc 不支持 Multiple ROI 功能
acA800-200gm 不支持 Multiple ROI 功能
acA800-510uc 不支持 Multiple ROI 功能
acA800-510um 不支持 Multiple ROI 功能
acA1280-60gc 不支持 Multiple ROI 功能
acA1280-60gm 不支持 Multiple ROI 功能
acA1300-60gc 不支持 Multiple ROI 功能
acA1300-60gm 不支持 Multiple ROI 功能
acA1300-60gmNIR 不支持 Multiple ROI 功能
acA1300-75gc 不支持 Multiple ROI 功能
acA1300-75gm 不支持 Multiple ROI 功能
acA1300-200uc 不支持 Multiple ROI 功能
acA1300-200um 不支持 Multiple ROI 功能
acA1440-73gc 不支持 Multiple ROI 功能
acA1440-73gm 不支持 Multiple ROI 功能
acA1440-220uc 不支持 Multiple ROI 功能
acA1440-220um 不支持 Multiple ROI 功能
acA1600-20gc 不支持 Multiple ROI 功能
acA1600-20uc 不支持 Multiple ROI 功能
acA1600-60gc 不支持 Multiple ROI 功能
acA1600-60gm 不支持 Multiple ROI 功能
acA1920-25gc 不支持 Multiple ROI 功能
acA1920-25gm 不支持 Multiple ROI 功能
acA1920-25uc 不支持 Multiple ROI 功能
acA1920-25um 不支持 Multiple ROI 功能
acA1920-40gc 不支持 Multiple ROI 功能
acA1920-40gm 不支持 Multiple ROI 功能
acA1920-40uc 不支持 Multiple ROI 功能
acA1920-40ucMED 不支持 Multiple ROI 功能
acA1920-40um 不支持 Multiple ROI 功能
acA1920-40umMED 不支持 Multiple ROI 功能
acA1920-48gc 不支持 Multiple ROI 功能
acA1920-48gm 不支持 Multiple ROI 功能
acA1920-50gc 不支持 Multiple ROI 功能
acA1920-50gm 不支持 Multiple ROI 功能
acA1920-150uc 不支持 Multiple ROI 功能
acA1920-150um 不支持 Multiple ROI 功能
acA1920-155uc 不支持 Multiple ROI 功能
acA1920-155ucMED 不支持 Multiple ROI 功能
acA1920-155um 不支持 Multiple ROI 功能
acA1920-155umMED 不支持 Multiple ROI 功能
acA2000-50gc 不支持 Multiple ROI 功能
acA2000-50gm 不支持 Multiple ROI 功能
acA2000-165uc 不支持 Multiple ROI 功能
acA2000-165um 不支持 Multiple ROI 功能
acA2040-25gc 不支持 Multiple ROI 功能
acA2040-25gm 不支持 Multiple ROI 功能
acA2040-25gmNIR 不支持 Multiple ROI 功能
acA2040-35gc 不支持 Multiple ROI 功能
acA2040-35gm 不支持 Multiple ROI 功能
acA2040-55uc 不支持 Multiple ROI 功能
acA2040-55um 不支持 Multiple ROI 功能
acA2040-90uc 不支持 Multiple ROI 功能
acA2040-90um 不支持 Multiple ROI 功能
acA2040-90umNIR 不支持 Multiple ROI 功能
acA2040-120uc 不支持 Multiple ROI 功能
acA2040-120um 不支持 Multiple ROI 功能
acA2440-20gc 不支持 Multiple ROI 功能
acA2440-20gm 不支持 Multiple ROI 功能
acA2440-35uc 不支持 Multiple ROI 功能
acA2440-35ucMED 不支持 Multiple ROI 功能
acA2440-35um 不支持 Multiple ROI 功能
acA2440-35umMED 不支持 Multiple ROI 功能
acA2440-75uc 不支持 Multiple ROI 功能
acA2440-75ucMED 不支持 Multiple ROI 功能
acA2440-75um 不支持 Multiple ROI 功能
acA2440-75umMED 不支持 Multiple ROI 功能
acA2500-14gc 不支持 Multiple ROI 功能
acA2500-14gm 不支持 Multiple ROI 功能
acA2500-14uc 不支持 Multiple ROI 功能
acA2500-14um 不支持 Multiple ROI 功能
acA2500-20gc 不支持 Multiple ROI 功能
acA2500-20gcMED 不支持 Multiple ROI 功能
acA2500-20gm 不支持 Multiple ROI 功能
acA2500-20gmMED 不支持 Multiple ROI 功能
acA2500-60uc 不支持 Multiple ROI 功能
acA2500-60um 不支持 Multiple ROI 功能
acA3088-16gc 不支持 Multiple ROI 功能
acA3088-16gm 不支持 Multiple ROI 功能
acA3088-57uc 不支持 Multiple ROI 功能
acA3088-57ucMED 不支持 Multiple ROI 功能
acA3088-57um 不支持 Multiple ROI 功能
acA3088-57umMED 不支持 Multiple ROI 功能
acA3800-10gc 不支持 Multiple ROI 功能
acA3800-10gm 不支持 Multiple ROI 功能
acA3800-14uc 不支持 Multiple ROI 功能
acA3800-14um 不支持 Multiple ROI 功能
acA4024-8gc 不支持 Multiple ROI 功能
acA4024-8gm 不支持 Multiple ROI 功能
acA4024-29uc 不支持 Multiple ROI 功能
acA4024-29um 不支持 Multiple ROI 功能
acA4096-11gc 不支持 Multiple ROI 功能
acA4096-11gm 不支持 Multiple ROI 功能
acA4096-30uc 不支持 Multiple ROI 功能
acA4096-30ucMED 不支持 Multiple ROI 功能
acA4096-30um 不支持 Multiple ROI 功能
acA4096-30umMED 不支持 Multiple ROI 功能
acA4096-40uc 不支持 Multiple ROI 功能
acA4096-40ucMED 不支持 Multiple ROI 功能
acA4096-40um 不支持 Multiple ROI 功能
acA4096-40umMED 不支持 Multiple ROI 功能
acA4112-8gc 不支持 Multiple ROI 功能
acA4112-8gm 不支持 Multiple ROI 功能
acA4112-20uc 不支持 Multiple ROI 功能
acA4112-20ucMED 不支持 Multiple ROI 功能
acA4112-20um 不支持 Multiple ROI 功能
acA4112-20umMED 不支持 Multiple ROI 功能
acA4112-30uc 不支持 Multiple ROI 功能
acA4112-30ucMED 不支持 Multiple ROI 功能
acA4112-30um 不支持 Multiple ROI 功能
acA4112-30umMED 不支持 Multiple ROI 功能
acA5472-5gc 不支持 Multiple ROI 功能
acA5472-5gm 不支持 Multiple ROI 功能
acA5472-17uc 不支持 Multiple ROI 功能
acA5472-17ucMED 不支持 Multiple ROI 功能
acA5472-17um 不支持 Multiple ROI 功能
acA5472-17umMED 不支持 Multiple ROI 功能
boA1936-400cc 64 (8 x 8)
boA1936-400cm 64 (8 x 8)
boA2448-250cc 64 (8 x 8)
bo2448-250cm 64 (8 x 8)
boA2832-190cc 64 (8 x 8)
bo2832-190cm 64 (8 x 8)
boA4096-93cc 64 (8 x 8)
boA4096-93cm 64 (8 x 8)
boA4096-180cc 64 (8 x 8)
bo4096-180cm 64 (8 x 8)
boA4112-68cc 64 (8 x 8)
boA4112-68cm 64 (8 x 8)
boA4500-45cc 8 (8 x 1)a
boA4500-45cm 8 (8 x 1)a
boA4504-100cc 8
boA4504-100cm 8
boA5120-150cc 不支持 Multiple ROI 功能
boA5120-150cm 不支持 Multiple ROI 功能
boA5120-230cc 不支持 Multiple ROI 功能
boA5120-230cm 不支持 Multiple ROI 功能
boA5320-150cc 8
boA5320-150cm 8
boA5328-100cc 8
boA5328-100cm 8
boA6500-36cc 8 (8 x 1)a
boA6500-36cm 8 (8 x 1)a
boA8100-16cc 8 (8 x 1)a
boA8100-16cm 8 (8 x 1)a
boA9344-30cc 不支持 Multiple ROI 功能
boA9344-30cm 不支持 Multiple ROI 功能
boA9344-70cc 不支持 Multiple ROI 功能
boA9344-70cm 不支持 Multiple ROI 功能
boA13440-17cm 不支持 Multiple ROI 功能
daA720-520uc 不支持 Multiple ROI 功能
daA720-520um 不支持 Multiple ROI 功能
daA1280-54uc 不支持 Multiple ROI 功能
daA1280-54um 不支持 Multiple ROI 功能
daA1440-220uc 不支持 Multiple ROI 功能
daA1440-220um 不支持 Multiple ROI 功能
daA1600-60uc 不支持 Multiple ROI 功能
daA1600-60um 不支持 Multiple ROI 功能
daA1920-15um 不支持 Multiple ROI 功能
daA1920-30uc 不支持 Multiple ROI 功能
daA1920-30um 不支持 Multiple ROI 功能
daA1920-160uc 不支持 Multiple ROI 功能
daA1920-160um 不支持 Multiple ROI 功能
daA2448-70uc 不支持 Multiple ROI 功能
daA2448-70um 不支持 Multiple ROI 功能
daA2500-14uc 不支持 Multiple ROI 功能
daA2500-14um 不支持 Multiple ROI 功能
daA3840-45uc 不支持 Multiple ROI 功能
daA3840-45um 不支持 Multiple ROI 功能
puA1280-54uc 不支持 Multiple ROI 功能
puA1280-54um 不支持 Multiple ROI 功能
puA1600-60uc 不支持 Multiple ROI 功能
puA1600-60um 不支持 Multiple ROI 功能
puA1920-30uc 不支持 Multiple ROI 功能
puA1920-30um 不支持 Multiple ROI 功能
puA2500-14uc 不支持 Multiple ROI 功能
puA2500-14um 不支持 Multiple ROI 功能

  1. Only rows can be defined.

示例代码#

// ** 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 轻松设置参数。