Center X and Center Y#

The Center X and Center Y camera feature allows you to center the image ROI horizontally, vertically, or both.

Using the Feature#

Using Center X#

To center the image horizontally:

• On ace 2, boost, dart M/R, and racer 2 cameras, execute the BslCenterX command.
  The camera adjusts the OffsetX parameter value to center the image ROI horizontally. This is a one-time operation. When you change the width of the image ROI, you must execute the command again.
• On other cameras, set the CenterX parameter to true.
  The camera adjusts the OffsetX parameter value to center the image ROI horizontally. When you change the width of the image ROI, the OffsetX parameter value automatically adapts. The OffsetX parameter becomes read-only.

Using Center Y#

To center the image vertically:

• On ace 2, boost, and dart M/R cameras, execute the BslCenterY command.
  The camera adjusts the OffsetY parameter value to center the image ROI vertically. This is a one-time operation. When you change the height of the image ROI, you must execute the command again.

  Note: On racer 2 cameras, the BslCenterY command and the OffsetY parameter are not available.

• On other cameras, set the CenterY parameter to true.
  The camera adjusts the OffsetY parameter value to center the image ROI vertically. When you change the height of the image ROI, the OffsetY parameter value automatically adapts. The OffsetY parameter becomes read-only.

Specifics#

Show all camera models

Sample Code#

ace 2, boost, dart M, and dart R Cameras#

// Center the image ROI
camera.BslCenterX.Execute();
camera.BslCenterY.Execute();

INodeMap& nodemap = camera.GetNodeMap();
// Center the image ROI
CCommandParameter(nodemap, "BslCenterX").Execute();
CCommandParameter(nodemap, "BslCenterY").Execute();

// Center the image ROI
camera.Parameters[PLCamera.BslCenterX].Execute();
camera.Parameters[PLCamera.BslCenterY].Execute();

/* 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 */
/* Center the image ROI */
errRes = PylonDeviceExecuteCommandFeature(hdev, "BslCenterX");
CHECK(errRes);
errRes = PylonDeviceExecuteCommandFeature(hdev, "BslCenterY");
CHECK(errRes);

# Center the image ROI
camera.BslCenterX.Execute()
camera.BslCenterY.Execute()

Other Cameras#

// Center the image
camera.CenterX.SetValue(true);
camera.CenterY.SetValue(true);

INodeMap& nodemap = camera.GetNodeMap();
// Center the image
CBooleanParameter(nodemap, "CenterX").SetValue(true);
CBooleanParameter(nodemap, "CenterY").SetValue(true);

// Center the image
camera.Parameters[PLCamera.CenterX].SetValue(true);
camera.Parameters[PLCamera.CenterY].SetValue(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 */
/* Center the image */
errRes = PylonDeviceSetBooleanFeature(hdev, "CenterX", 1);
CHECK(errRes);
errRes = PylonDeviceSetBooleanFeature(hdev, "CenterY", 1);
CHECK(errRes);

# Center the image
camera.CenterX.Value = True
camera.CenterY.Value = True

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