Center X and Center Y#
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 theOffsetX
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 totrue
.
The camera adjusts theOffsetX
parameter value to center the image ROI horizontally. When you change the width of the image ROI, theOffsetX
parameter value automatically adapts. TheOffsetX
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 theOffsetY
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 theOffsetY
parameter are not available. -
On other cameras, set the
CenterY
parameter totrue
.
The camera adjusts theOffsetY
parameter value to center the image ROI vertically. When you change the height of the image ROI, theOffsetY
parameter value automatically adapts. TheOffsetY
parameter becomes read-only.
Specifics#
Camera Model | Parameter Names |
---|---|
a2A640-240gmSWIR | BslCenterX BslCenterY |
a2A640-240umSWIR | BslCenterX BslCenterY |
a2A1280-80gmSWIR | BslCenterX BslCenterY |
a2A1280-125umSWIR | BslCenterX BslCenterY |
a2A1920-51gcBAS | BslCenterX BslCenterY |
a2A1920-51gcPRO | BslCenterX BslCenterY |
a2A1920-51gmBAS | BslCenterX BslCenterY |
a2A1920-51gmPRO | BslCenterX BslCenterY |
a2A1920-160ucBAS | BslCenterX BslCenterY |
a2A1920-160ucPRO | BslCenterX BslCenterY |
a2A1920-160umBAS | BslCenterX BslCenterY |
a2A1920-160umPRO | BslCenterX BslCenterY |
a2A1920-165g5cBAS | BslCenterX BslCenterY |
a2A1920-165g5mBAS | BslCenterX BslCenterY |
a2A2048-35gmSWIR | BslCenterX BslCenterY |
a2A2048-110umSWIR | BslCenterX BslCenterY |
a2A2440-98g5cBAS | BslCenterX BslCenterY |
a2A2440-98g5mBAS | BslCenterX BslCenterY |
a2A2448-23gcBAS | BslCenterX BslCenterY |
a2A2448-23gcPRO | BslCenterX BslCenterY |
a2A2448-23gmBAS | BslCenterX BslCenterY |
a2A2448-23gmPRO | BslCenterX BslCenterY |
a2A2448-75ucBAS | BslCenterX BslCenterY |
a2A2448-75ucPRO | BslCenterX BslCenterY |
a2A2448-75umBAS | BslCenterX BslCenterY |
a2A2448-75umPRO | BslCenterX BslCenterY |
a2A2448-105g5cBAS | BslCenterX BslCenterY |
a2A2448-105g5mBAS | BslCenterX BslCenterY |
a2A2448-120cc | BslCenterX BslCenterY |
a2A2448-120cm | BslCenterX BslCenterY |
a2A2448-210cc | BslCenterX BslCenterY |
a2A2448-210cm | BslCenterX BslCenterY |
a2A2560-20gmSWIR | BslCenterX BslCenterY |
a2A2560-70umSWIR | BslCenterX BslCenterY |
a2A2590-22gcBAS | BslCenterX BslCenterY |
a2A2590-22gcPRO | BslCenterX BslCenterY |
a2A2590-22gmBAS | BslCenterX BslCenterY |
a2A2590-22gmPRO | BslCenterX BslCenterY |
a2A2590-60ucBAS | BslCenterX BslCenterY |
a2A2590-60ucPRO | BslCenterX BslCenterY |
a2A2590-60umBAS | BslCenterX BslCenterY |
a2A2590-60umPRO | BslCenterX BslCenterY |
a2A2600-20gcBAS | BslCenterX BslCenterY |
a2A2600-20gcPRO | BslCenterX BslCenterY |
a2A2600-20gmBAS | BslCenterX BslCenterY |
a2A2600-20gmPRO | BslCenterX BslCenterY |
a2A2600-64ucBAS | BslCenterX BslCenterY |
a2A2600-64ucPRO | BslCenterX BslCenterY |
a2A2600-64umBAS | BslCenterX BslCenterY |
a2A2600-64umPRO | BslCenterX BslCenterY |
a2A2840-14gcBAS | BslCenterX BslCenterY |
a2A2840-14gcPRO | BslCenterX BslCenterY |
a2A2840-14gmBAS | BslCenterX BslCenterY |
a2A2840-14gmPRO | BslCenterX BslCenterY |
a2A2840-14gmUV | BslCenterX BslCenterY |
a2A2840-48ucBAS | BslCenterX BslCenterY |
a2A2840-48ucPRO | BslCenterX BslCenterY |
a2A2840-48umBAS | BslCenterX BslCenterY |
a2A2840-48umPRO | BslCenterX BslCenterY |
a2A2840-48umUV | BslCenterX BslCenterY |
a2A2840-67g5cBAS | BslCenterX BslCenterY |
a2A2840-67g5mBAS | BslCenterX BslCenterY |
a2A2840-67g5mUV | BslCenterX BslCenterY |
a2A2840-86cc | BslCenterX BslCenterY |
a2A2840-86cm | BslCenterX BslCenterY |
a2A3536-9gcBAS | BslCenterX BslCenterY |
a2A3536-9gcPRO | BslCenterX BslCenterY |
a2A3536-9gmBAS | BslCenterX BslCenterY |
a2A3536-9gmPRO | BslCenterX BslCenterY |
a2A3536-31ucBAS | BslCenterX BslCenterY |
a2A3536-31ucPRO | BslCenterX BslCenterY |
a2A3536-31umBAS | BslCenterX BslCenterY |
a2A3536-31umPRO | BslCenterX BslCenterY |
a2A3536-42g5cBAS | BslCenterX BslCenterY |
a2A3536-42g5mBAS | BslCenterX BslCenterY |
a2A3840-13gcBAS | BslCenterX BslCenterY |
a2A3840-13gcPRO | BslCenterX BslCenterY |
a2A3840-13gmBAS | BslCenterX BslCenterY |
a2A3840-13gmPRO | BslCenterX BslCenterY |
a2A3840-45ucBAS | BslCenterX BslCenterY |
a2A3840-45ucPRO | BslCenterX BslCenterY |
a2A3840-45umBAS | BslCenterX BslCenterY |
a2A3840-45umPRO | BslCenterX BslCenterY |
a2A4096-9gcBAS | BslCenterX BslCenterY |
a2A4096-9gcPRO | BslCenterX BslCenterY |
a2A4096-9gmBAS | BslCenterX BslCenterY |
a2A4096-9gmPRO | BslCenterX BslCenterY |
a2A4096-30ucBAS | BslCenterX BslCenterY |
a2A4096-30ucPRO | BslCenterX BslCenterY |
a2A4096-30umBAS | BslCenterX BslCenterY |
a2A4096-30umPRO | BslCenterX BslCenterY |
a2A4096-44g5cBAS | BslCenterX BslCenterY |
a2A4096-44g5mBAS | BslCenterX BslCenterY |
a2A4096-67cc | BslCenterX BslCenterY |
a2A4096-67cm | BslCenterX BslCenterY |
a2A4200-12gcBAS | BslCenterX BslCenterY |
a2A4200-12gcPRO | BslCenterX BslCenterY |
a2A4200-12gmBAS | BslCenterX BslCenterY |
a2A4200-12gmPRO | BslCenterX BslCenterY |
a2A4200-40ucBAS | BslCenterX BslCenterY |
a2A4200-40ucPRO | BslCenterX BslCenterY |
a2A4200-40umBAS | BslCenterX BslCenterY |
a2A4200-40umPRO | BslCenterX BslCenterY |
a2A4504-5gcBAS | BslCenterX BslCenterY |
a2A4504-5gcPRO | BslCenterX BslCenterY |
a2A4504-5gmBAS | BslCenterX BslCenterY |
a2A4504-5gmPRO | BslCenterX BslCenterY |
a2A4504-18ucBAS | BslCenterX BslCenterY |
a2A4504-18ucPRO | BslCenterX BslCenterY |
a2A4504-18umBAS | BslCenterX BslCenterY |
a2A4504-18umPRO | BslCenterX BslCenterY |
a2A4504-27g5cBAS | BslCenterX BslCenterY |
a2A4504-27g5mBAS | BslCenterX BslCenterY |
a2A4504-42cc | BslCenterX BslCenterY |
a2A4504-42cm | BslCenterX BslCenterY |
a2A4508-6gcBAS | BslCenterX BslCenterY |
a2A4508-6gcPRO | BslCenterX BslCenterY |
a2A4508-6gmBAS | BslCenterX BslCenterY |
a2A4508-6gmPRO | BslCenterX BslCenterY |
a2A4508-20ucBAS | BslCenterX BslCenterY |
a2A4508-20ucPRO | BslCenterX BslCenterY |
a2A4508-20umBAS | BslCenterX BslCenterY |
a2A4508-20umPRO | BslCenterX BslCenterY |
a2A5060-4gcBAS | BslCenterX BslCenterY |
a2A5060-4gmBAS | BslCenterX BslCenterY |
a2A5060-15ucBAS | BslCenterX BslCenterY |
a2A5060-15umBAS | BslCenterX BslCenterY |
a2A5060-21g5cBAS | BslCenterX BslCenterY |
a2A5060-21g5mBAS | BslCenterX BslCenterY |
a2A5320-7gcBAS | BslCenterX BslCenterY |
a2A5320-7gcPRO | BslCenterX BslCenterY |
a2A5320-7gmBAS | BslCenterX BslCenterY |
a2A5320-7gmPRO | BslCenterX BslCenterY |
a2A5320-23ucBAS | BslCenterX BslCenterY |
a2A5320-23ucPRO | BslCenterX BslCenterY |
a2A5320-23umBAS | BslCenterX BslCenterY |
a2A5320-23umPRO | BslCenterX BslCenterY |
a2A5320-34g5cBAS | BslCenterX BslCenterY |
a2A5320-34g5mBAS | BslCenterX BslCenterY |
a2A5320-52cc | BslCenterX BslCenterY |
a2A5320-52cm | BslCenterX BslCenterY |
a2A5328-4gcBAS | BslCenterX BslCenterY |
a2A5328-4gcPRO | BslCenterX BslCenterY |
a2A5328-4gmBAS | BslCenterX BslCenterY |
a2A5328-4gmPRO | BslCenterX BslCenterY |
a2A5328-15ucBAS | BslCenterX BslCenterY |
a2A5328-15ucPRO | BslCenterX BslCenterY |
a2A5328-15umBAS | BslCenterX BslCenterY |
a2A5328-15umPRO | BslCenterX BslCenterY |
a2A5328-22g5cBAS | BslCenterX BslCenterY |
a2A5328-22g5mBAS | BslCenterX BslCenterY |
a2A5328-35cc | BslCenterX BslCenterY |
a2A5328-35cm | BslCenterX BslCenterY |
acA640-121gm | CenterX CenterY |
acA640-300gc | CenterX CenterY |
acA640-300gm | CenterX CenterY |
acA640-750uc | CenterX CenterY |
acA640-750um | CenterX CenterY |
acA720-290gc | CenterX CenterY |
acA720-290gm | CenterX CenterY |
acA720-520uc | CenterX CenterY |
acA720-520um | CenterX CenterY |
acA800-200gc | CenterX CenterY |
acA800-200gm | CenterX CenterY |
acA800-510uc | CenterX CenterY |
acA800-510um | CenterX CenterY |
acA1280-60gc | CenterX CenterY |
acA1280-60gm | CenterX CenterY |
acA1300-60gc | CenterX CenterY |
acA1300-60gm | CenterX CenterY |
acA1300-60gmNIR | CenterX CenterY |
acA1300-75gc | CenterX CenterY |
acA1300-75gm | CenterX CenterY |
acA1300-200uc | CenterX CenterY |
acA1300-200um | CenterX CenterY |
acA1440-73gc | CenterX CenterY |
acA1440-73gm | CenterX CenterY |
acA1440-220uc | CenterX CenterY |
acA1440-220um | CenterX CenterY |
acA1600-20gc | CenterX CenterY |
acA1600-20uc | CenterX CenterY |
acA1600-60gc | CenterX CenterY |
acA1600-60gm | CenterX CenterY |
acA1920-25gc | CenterX CenterY |
acA1920-25gm | CenterX CenterY |
acA1920-25uc | CenterX CenterY |
acA1920-25um | CenterX CenterY |
acA1920-40gc | CenterX CenterY |
acA1920-40gm | CenterX CenterY |
acA1920-40uc | CenterX CenterY |
acA1920-40ucMED | CenterX CenterY |
acA1920-40um | CenterX CenterY |
acA1920-40umMED | CenterX CenterY |
acA1920-48gc | CenterX CenterY |
acA1920-48gm | CenterX CenterY |
acA1920-50gc | CenterX CenterY |
acA1920-50gm | CenterX CenterY |
acA1920-150uc | CenterX CenterY |
acA1920-150um | CenterX CenterY |
acA1920-155uc | CenterX CenterY |
acA1920-155ucMED | CenterX CenterY |
acA1920-155um | CenterX CenterY |
acA1920-155umMED | CenterX CenterY |
acA2000-50gc | CenterX CenterY |
acA2000-50gm | CenterX CenterY |
acA2000-165uc | CenterX CenterY |
acA2000-165um | CenterX CenterY |
acA2040-25gc | CenterX CenterY |
acA2040-25gm | CenterX CenterY |
acA2040-25gmNIR | CenterX CenterY |
acA2040-35gc | CenterX CenterY |
acA2040-35gm | CenterX CenterY |
acA2040-55uc | CenterX CenterY |
acA2040-55um | CenterX CenterY |
acA2040-90uc | CenterX CenterY |
acA2040-90um | CenterX CenterY |
acA2040-90umNIR | CenterX CenterY |
acA2040-120uc | CenterX CenterY |
acA2040-120um | CenterX CenterY |
acA2440-20gc | CenterX CenterY |
acA2440-20gm | CenterX CenterY |
acA2440-35uc | CenterX CenterY |
acA2440-35ucMED | CenterX CenterY |
acA2440-35um | CenterX CenterY |
acA2440-35umMED | CenterX CenterY |
acA2440-75uc | CenterX CenterY |
acA2440-75ucMED | CenterX CenterY |
acA2440-75um | CenterX CenterY |
acA2440-75umMED | CenterX CenterY |
acA2500-14gc | CenterX CenterY |
acA2500-14gm | CenterX CenterY |
acA2500-14uc | CenterX CenterY |
acA2500-14um | CenterX CenterY |
acA2500-20gc | CenterX CenterY |
acA2500-20gcMED | CenterX CenterY |
acA2500-20gm | CenterX CenterY |
acA2500-20gmMED | CenterX CenterY |
acA2500-60uc | CenterX CenterY |
acA2500-60um | CenterX CenterY |
acA3088-16gc | CenterX CenterY |
acA3088-16gm | CenterX CenterY |
acA3088-57uc | CenterX CenterY |
acA3088-57ucMED | CenterX CenterY |
acA3088-57um | CenterX CenterY |
acA3088-57umMED | CenterX CenterY |
acA3800-10gc | CenterX CenterY |
acA3800-10gm | CenterX CenterY |
acA3800-14uc | CenterX CenterY |
acA3800-14um | CenterX CenterY |
acA4024-8gc | CenterX CenterY |
acA4024-8gm | CenterX CenterY |
acA4024-29uc | CenterX CenterY |
acA4024-29um | CenterX CenterY |
acA4096-11gc | CenterX CenterY |
acA4096-11gm | CenterX CenterY |
acA4096-30uc | CenterX CenterY |
acA4096-30ucMED | CenterX CenterY |
acA4096-30um | CenterX CenterY |
acA4096-30umMED | CenterX CenterY |
acA4096-40uc | CenterX CenterY |
acA4096-40ucMED | CenterX CenterY |
acA4096-40um | CenterX CenterY |
acA4096-40umMED | CenterX CenterY |
acA4112-8gc | CenterX CenterY |
acA4112-8gm | CenterX CenterY |
acA4112-20uc | CenterX CenterY |
acA4112-20ucMED | CenterX CenterY |
acA4112-20um | CenterX CenterY |
acA4112-20umMED | CenterX CenterY |
acA4112-30uc | CenterX CenterY |
acA4112-30ucMED | CenterX CenterY |
acA4112-30um | CenterX CenterY |
acA4112-30umMED | CenterX CenterY |
acA5472-5gc | CenterX CenterY |
acA5472-5gm | CenterX CenterY |
acA5472-17uc | CenterX CenterY |
acA5472-17ucMED | CenterX CenterY |
acA5472-17um | CenterX CenterY |
acA5472-17umMED | CenterX CenterY |
boA1936-400cc | BslCenterX BslCenterY |
boA1936-400cm | BslCenterX BslCenterY |
boA2448-250cc | BslCenterX BslCenterY |
boA2448-250cm | BslCenterX BslCenterY |
boA2832-190cc | BslCenterX BslCenterY |
boA2832-190cm | BslCenterX BslCenterY |
boA4096-93cc | BslCenterX BslCenterY |
boA4096-93cm | BslCenterX BslCenterY |
boA4096-180cc | BslCenterX BslCenterY |
boA4096-180cm | BslCenterX BslCenterY |
boA4112-68cc | BslCenterX BslCenterY |
boA4112-68cm | BslCenterX BslCenterY |
boA4500-45cc | BslCenterX BslCenterY |
boA4500-45cm | BslCenterX BslCenterY |
boA4504-100cc | BslCenterX BslCenterY |
boA4504-100cm | BslCenterX BslCenterY |
boA5120-150cc | Center X and Center Y feature not supported |
boA5120-150cm | Center X and Center Y feature not supported |
boA5120-230cc | Center X and Center Y feature not supported |
boA5120-230cm | Center X and Center Y feature not supported |
boA5320-150cc | BslCenterX BslCenterY |
boA5320-150cm | BslCenterX BslCenterY |
boA5328-100cc | BslCenterX BslCenterY |
boA5328-100cm | BslCenterX BslCenterY |
boA6500-36cc | BslCenterX BslCenterY |
boA6500-36cm | BslCenterX BslCenterY |
boA8100-16cc | BslCenterX BslCenterY |
boA8100-16cm | BslCenterX BslCenterY |
boA9344-30cc | Center X and Center Y feature not supported |
boA9344-30cm | Center X and Center Y feature not supported |
boA9344-70cc | Center X and Center Y feature not supported |
boA9344-70cm | Center X and Center Y feature not supported |
boA13440-17cm | Center X and Center Y feature not supported |
daA720-520uc | BslCenterX BslCenterY |
daA720-520um | BslCenterX BslCenterY |
daA1280-54uc | Center X and Center Y feature not supported |
daA1280-54um | Center X and Center Y feature not supported |
daA1440-220uc | BslCenterX BslCenterY |
daA1440-220um | BslCenterX BslCenterY |
daA1600-60uc | Center X and Center Y feature not supported |
daA1600-60um | Center X and Center Y feature not supported |
daA1920-15um | Center X and Center Y feature not supported |
daA1920-30uc | Center X and Center Y feature not supported |
daA1920-30um | Center X and Center Y feature not supported |
daA1920-160uc | BslCenterX BslCenterY |
daA1920-160um | BslCenterX BslCenterY |
daA2448-70uc | BslCenterX BslCenterY |
daA2448-70um | BslCenterX BslCenterY |
daA2500-14uc | Center X and Center Y feature not supported |
daA2500-14um | Center X and Center Y feature not supported |
daA3840-45uc | BslCenterX BslCenterY |
daA3840-45um | BslCenterX BslCenterY |
dmA720-290gc | BslCenterX BslCenterY |
dmA720-290gm | BslCenterX BslCenterY |
dmA1440-73gc | BslCenterX BslCenterY |
dmA1440-73gm | BslCenterX BslCenterY |
dmA1920-51gc | BslCenterX BslCenterY |
dmA1920-51gm | BslCenterX BslCenterY |
dmA3536-9gc | BslCenterX BslCenterY |
dmA3536-9gm | BslCenterX BslCenterY |
puA1280-54uc | Center X and Center Y feature not supported |
puA1280-54um | Center X and Center Y feature not supported |
puA1600-60uc | Center X and Center Y feature not supported |
puA1600-60um | Center X and Center Y feature not supported |
puA1920-30uc | Center X and Center Y feature not supported |
puA1920-30um | Center X and Center Y feature not supported |
puA2500-14uc | Center X and Center Y feature not supported |
puA2500-14um | Center X and Center Y feature not supported |
r2L2048-29gc | BslCenterX |
r2L2048-58gm | BslCenterX |
r2L2048-62cc | BslCenterX |
r2L2048-62g5c | BslCenterX |
r2L2048-172cm | BslCenterX |
r2L2048-172g5m | BslCenterX |
r2L4096-14gc | BslCenterX |
r2L4096-29gm | BslCenterX |
r2L4096-42cc | BslCenterX |
r2L4096-42g5c | BslCenterX |
r2L4096-84cm | BslCenterX |
r2L4096-84g5m | BslCenterX |
r2L8192-200cm | BslCenterX |
r2L16384-120cm | BslCenterX |
Sample Code#
ace 2, boost, dart M, and dart R Cameras#
/* 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);
Other Cameras#
/* 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);
You can also use the pylon Viewer to easily set the parameters.