Skip to content

Auto Function ROI#

The Auto Function ROI camera feature allows you to specify the part of the sensor array with which you want to control the camera's auto functions.

ROI is short for region of interest (formerly AOI = area of interest).

You can create several auto function ROIs, each occupying different parts of the sensor array.

The settings for the Auto Function ROI feature are independent of the settings for the Image ROI feature.

Using the Feature#

Changing Position and Size of an Auto Function ROI#

By default, all auto function ROIs are set to the same size as the camera's image ROI. You can change their positions and sizes to suit your needs.

To change the position and size of an auto function ROI:

  1. Set the AutoFunctionROISelector parameter to one of the available auto function ROIs, e.g., ROI1.
  2. Enter values for the following parameters to specify the position of the auto function ROI selected:
    • AutoFunctionROIOffsetX
    • AutoFunctionROIOffsetY
  3. Enter values for the following parameters to specify the size of the auto function ROI selected:
    • AutoFunctionROIWidth
    • AutoFunctionROIHeight

The position of an auto function ROI is specified based on the lines and rows of the sensor array.

Example: Assume that you have selected auto function ROI 1 and specified the following settings:

  • AutoFunctionROIOffsetX = 14
  • AutoFunctionROIOffsetY = 7
  • AutoFunctionROIWidth = 5
  • AutoFunctionROIHeight = 6

This creates the following auto function ROI 1:

Auto Function ROI and Image ROI

Only the pixel data from the area of overlap between the auto function ROI and the image ROI will be used by the auto function assigned to it.

Info

  • On color cameras, Basler recommends setting the parameters for position and size to even values (multiples of 2). This matches the auto function ROI to the color filter pattern of the sensor.
  • If the Binning feature is enabled, the auto function ROI settings refer to the binned lines and columns and not to the physical lines in the sensor.
  • If the Reverse X or Reverse Y feature or both are enabled, the position of the auto function ROI relative to the sensor remains the same. As a consequence, different regions of the image will be controlled depending on whether or not Reverse X, Reverse Y or both are enabled.

Auto Function ROI Highlighting#

If highlighting is supported by your camera model, you can highlight one or multiple Auto Function ROIs in the pylon Viewer. Areas that don't belong to the Auto Function ROIs appear darker:

Sample Image: Auto Function ROI Highlighting

To highlight an Auto Function ROI:

  1. Set the AutoFunctionROISelector parameter to the desired auto function ROI, e.g., ROI1.
  2. Set the AutoFunctionROIHighlight parameter to true.

Assigning Auto Functions#

By default, each auto function ROI is assigned to a specific auto function. For example, the pixel data from auto function ROI 2 is used to control the Balance White Auto auto function.

On some camera models, the default assignments can be changed. To do so:

Set the AutoFunctionROISelector parameter to one of the available auto function ROIs, e.g., ROI1.

Assign the desired auto function(s) to the auto function ROI selected:

  • If you want to assign Balance White Auto, set the AutoFunctionROIUseWhiteBalance parameter to true.
  • If you want to assign Exposure Auto and gain auto, set the AutoFunctionROIUseBrightness parameter to true. (Exposure Auto and Gain Auto always work together.)
  • If you want to assign Tonal Range Auto, set the AutoFunctionROIUseTonalRange parameter to true.

Info

  • If you assign one auto function to multiple auto function ROIs, the pixel data from all selected auto function ROIs will be used for the auto function.
  • If you assign multiple auto functions to one auto function ROI, the pixel data from the auto function ROI will be used for all auto functions selected.

Exposure Auto and Gain Auto Assignments Work Together#

When making auto function ROI assignments, the Gain Auto auto function and the exposure auto auto function always work together. they are considered as a single auto function named "intensity" or "brightness", depending on your camera model.

This does not imply, however, that Gain Auto and Exposure Auto must always be enabled at the same time.

Guidelines#

When you are setting an auto function ROI, you must follow these guidelines:

Guideline Example
AutoFunctionROIOffsetX + AutoFunctionROIWidth ≤ Width of camera sensor Camera with a 1920 x 1080 pixel sensor:
AutoFunctionROIOffsetX + AutoFunctionROIWidth ≤ 1920
AutoFunctionROIOffsetY + AutoFunctionROIHeight ≤ Height of camera sensor Camera with a 1920 x 1080 pixel sensor:
AutoFunctionROIOffsetY + AutoFunctionROIHeight ≤ 1080

Overlap Between Auto Function ROI and Image ROI#

The size and position of an auto function ROI can be identical to the size and position of the image ROI, but this is not a requirement. For an auto function to work, it is sufficient if both ROIs overlap each other partially.

The overlap between auto function ROI and image ROI determines whether and to what extent the auto function will control the related image property. Only the pixel data from the areas of overlap will be used by the auto function to control the image property of the entire image.

  • If the auto function ROI is completely contained in the image ROI, the pixel data from the auto function ROI will be used to control the image property.

    Auto Function ROI Completely Included in Image ROI

  • If the image ROI is completely contained in the auto function ROI, only the pixel data from the image ROI will be used to control the image property.

    Image ROI Completely Included in Auto Function ROI

  • If the auto function ROI overlaps the image ROI only partially, only the pixel data from the area of partial overlap will be used to control the image property.

    Auto Function ROI Partially Overlaps Image ROI

  • If the auto function ROI does not overlap the image ROI, the related auto function will not work.

    Auto Function ROI Does Not Overlap Image ROI

Info

Basler strongly recommends completely including the auto function ROI within the image ROI or choosing identical positions and sizes for auto function ROI and image ROI.

Specifics#

Show all camera models

Camera Model Auto Function ROIs Default Assignments Assignments Can Be Changed Highlighting Supported
a2A1920-51gcBAS ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes Yes
a2A1920-51gcPRO ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes Yes
a2A1920-51gmBAS ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: Brightness (Gain Auto + Exposure Auto)
Yes Yes
a2A1920-51gmPRO ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: Brightness (Gain Auto + Exposure Auto)
Yes Yes
a2A1920-160ucBAS ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes Yes
a2A1920-160ucPRO ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes Yes
a2A1920-160umBAS ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: Brightness (Gain Auto + Exposure Auto)
Yes Yes
a2A1920-160umPRO ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: Brightness (Gain Auto + Exposure Auto)
Yes Yes
a2A2590-22gcBAS ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes Yes
a2A2590-22gcPRO ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes Yes
a2A2590-22gmBAS ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: Brightness (Gain Auto + Exposure Auto)
Yes Yes
a2A2590-22gmPRO ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: Brightness (Gain Auto + Exposure Auto)
Yes Yes
a2A2590-60ucBAS ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes Yes
a2A2590-60ucPRO ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes Yes
a2A2590-60umBAS ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: Brightness (Gain Auto + Exposure Auto)
Yes Yes
a2A2590-60umPRO ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: Brightness (Gain Auto + Exposure Auto)
Yes Yes
a2A3840-13gcBAS ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes Yes
a2A3840-13gcPRO ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes Yes
a2A3840-13gmBAS ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: Brightness (Gain Auto + Exposure Auto)
Yes Yes
a2A3840-13gmPRO ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: Brightness (Gain Auto + Exposure Auto)
Yes Yes
a2A3840-45ucBAS ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes Yes
a2A3840-45ucPRO ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes Yes
a2A3840-45umBAS ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: Brightness (Gain Auto + Exposure Auto)
Yes Yes
a2A3840-45umPRO ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: Brightness (Gain Auto + Exposure Auto)
Yes Yes
acA640-90gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA640-90gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA640-90uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA640-90um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA640-120gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA640-120gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA640-120uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA640-120um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA640-121gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA640-300gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA640-300gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA640-750uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA640-750um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA720-290gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA720-290gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA720-520uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA720-520um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA780-75gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA780-75gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA800-200gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA800-200gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA800-510uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA800-510um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA1280-60gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1280-60gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1300-22gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1300-22gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1300-30gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1300-30gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1300-30uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA1300-30um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA1300-60gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1300-60gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1300-60gmNIR ROI 1
ROI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1300-75gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1300-75gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1300-200uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA1300-200um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA1440-73gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1440-73gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1440-220uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA1440-220um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA1600-20gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1600-20gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1600-20uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA1600-20um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA1600-60gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1600-60gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1920-25gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1920-25gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1920-25uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA1920-25um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA1920-40gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1920-40gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1920-40uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA1920-40ucMED ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto), Tonal Range (Tonal Range Auto)
Yes No
acA1920-40um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA1920-40umMED ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto), Tonal Range (Tonal Range Auto)
Yes No
acA1920-48gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1920-48gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1920-50gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1920-50gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA1920-150uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA1920-150um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA1920-155uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA1920-155ucMED ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto), Tonal Range (Tonal Range Auto)
Yes No
acA1920-155um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA1920-155umMED ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto), Tonal Range (Tonal Range Auto)
Yes No
acA2000-50gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA2000-50gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA2000-50gmNIR ROI 1
ROI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA2000-165uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA2000-165um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA2000-165umNIR ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA2040-25gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA2040-25gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA2040-25gmNIR ROI 1
ROI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA2040-35gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA2040-35gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA2040-55uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA2040-55um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA2040-90uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA2040-90um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA2040-90umNIR ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA2040-120uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA2040-120um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA2440-20gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA2440-20gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA2440-35uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA2440-35ucMED ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto), Tonal Range (Tonal Range Auto)
Yes No
acA2440-35um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA2440-35umMED ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto), Tonal Range (Tonal Range Auto)
Yes No
acA2440-75uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA2440-75ucMED ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto), Tonal Range (Tonal Range Auto)
Yes No
acA2440-75um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA2440-75umMED ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto), Tonal Range (Tonal Range Auto)
Yes No
acA2500-14gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA2500-14gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA2500-14uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA2500-14um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA2500-20gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA2500-20gcMED AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto), Tonal Range (Tonal Range Auto)
Yes No
acA2500-20gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA2500-20gmMED AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto), Tonal Range (Tonal Range Auto)
Yes No
acA2500-60uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA2500-60um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA3088-16gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA3088-16gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA3088-57uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA3088-57um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA3800-10gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA3800-10gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA3800-14uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA3800-14um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA4024-8gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA4024-8gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA4024-29uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA4024-29um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA4096-11gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA4096-11gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA4096-30uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA4096-30ucMED ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto), Tonal Range (Tonal Range Auto)
Yes No
acA4096-30um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA4096-30umMED ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto), Tonal Range (Tonal Range Auto)
Yes No
acA4096-40uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA4096-40ucMED ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto), Tonal Range (Tonal Range Auto)
Yes No
acA4096-40um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA4096-40umMED ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto), Tonal Range (Tonal Range Auto)
Yes No
acA4112-8gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA4112-8gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA4112-20uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA4112-20ucMED ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto), Tonal Range (Tonal Range Auto)
Yes No
acA4112-20um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA4112-20umMED ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto), Tonal Range (Tonal Range Auto)
Yes No
acA4112-30uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA4112-30ucMED ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto), Tonal Range (Tonal Range Auto)
Yes No
acA4112-30um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA4112-30umMED ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto), Tonal Range (Tonal Range Auto)
Yes No
acA4600-7gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA4600-10uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA5472-5gc AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA5472-5gm AOI 1
AOI 2
AOI 1: Intensity (Gain Auto + Exposure Auto)
AOI 2: White Balance (Balance White Auto)
Yes No
acA5472-17uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
acA5472-17ucMED ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto), Tonal Range (Tonal Range Auto)
Yes No
acA5472-17um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes No
boA4096-93cc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes Yes
boA4096-93cm ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: Brightness (Gain Auto + Exposure Auto)
Yes Yes
boA4112-68cc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
Yes Yes
boA4112-68cm ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: Brightness (Gain Auto + Exposure Auto)
Yes Yes
daA1280-54lc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
daA1280-54lm ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
daA1280-54uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
daA1280-54um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
daA1600-60lc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
daA1600-60lm ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
daA1600-60uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
daA1600-60um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
daA1920-15um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
daA1920-30uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
daA1920-30um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
daA2500-14lc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
daA2500-14lm ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
daA2500-14uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
daA2500-14um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
daA2500-60mc Auto Function ROI feature not supported Auto Function ROI feature not supported No No
daA2500-60mci Auto Function ROI feature not supported Auto Function ROI feature not supported No No
daA4200-30mci Auto Function ROI feature not supported Auto Function ROI feature not supported No No
puA1280-54uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
puA1280-54um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
puA1600-60uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
puA1600-60um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
puA1920-30uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
puA1920-30um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
puA2500-14uc ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No
puA2500-14um ROI 1
ROI 2
ROI 1: Brightness (Gain Auto + Exposure Auto)
ROI 2: White Balance (Balance White Auto)
No No

Sample Code#

ace 2 and boost Cameras#

// Select auto function ROI 1
camera.AutoFunctionROISelector.SetValue(AutoFunctionROISelector_ROI1);
// Specify position and size of the auto function ROI selected
camera.AutoFunctionROIOffsetX.SetValue(10);
camera.AutoFunctionROIOffsetY.SetValue(10);
camera.AutoFunctionROIWidth.SetValue(500);
camera.AutoFunctionROIHeight.SetValue(400);
// Enable Balance White Auto for the auto function ROI selected
camera.AutoFunctionROIUseWhiteBalance.SetValue(true);
// Enable the 'Brightness' auto function (Gain Auto + Exposure Auto)
// for the auto function ROI selected
camera.AutoFunctionROIUseBrightness.SetValue(true);
// Highlight the auto function ROI selected
camera.AutoFunctionROIHighlight.SetValue(true);
INodeMap& nodemap = camera.GetNodeMap();
// Select auto function ROI 1
CEnumerationPtr(nodemap.GetNode("AutoFunctionROISelector"))->FromString("ROI1");
// Specify position and size of the auto function ROI selected
CIntegerPtr(nodemap.GetNode("AutoFunctionROIOffsetX"))->SetValue(10);
CIntegerPtr(nodemap.GetNode("AutoFunctionROIOffsetY"))->SetValue(10);
CIntegerPtr(nodemap.GetNode("AutoFunctionROIWidth"))->SetValue(500);
CIntegerPtr(nodemap.GetNode("AutoFunctionROIHeight"))->SetValue(400);
// Enable Balance White Auto for the auto function ROI selected
CBooleanPtr(nodemap.GetNode("AutoFunctionROIUseWhiteBalance"))->SetValue(true);
// Enable the 'Brightness' auto function (Gain Auto + Exposure Auto)
// for the auto function ROI selected
CBooleanPtr(nodemap.GetNode("AutoFunctionROIUseBrightness"))->SetValue(true);
// Highlight the auto function ROI selected
CBooleanPtr(nodemap.GetNode("AutoFunctionROIHighlight"))->SetValue(true);
INodeMap& nodemap = camera.GetNodeMap();
// Select auto function ROI 1
CEnumParameter(nodemap, "AutoFunctionROISelector").SetValue("ROI1");
// Specify position and size of the auto function ROI selected
CIntegerParameter(nodemap, "AutoFunctionROIOffsetX").SetValue(10);
CIntegerParameter(nodemap, "AutoFunctionROIOffsetY").SetValue(10);
CIntegerParameter(nodemap, "AutoFunctionROIWidth").SetValue(500);
CIntegerParameter(nodemap, "AutoFunctionROIHeight").SetValue(400);
// Enable Balance White Auto for the auto function ROI selected
CBooleanParameter(nodemap, "AutoFunctionROIUseWhiteBalance").SetValue(true);
// Enable the 'Brightness' auto function (Gain Auto + Exposure Auto)
// for the auto function ROI selected
CBooleanParameter(nodemap, "AutoFunctionROIUseBrightness").SetValue(true);
// Highlight the auto function ROI selected
CBooleanParameter(nodemap, "AutoFunctionROIHighlight").SetValue(true);
// Select auto function ROI 1
camera.Parameters[PLCamera.AutoFunctionROISelector].SetValue(PLCamera.AutoFunctionROISelector.ROI1);
// Specify position and size of the auto function ROI selected
camera.Parameters[PLCamera.AutoFunctionROIOffsetX].SetValue(10);
camera.Parameters[PLCamera.AutoFunctionROIOffsetY].SetValue(10);
camera.Parameters[PLCamera.AutoFunctionROIWidth].SetValue(500);
camera.Parameters[PLCamera.AutoFunctionROIHeight].SetValue(400);
// Enable Balance White Auto for the auto function ROI selected
camera.Parameters[PLCamera.AutoFunctionROIUseWhiteBalance].SetValue(true);
// Enable the 'Brightness' auto function (Gain Auto + Exposure Auto)
// for the auto function ROI selected
camera.Parameters[PLCamera.AutoFunctionROIUseBrightness].SetValue(true);
// Highlight the auto function ROI selected
camera.Parameters[PLCamera.AutoFunctionROIHighlight].SetValue(true);
// Select auto function ROI 1
Pylon.DeviceFeatureFromString(hdev, "AutoFunctionROISelector", "ROI1");
// Specify position and size of the auto function ROI selected
Pylon.DeviceSetIntegerFeature(hdev, "AutoFunctionROIOffsetX", 10);
Pylon.DeviceSetIntegerFeature(hdev, "AutoFunctionROIOffsetY", 10);
Pylon.DeviceSetIntegerFeature(hdev, "AutoFunctionROIWidth", 500);
Pylon.DeviceSetIntegerFeature(hdev, "AutoFunctionROIHeight", 400);
// Enable Balance White Auto for the auto function ROI selected
Pylon.DeviceSetBooleanFeature(hdev, "AutoFunctionROIUseWhiteBalance", true);
// Enable the 'Brightness' auto function (Gain Auto + Exposure Auto)
// for the auto function ROI selected
Pylon.DeviceSetBooleanFeature(hdev, "AutoFunctionROIUseBrightness", true);
// Highlight the auto function ROI selected
Pylon.DeviceSetBooleanFeature(hdev, "AutoFunctionROIHighlight", true);
/* 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 */
/* Select auto function ROI 1 */
errRes = PylonDeviceFeatureFromString(hdev, "AutoFunctionROISelector", "ROI1");
CHECK(errRes);
/* Specify position and size of the auto function ROI selected */
errRes = PylonDeviceSetIntegerFeature(hdev, "AutoFunctionROIOffsetX", 10);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "AutoFunctionROIOffsetY", 10);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "AutoFunctionROIWidth", 500);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "AutoFunctionROIHeight", 400);
CHECK(errRes);
/* Enable Balance White Auto for the auto function ROI selected */
errRes = PylonDeviceSetBooleanFeature(hdev, "AutoFunctionROIUseWhiteBalance", 1);
CHECK(errRes);
/* Enable the 'Brightness' auto function (Gain Auto + Exposure Auto) */
/* for the auto function ROI selected */
errRes = PylonDeviceSetBooleanFeature(hdev, "AutoFunctionROIUseBrightness", 1);
CHECK(errRes);
/* Highlight the auto function ROI selected */
errRes = PylonDeviceSetBooleanFeature(hdev, "AutoFunctionROIHighlight", 1);
CHECK(errRes);

ace classic/U/L GigE Cameras#

// Select auto function AOI 1
camera.AutoFunctionAOISelector.SetValue(AutoFunctionAOISelector_AOI1);
// Specify position and size of the auto function ROI selected
camera.AutoFunctionAOIOffsetX.SetValue(10);
camera.AutoFunctionAOIOffsetY.SetValue(10);
camera.AutoFunctionAOIWidth.SetValue(500);
camera.AutoFunctionAOIHeight.SetValue(400);
// Enable Balance White Auto for the auto function ROI selected
camera.AutoFunctionAOIUsageWhiteBalance.SetValue(true);
// Enable the 'Intensity' auto function (Gain Auto + Exposure Auto)
// for the auto function ROI selected
camera.AutoFunctionAOIUsageIntensity.SetValue(true);
INodeMap& nodemap = camera.GetNodeMap();
// Select auto function AOI 1
CEnumerationPtr(nodemap.GetNode("AutoFunctionAOISelector"))->FromString("AOI1");
// Specify position and size of the auto function ROI selected
CIntegerPtr(nodemap.GetNode("AutoFunctionAOIOffsetX"))->SetValue(10);
CIntegerPtr(nodemap.GetNode("AutoFunctionAOIOffsetY"))->SetValue(10);
CIntegerPtr(nodemap.GetNode("AutoFunctionAOIWidth"))->SetValue(500);
CIntegerPtr(nodemap.GetNode("AutoFunctionAOIHeight"))->SetValue(400);
// Enable Balance White Auto for the auto function ROI selected
CBooleanPtr(nodemap.GetNode("AutoFunctionAOIUsageWhiteBalance"))->SetValue(true);
// Enable the 'Intensity' auto function (Gain Auto + Exposure Auto)
// for the auto function ROI selected
CBooleanPtr(nodemap.GetNode("AutoFunctionAOIUsageIntensity"))->SetValue(true);
INodeMap& nodemap = camera.GetNodeMap();
// Select auto function AOI 1
CEnumParameter(nodemap, "AutoFunctionAOISelector").SetValue("AOI1");
// Specify position and size of the auto function ROI selected
CIntegerParameter(nodemap, "AutoFunctionAOIOffsetX").SetValue(10);
CIntegerParameter(nodemap, "AutoFunctionAOIOffsetY").SetValue(10);
CIntegerParameter(nodemap, "AutoFunctionAOIWidth").SetValue(500);
CIntegerParameter(nodemap, "AutoFunctionAOIHeight").SetValue(400);
// Enable Balance White Auto for the auto function ROI selected
CBooleanParameter(nodemap, "AutoFunctionAOIUsageWhiteBalance").SetValue(true);
// Enable the 'Intensity' auto function (Gain Auto + Exposure Auto)
// for the auto function ROI selected
CBooleanParameter(nodemap, "AutoFunctionAOIUsageIntensity").SetValue(true);
// Select auto function AOI 1
camera.Parameters[PLCamera.AutoFunctionAOISelector].SetValue(PLCamera.AutoFunctionAOISelector.AOI1);
// Specify position and size of the auto function ROI selected
camera.Parameters[PLCamera.AutoFunctionAOIOffsetX].SetValue(10);
camera.Parameters[PLCamera.AutoFunctionAOIOffsetY].SetValue(10);
camera.Parameters[PLCamera.AutoFunctionAOIWidth].SetValue(500);
camera.Parameters[PLCamera.AutoFunctionAOIHeight].SetValue(400);
// Enable Balance White Auto for the auto function ROI selected
camera.Parameters[PLCamera.AutoFunctionAOIUsageWhiteBalance].SetValue(true);
// Enable the 'Intensity' auto function (Gain Auto + Exposure Auto)
// for the auto function ROI selected
camera.Parameters[PLCamera.AutoFunctionAOIUsageIntensity].SetValue(true);
// Select auto function AOI 1
Pylon.DeviceFeatureFromString(hdev, "AutoFunctionAOISelector", "AOI1");
// Specify position and size of the auto function ROI selected
Pylon.DeviceSetIntegerFeature(hdev, "AutoFunctionAOIOffsetX", 10);
Pylon.DeviceSetIntegerFeature(hdev, "AutoFunctionAOIOffsetY", 10);
Pylon.DeviceSetIntegerFeature(hdev, "AutoFunctionAOIWidth", 500);
Pylon.DeviceSetIntegerFeature(hdev, "AutoFunctionAOIHeight", 400);
// Enable Balance White Auto for the auto function ROI selected
Pylon.DeviceSetBooleanFeature(hdev, "AutoFunctionAOIUsageWhiteBalance", true);
// Enable the 'Intensity' auto function (Gain Auto + Exposure Auto)
// for the auto function ROI selected
Pylon.DeviceSetBooleanFeature(hdev, "AutoFunctionAOIUsageIntensity", true);
/* 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 */
/* Select auto function AOI 1 */
errRes = PylonDeviceFeatureFromString(hdev, "AutoFunctionAOISelector", "AOI1");
CHECK(errRes);
/* Specify position and size of the auto function ROI selected */
errRes = PylonDeviceSetIntegerFeature(hdev, "AutoFunctionAOIOffsetX", 10);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "AutoFunctionAOIOffsetY", 10);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "AutoFunctionAOIWidth", 500);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "AutoFunctionAOIHeight", 400);
CHECK(errRes);
/* Enable Balance White Auto for the auto function ROI selected */
errRes = PylonDeviceSetBooleanFeature(hdev, "AutoFunctionAOIUsageWhiteBalance", 1);
CHECK(errRes);
/* Enable the 'Intensity' auto function (Gain Auto + Exposure Auto) */
/* for the auto function ROI selected */
errRes = PylonDeviceSetBooleanFeature(hdev, "AutoFunctionAOIUsageIntensity", 1);
CHECK(errRes);

Other Cameras#

// Select auto function ROI 1
camera.AutoFunctionROISelector.SetValue(AutoFunctionROISelector_ROI1);
// Specify position and size of the auto function ROI selected
camera.AutoFunctionROIOffsetX.SetValue(10);
camera.AutoFunctionROIOffsetY.SetValue(10);
camera.AutoFunctionROIWidth.SetValue(500);
camera.AutoFunctionROIHeight.SetValue(400);
// Enable Balance White Auto for the auto function ROI selected
camera.AutoFunctionROIUseWhiteBalance.SetValue(true);
// Enable the 'Brightness' auto function (Gain Auto + Exposure Auto)
// for the auto function ROI selected
camera.AutoFunctionROIUseBrightness.SetValue(true);
INodeMap& nodemap = camera.GetNodeMap();
// Select auto function ROI 1
CEnumerationPtr(nodemap.GetNode("AutoFunctionROISelector"))->FromString("ROI1");
// Specify position and size of the auto function ROI selected
CIntegerPtr(nodemap.GetNode("AutoFunctionROIOffsetX"))->SetValue(10);
CIntegerPtr(nodemap.GetNode("AutoFunctionROIOffsetY"))->SetValue(10);
CIntegerPtr(nodemap.GetNode("AutoFunctionROIWidth"))->SetValue(500);
CIntegerPtr(nodemap.GetNode("AutoFunctionROIHeight"))->SetValue(400);
// Enable Balance White Auto for the auto function ROI selected
CBooleanPtr(nodemap.GetNode("AutoFunctionROIUseWhiteBalance"))->SetValue(true);
// Enable the 'Brightness' auto function (Gain Auto + Exposure Auto)
// for the auto function ROI selected
CBooleanPtr(nodemap.GetNode("AutoFunctionROIUseBrightness"))->SetValue(true);
INodeMap& nodemap = camera.GetNodeMap();
// Select auto function ROI 1
CEnumParameter(nodemap, "AutoFunctionROISelector").SetValue("ROI1");
// Specify position and size of the auto function ROI selected
CIntegerParameter(nodemap, "AutoFunctionROIOffsetX").SetValue(10);
CIntegerParameter(nodemap, "AutoFunctionROIOffsetY").SetValue(10);
CIntegerParameter(nodemap, "AutoFunctionROIWidth").SetValue(500);
CIntegerParameter(nodemap, "AutoFunctionROIHeight").SetValue(400);
// Enable Balance White Auto for the auto function ROI selected
CBooleanParameter(nodemap, "AutoFunctionROIUseWhiteBalance").SetValue(true);
// Enable the 'Brightness' auto function (Gain Auto + Exposure Auto)
// for the auto function ROI selected
CBooleanParameter(nodemap, "AutoFunctionROIUseBrightness").SetValue(true);
// Select auto function ROI 1
camera.Parameters[PLCamera.AutoFunctionROISelector].SetValue(PLCamera.AutoFunctionROISelector.ROI1);
// Specify position and size of the auto function ROI selected
camera.Parameters[PLCamera.AutoFunctionROIOffsetX].SetValue(10);
camera.Parameters[PLCamera.AutoFunctionROIOffsetY].SetValue(10);
camera.Parameters[PLCamera.AutoFunctionROIWidth].SetValue(500);
camera.Parameters[PLCamera.AutoFunctionROIHeight].SetValue(400);
// Enable Balance White Auto for the auto function ROI selected
camera.Parameters[PLCamera.AutoFunctionROIUseWhiteBalance].SetValue(true);
// Enable the 'Brightness' auto function (Gain Auto + Exposure Auto)
// for the auto function ROI selected
camera.Parameters[PLCamera.AutoFunctionROIUseBrightness].SetValue(true);
// Select auto function ROI 1
Pylon.DeviceFeatureFromString(hdev, "AutoFunctionROISelector", "ROI1");
// Specify position and size of the auto function ROI selected
Pylon.DeviceSetIntegerFeature(hdev, "AutoFunctionROIOffsetX", 10);
Pylon.DeviceSetIntegerFeature(hdev, "AutoFunctionROIOffsetY", 10);
Pylon.DeviceSetIntegerFeature(hdev, "AutoFunctionROIWidth", 500);
Pylon.DeviceSetIntegerFeature(hdev, "AutoFunctionROIHeight", 400);
// Enable Balance White Auto for the auto function ROI selected
Pylon.DeviceSetBooleanFeature(hdev, "AutoFunctionROIUseWhiteBalance", true);
// Enable the 'Brightness' auto function (Gain Auto + Exposure Auto)
// for the auto function ROI selected
Pylon.DeviceSetBooleanFeature(hdev, "AutoFunctionROIUseBrightness", true);
/* 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 */
/* Select auto function ROI 1 */
errRes = PylonDeviceFeatureFromString(hdev, "AutoFunctionROISelector", "ROI1");
CHECK(errRes);
/* Specify position and size of the auto function ROI selected */
errRes = PylonDeviceSetIntegerFeature(hdev, "AutoFunctionROIOffsetX", 10);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "AutoFunctionROIOffsetY", 10);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "AutoFunctionROIWidth", 500);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "AutoFunctionROIHeight", 400);
CHECK(errRes);
/* Enable Balance White Auto for the auto function ROI selected */
errRes = PylonDeviceSetBooleanFeature(hdev, "AutoFunctionROIUseWhiteBalance", 1);
CHECK(errRes);
/* Enable the 'Brightness' auto function (Gain Auto + Exposure Auto) */
/* for the auto function ROI selected */
errRes = PylonDeviceSetBooleanFeature(hdev, "AutoFunctionROIUseBrightness", 1);
CHECK(errRes);

You can also use the pylon Viewer to easily set the parameters.