Stacked ROI

The Stacked ROI camera feature allows you to define multiple zones of varying heights and equal width on the sensor array that will be transmitted as a single image.

Only the pixel data from those zones will be transmitted. This increases the camera's frame rate.

The Stacked ROI feature is similar to the Stacked Zones Imaging feature, which is only available on ace classic cameras.

In this topic Hide

Using the Feature

Prerequisites

How It Works

The Stacked ROI feature allows you to define vertically aligned zones of equal width on the sensor array. The maximum number of zones depends on your camera model.

When an image is acquired, only the pixel information from within the defined zones is read out of the sensor. The pixel information is then stacked together and transmitted as a single image.

ROI Zones Example

The zones always have the same width and are vertically aligned. To configure the zones, Basler recommends the following procedure:

  1. Define a width and a horizontal offset that is valid for all zones.
  2. Define the heights and vertical offsets of the individual zones.

Configuring the ROI Zones

  1. Set the OffsetX parameter to the desired horizontal offset. The value is applied to all zones.
  2. Set the Width parameter to the desired zone width. The value is applied to all zones.
  3. Set the ROIZoneSelector parameter to the zone that you want to configure, e.g., Zone0.
  4. Set the ROIZoneOffset parameter to the desired vertical offset. The value is applied to the zone selected in step 4.
  5. Set the ROIZoneSize parameter to the desired zone height. The value is applied to the zone selected in step 4.
  6. Set the ROIZoneMode parameter to On to enable the zone.
  7. Repeat steps 3 to 6 for every zone you want to configure.

Considerations When Using the Stacked ROI Feature

Specifics

Camera Model Maximum Number of ROI Zones
a2A1920-51gmBAS Stacked ROI feature not supported
a2A1920-51gcBAS Stacked ROI feature not supported
a2A1920-160umBAS Stacked ROI feature not supported
a2A1920-160ucBAS Stacked ROI feature not supported
acA640-90gm Stacked ROI feature not supported
acA640-90gc Stacked ROI feature not supported
acA640-120gm Stacked ROI feature not supported
acA640-120gc Stacked ROI feature not supported
acA640-121gm Stacked ROI feature not supported
acA640-300gm 8
acA640-300gc 8
acA720-290gm Stacked ROI feature not supported
acA720-290gc Stacked ROI feature not supported
acA780-75gm Stacked ROI feature not supported
acA780-75gc Stacked ROI feature not supported
acA800-200gm 8
acA800-200gc 8
acA1280-60gm Stacked ROI feature not supported
acA1280-60gc Stacked ROI feature not supported
acA1300-22gm Stacked ROI feature not supported
acA1300-22gc Stacked ROI feature not supported
acA1300-30gm Stacked ROI feature not supported
acA1300-30gc Stacked ROI feature not supported
acA1300-60gm Stacked ROI feature not supported
acA1300-60gmNIR Stacked ROI feature not supported
acA1300-60gc Stacked ROI feature not supported
acA1300-75gm 8
acA1300-75gc 8
acA1440-73gm 2
acA1440-73gc 2
acA1600-20gm Stacked ROI feature not supported
acA1600-20gc Stacked ROI feature not supported
acA1600-60gm Stacked ROI feature not supported
acA1600-60gc Stacked ROI feature not supported
acA1920-25gm Stacked ROI feature not supported
acA1920-25gc Stacked ROI feature not supported
acA1920-40gm Stacked ROI feature not supported
acA1920-40gc Stacked ROI feature not supported
acA1920-48gm 8
acA1920-48gc 8
acA1920-50gm 4
acA1920-50gc 4
acA2000-50gm Stacked ROI feature not supported
acA2000-50gmNIR Stacked ROI feature not supported
acA2000-50gc Stacked ROI feature not supported
acA2040-25gm Stacked ROI feature not supported
acA2040-25gmNIR Stacked ROI feature not supported
acA2040-25gc Stacked ROI feature not supported
acA2040-35gm Stacked ROI feature not supported
acA2040-35gc Stacked ROI feature not supported
acA2440-20gm Stacked ROI feature not supported
acA2440-20gc Stacked ROI feature not supported
acA2500-14gm Stacked ROI feature not supported
acA2500-14gc Stacked ROI feature not supported
acA2500-20gm 8
acA2500-20gc 8
acA2500-20gmMED 8
acA2500-20gcMED 8
acA3088-16gm Stacked ROI feature not supported
acA3088-16gc Stacked ROI feature not supported
acA3800-10gm Stacked ROI feature not supported
acA3800-10gc Stacked ROI feature not supported
acA4024-8gm Stacked ROI feature not supported
acA4024-8gc Stacked ROI feature not supported
acA4096-11gm Stacked ROI feature not supported
acA4096-11gc Stacked ROI feature not supported
acA4112-8gm Stacked ROI feature not supported
acA4112-8gc Stacked ROI feature not supported
acA4600-7gc Stacked ROI feature not supported
acA5472-5gm Stacked ROI feature not supported
acA5472-5gc Stacked ROI feature not supported
acA640-750um 8
acA640-750uc 8
acA640-90um Stacked ROI feature not supported
acA640-90uc Stacked ROI feature not supported
acA640-120um Stacked ROI feature not supported
acA640-120uc Stacked ROI feature not supported
acA720-520um Stacked ROI feature not supported
acA720-520uc Stacked ROI feature not supported
acA800-510um 8
acA800-510uc 8
acA1300-200um 8
acA1300-200uc 8
acA1300-30um Stacked ROI feature not supported
acA1300-30uc Stacked ROI feature not supported
acA1440-220um 2
acA1440-220uc 2
acA1600-20um Stacked ROI feature not supported
acA1600-20uc Stacked ROI feature not supported
acA1920-25um Stacked ROI feature not supported
acA1920-25uc Stacked ROI feature not supported
acA1920-40um Stacked ROI feature not supported
acA1920-40uc Stacked ROI feature not supported
acA1920-40umMED Stacked ROI feature not supported
acA1920-40ucMED Stacked ROI feature not supported
acA1920-150um 8
acA1920-150uc 8
acA1920-155um 4
acA1920-155uc 4
acA1920-155umMED 4
acA1920-155ucMED 4
acA2040-90um Stacked ROI feature not supported
acA2040-90umNIR Stacked ROI feature not supported
acA2040-90uc Stacked ROI feature not supported
acA2000-165um Stacked ROI feature not supported
acA2000-165umNIR Stacked ROI feature not supported
acA2000-165uc Stacked ROI feature not supported
acA2040-55um Stacked ROI feature not supported
acA2040-55uc Stacked ROI feature not supported
acA2040-120um 8
acA2040-120uc 8
acA2440-35um Stacked ROI feature not supported
acA2440-35uc Stacked ROI feature not supported
acA2440-35umMED Stacked ROI feature not supported
acA2440-35ucMED Stacked ROI feature not supported
acA2440-75um 8
acA2440-75uc 8
acA2440-75umMED 8
acA2440-75ucMED 8
acA2500-14um Stacked ROI feature not supported
acA2500-14uc Stacked ROI feature not supported
acA2500-60um 8
acA2500-60uc 8
acA3088-57um Stacked ROI feature not supported
acA3088-57uc Stacked ROI feature not supported
acA3800-14um Stacked ROI feature not supported
acA3800-14uc Stacked ROI feature not supported
acA4024-29um Stacked ROI feature not supported
acA4024-29uc Stacked ROI feature not supported
acA4096-30um Stacked ROI feature not supported
acA4096-30uc Stacked ROI feature not supported
acA4096-30umMED Stacked ROI feature not supported
acA4096-30ucMED Stacked ROI feature not supported
acA4096-40um 8
acA4096-40uc 8
acA4096-40umMED 8
acA4096-40ucMED 8
acA4112-20um Stacked ROI feature not supported
acA4112-20uc Stacked ROI feature not supported
acA4112-20umMED Stacked ROI feature not supported
acA4112-20ucMED Stacked ROI feature not supported
acA4112-30um 8
acA4112-30uc 8
acA4112-30umMED 8
acA4112-30ucMED 8
acA4600-10uc Stacked ROI feature not supported
acA5472-17um Stacked ROI feature not supported
acA5472-17uc Stacked ROI feature not supported
boA4096-93cm Stacked ROI feature not supported
boA4096-93cc Stacked ROI feature not supported
boA4112-68cm Stacked ROI feature not supported
boA4112-68cc Stacked ROI feature not supported
All dart BCON for LVDS camera models Stacked ROI feature not supported
All dart BCON for MIPI camera models Stacked ROI feature not supported
All dart USB 3.0 camera models Stacked ROI feature not supported
All pulse USB 3.0 camera models Stacked ROI feature not supported

Sample Code

// Configure width and offset X for all zones
camera.Width.SetValue(200);
camera.OffsetX.SetValue(100);
// Select zone 0
camera.ROIZoneSelector.SetValue(ROIZoneSelector_Zone0);
// Set the vertical offset for the selected zone
camera.ROIZoneOffset.SetValue(100);
// Set the height for the selected zone
camera.ROIZoneSize.SetValue(100);
// Enable the selected zone
camera.ROIZoneMode.SetValue(ROIZoneMode_On);
// Select zone 1
camera.ROIZoneSelector.SetValue(ROIZoneSelector_Zone1);
// Set the vertical offset for the selected zone
camera.ROIZoneOffset.SetValue(250);
// Set the height for the selected zone
camera.ROIZoneSize.SetValue(200);
// Enable the selected zone
camera.ROIZoneMode.SetValue(ROIZoneMode_On);
INodeMap& nodemap = camera.GetNodeMap();
// Configure width and offset X for all zones
CIntegerPtr(nodemap.GetNode("Width"))->SetValue(200);
CIntegerPtr(nodemap.GetNode("OffsetX"))->SetValue(100);
// Select zone 0
CEnumerationPtr(nodemap.GetNode("ROIZoneSelector"))->FromString("Zone0");
// Set the vertical offset for the selected zone
CIntegerPtr(nodemap.GetNode("ROIZoneOffset"))->SetValue(100);
// Set the height for the selected zone
CIntegerPtr(nodemap.GetNode("ROIZoneSize"))->SetValue(100);
// Enable the selected zone
CEnumerationPtr(nodemap.GetNode("ROIZoneMode"))->FromString("On");
// Select zone 1
CEnumerationPtr(nodemap.GetNode("ROIZoneSelector"))->FromString("Zone1");
// Set the vertical offset for the selected zone
CIntegerPtr(nodemap.GetNode("ROIZoneOffset"))->SetValue(250);
// Set the height for the selected zone
CIntegerPtr(nodemap.GetNode("ROIZoneSize"))->SetValue(200);
// Enable the selected zone
CEnumerationPtr(nodemap.GetNode("ROIZoneMode"))->FromString("On");
// Configure width and offset X for all zones
camera.Parameters[PLCamera.Width].SetValue(200);
camera.Parameters[PLCamera.OffsetX].SetValue(100);
// Select zone 0
camera.Parameters[PLCamera.ROIZoneSelector].SetValue(PLCamera.ROIZoneSelector.Zone0);
// Set the vertical offset for the selected zone
camera.Parameters[PLCamera.ROIZoneOffset].SetValue(100);
// Set the height for the selected zone
camera.Parameters[PLCamera.ROIZoneSize].SetValue(100);
// Enable the selected zone
camera.Parameters[PLCamera.ROIZoneMode].SetValue(PLCamera.ROIZoneMode.On);
// Select zone 1
camera.Parameters[PLCamera.ROIZoneSelector].SetValue(PLCamera.ROIZoneSelector.Zone1);
// Set the vertical offset for the selected zone
camera.Parameters[PLCamera.ROIZoneOffset].SetValue(250);
// Set the height for the selected zone
camera.Parameters[PLCamera.ROIZoneSize].SetValue(200);
// Enable the selected zone
camera.Parameters[PLCamera.ROIZoneMode].SetValue(PLCamera.ROIZoneMode.On);
// Configure width and offset X for all zones
Pylon.DeviceSetIntegerFeature(hdev, "Width", 200);
Pylon.DeviceSetIntegerFeature(hdev, "OffsetX", 100);
// Select zone 0
Pylon.DeviceFeatureFromString(hdev, "ROIZoneSelector", "Zone0");
// Set the vertical offset for the selected zone
Pylon.DeviceSetIntegerFeature(hdev, "ROIZoneOffset", 100);
// Set the height for the selected zone
Pylon.DeviceSetIntegerFeature(hdev, "ROIZoneSize", 100);
// Enable the selected zone
Pylon.DeviceFeatureFromString(hdev, "ROIZoneMode", "On");
// Select zone 1
Pylon.DeviceFeatureFromString(hdev, "ROIZoneSelector", "Zone1");
// Set the vertical offset for the selected zone
Pylon.DeviceSetIntegerFeature(hdev, "ROIZoneOffset", 250);
// Set the height for the selected zone
Pylon.DeviceSetIntegerFeature(hdev, "ROIZoneSize", 200);
// Enable the selected zone
Pylon.DeviceFeatureFromString(hdev, "ROIZoneMode", "On");
/* 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 */
/* Configure width and offset X for all zones */
errRes = PylonDeviceSetIntegerFeature(hdev, "Width", 200);
CHECK(errRes);
errRes = PylonDeviceSetIntegerFeature(hdev, "OffsetX", 100);
CHECK(errRes);
/* Select zone 0 */
errRes = PylonDeviceFeatureFromString(hdev, "ROIZoneSelector", "Zone0");
CHECK(errRes);
/* Set the vertical offset for the selected zone */
errRes = PylonDeviceSetIntegerFeature(hdev, "ROIZoneOffset", 100);
CHECK(errRes);
/* Set the height for the selected zone */
errRes = PylonDeviceSetIntegerFeature(hdev, "ROIZoneSize", 100);
CHECK(errRes);
/* Enable the selected zone */
errRes = PylonDeviceFeatureFromString(hdev, "ROIZoneMode", "On");
CHECK(errRes);
/* Select zone 1 */
errRes = PylonDeviceFeatureFromString(hdev, "ROIZoneSelector", "Zone1");
CHECK(errRes);
/* Set the vertical offset for the selected zone */
errRes = PylonDeviceSetIntegerFeature(hdev, "ROIZoneOffset", 250);
CHECK(errRes);
/* Set the height for the selected zone */
errRes = PylonDeviceSetIntegerFeature(hdev, "ROIZoneSize", 200);
CHECK(errRes);
/* Enable the selected zone */
errRes = PylonDeviceFeatureFromString(hdev, "ROIZoneMode", "On");
CHECK(errRes);

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