跳转到内容

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. 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 像素)时,相机才能计算有意义的颜色信息。
  • 如果将 BslMultipleROIColumnsEnable 参数设置为 true,则以下参数会变为只读:

    • OffsetX:该参数设置为第 1 列的水平偏移。
    • Width:将该参数设置为所有分区的总宽度,即,由 Multiple ROI 功能创建的图像的宽度。
  • 如果将 BslMultipleROIRowsEnable 参数设置为 true,则以下参数会变为只读:

    • OffsetY:该参数设置为第 1 行的垂直偏移。
    • Height:将该参数设置为所有分区的总高度,即,由 Multiple ROI 功能创建的图像的高度。
  • 其他影响图像尺寸的相机功能,例如,BinningPixel Beyond,是在 Multiple ROI 功能之后应用。因此,在配置行和列时,您不必考虑这些功能的影响。

  • Auto Function ROI 的位置和大小会自动适应 Multiple ROI 功能的输出。例如,如果所有组合分区的宽度均为 500,则 AutoFunctionROIWidth 参数的最大值将为 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)
a2A2048-35gmSWIR 64 (8 x 8)
a2A2048-110umSWIR 64 (8 x 8)
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)
a2A2448-120cc 64 (8 x 8)
a2A2448-120cm 64 (8 x 8)
a2A2448-210cc 64 (8 x 8)
a2A2448-210cm 64 (8 x 8)
a2A2560-20gmSWIR 64 (8 x 8)
a2A2560-70umSWIR 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-14gmUV 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-48umUV 64 (8 x 8)
a2A2840-67g5cBAS 64 (8 x 8)
a2A2840-67g5mBAS 64 (8 x 8)
a2A2840-67g5mUV 64 (8 x 8)
a2A2840-86cc 64 (8 x 8)
a2A2840-86cm 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)
a2A4096-67cc 64 (8 x 8)
a2A4096-67cm 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)
a2A4504-42cc 64 (8 x 8)
a2A4504-42cm 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)
a2A5320-52cc 64 (8 x 8)
a2A5320-52cm 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)
a2A5328-35cc 64 (8 x 8)
a2A5328-35cm 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 64 (8 x 8)
boA4504-100cm 64 (8 x 8)
boA5120-150cc 不支持 Multiple ROI 功能
boA5120-150cm 不支持 Multiple ROI 功能
boA5120-230cc 不支持 Multiple ROI 功能
boA5120-230cm 不支持 Multiple ROI 功能
boA5320-150cc 64 (8 x 8)
boA5320-150cm 64 (8 x 8)
boA5328-100cc 64 (8 x 8)
boA5328-100cm 64 (8 x 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 功能
dmA720-290gc 4 (2 x 2)
dmA720-290gm 4 (2 x 2)
dmA1440-73gc 4 (2 x 2)
dmA1440-73gm 4 (2 x 2)
dmA1920-51gc 4 (2 x 2)
dmA1920-51gm 4 (2 x 2)
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 功能
r2L2048-29gc 不支持 Multiple ROI 功能
r2L2048-58gm 不支持 Multiple ROI 功能
r2L2048-62cc 不支持 Multiple ROI 功能
r2L2048-62g5c 不支持 Multiple ROI 功能
r2L2048-172cm 不支持 Multiple ROI 功能
r2L2048-172g5m 不支持 Multiple ROI 功能
r2L4096-14gc 不支持 Multiple ROI 功能
r2L4096-29gm 不支持 Multiple ROI 功能
r2L4096-42cc 不支持 Multiple ROI 功能
r2L4096-42g5c 不支持 Multiple ROI 功能
r2L4096-84cm 不支持 Multiple ROI 功能
r2L4096-84g5m 不支持 Multiple ROI 功能
r2L8192-200cm 不支持 Multiple ROI 功能
r2L16384-120cm 不支持 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 轻松设置参数。