Acquisition Frame Rate#
This is useful if you want to operate the camera at a constant frame rate in free run image acquisition.
Using the Feature#
How It Works#
If the Acquisition Frame Rate feature is enabled, the camera's maximum frame rate is limited by the value you enter for the acquisition frame rate parameter.
For example, setting an acquisition frame rate of 20 frames per second (fps) has the following effects:
- If the other factors limiting the frame rate allow a frame rate of more than 20 fps, the frame rate will be kept at a constant frame rate of 20 fps.
- If the other factors limiting the frame rate only allow a frame rate of less than 20 fps, the frame rate won't be affected by the Acquisition Frame Rate feature.
Info
To determine the actual frame rate, use the Resulting Acquisition Frame Rate feature.
Setting the Acquisition Frame Rate#
- Set the
AcquisitionFrameRateEnable
parameter totrue
(if available). - Set the
AcquisitionFrameRate
parameter to the desired upper limit for the camera's frame rate in frames per second.
Specifics#
Camera Model | AcquisitionFrameRateEnable Parameter Available |
---|---|
a2A640-240gmSWIR | Yes |
a2A640-240umSWIR | Yes |
a2A1280-80gmSWIR | Yes |
a2A1280-125umSWIR | Yes |
a2A1920-51gcBAS | Yes |
a2A1920-51gcPRO | Yes |
a2A1920-51gmBAS | Yes |
a2A1920-51gmPRO | Yes |
a2A1920-160ucBAS | Yes |
a2A1920-160ucPRO | Yes |
a2A1920-160umBAS | Yes |
a2A1920-160umPRO | Yes |
a2A1920-165g5cBAS | Yes |
a2A1920-165g5mBAS | Yes |
a2A2048-35gmSWIR | Yes |
a2A2048-110umSWIR | Yes |
a2A2440-98g5cBAS | Yes |
a2A2440-98g5mBAS | Yes |
a2A2448-23gcBAS | Yes |
a2A2448-23gcPRO | Yes |
a2A2448-23gmBAS | Yes |
a2A2448-23gmPRO | Yes |
a2A2448-75ucBAS | Yes |
a2A2448-75ucPRO | Yes |
a2A2448-75umBAS | Yes |
a2A2448-75umPRO | Yes |
a2A2448-105g5cBAS | Yes |
a2A2448-105g5mBAS | Yes |
a2A2448-120cc | Yes |
a2A2448-120cm | Yes |
a2A2448-210cc | Yes |
a2A2448-210cm | Yes |
a2A2560-20gmSWIR | Yes |
a2A2560-70umSWIR | Yes |
a2A2590-22gcBAS | Yes |
a2A2590-22gcPRO | Yes |
a2A2590-22gmBAS | Yes |
a2A2590-22gmPRO | Yes |
a2A2590-60ucBAS | Yes |
a2A2590-60ucPRO | Yes |
a2A2590-60umBAS | Yes |
a2A2590-60umPRO | Yes |
a2A2600-20gcBAS | Yes |
a2A2600-20gcPRO | Yes |
a2A2600-20gmBAS | Yes |
a2A2600-20gmPRO | Yes |
a2A2600-64ucBAS | Yes |
a2A2600-64ucPRO | Yes |
a2A2600-64umBAS | Yes |
a2A2600-64umPRO | Yes |
a2A2840-14gcBAS | Yes |
a2A2840-14gcPRO | Yes |
a2A2840-14gmBAS | Yes |
a2A2840-14gmPRO | Yes |
a2A2840-14gmUV | Yes |
a2A2840-48ucBAS | Yes |
a2A2840-48ucPRO | Yes |
a2A2840-48umBAS | Yes |
a2A2840-48umPRO | Yes |
a2A2840-48umUV | Yes |
a2A2840-67g5cBAS | Yes |
a2A2840-67g5mBAS | Yes |
a2A2840-67g5mUV | Yes |
a2A2840-86cc | Yes |
a2A2840-86cm | Yes |
a2A3536-9gcBAS | Yes |
a2A3536-9gcPRO | Yes |
a2A3536-9gmBAS | Yes |
a2A3536-9gmPRO | Yes |
a2A3536-31ucBAS | Yes |
a2A3536-31ucPRO | Yes |
a2A3536-31umBAS | Yes |
a2A3536-31umPRO | Yes |
a2A3536-42g5cBAS | Yes |
a2A3536-42g5mBAS | Yes |
a2A3840-13gcBAS | Yes |
a2A3840-13gcPRO | Yes |
a2A3840-13gmBAS | Yes |
a2A3840-13gmPRO | Yes |
a2A3840-45ucBAS | Yes |
a2A3840-45ucPRO | Yes |
a2A3840-45umBAS | Yes |
a2A3840-45umPRO | Yes |
a2A4096-9gcBAS | Yes |
a2A4096-9gcPRO | Yes |
a2A4096-9gmBAS | Yes |
a2A4096-9gmPRO | Yes |
a2A4096-30ucBAS | Yes |
a2A4096-30ucPRO | Yes |
a2A4096-30umBAS | Yes |
a2A4096-30umPRO | Yes |
a2A4096-44g5cBAS | Yes |
a2A4096-44g5mBAS | Yes |
a2A4096-67cc | Yes |
a2A4096-67cm | Yes |
a2A4200-12gcBAS | Yes |
a2A4200-12gcPRO | Yes |
a2A4200-12gmBAS | Yes |
a2A4200-12gmPRO | Yes |
a2A4200-40ucBAS | Yes |
a2A4200-40ucPRO | Yes |
a2A4200-40umBAS | Yes |
a2A4200-40umPRO | Yes |
a2A4504-5gcBAS | Yes |
a2A4504-5gcPRO | Yes |
a2A4504-5gmBAS | Yes |
a2A4504-5gmPRO | Yes |
a2A4504-18ucBAS | Yes |
a2A4504-18ucPRO | Yes |
a2A4504-18umBAS | Yes |
a2A4504-18umPRO | Yes |
a2A4504-27g5cBAS | Yes |
a2A4504-27g5mBAS | Yes |
a2A4504-42cc | Yes |
a2A4504-42cm | Yes |
a2A4508-6gcBAS | Yes |
a2A4508-6gcPRO | Yes |
a2A4508-6gmBAS | Yes |
a2A4508-6gmPRO | Yes |
a2A4508-20ucBAS | Yes |
a2A4508-20ucPRO | Yes |
a2A4508-20umBAS | Yes |
a2A4508-20umPRO | Yes |
a2A5060-4gcBAS | Yes |
a2A5060-4gmBAS | Yes |
a2A5060-15ucBAS | Yes |
a2A5060-15umBAS | Yes |
a2A5060-21g5cBAS | Yes |
a2A5060-21g5mBAS | Yes |
a2A5320-7gcBAS | Yes |
a2A5320-7gcPRO | Yes |
a2A5320-7gmBAS | Yes |
a2A5320-7gmPRO | Yes |
a2A5320-23ucBAS | Yes |
a2A5320-23ucPRO | Yes |
a2A5320-23umBAS | Yes |
a2A5320-23umPRO | Yes |
a2A5320-34g5cBAS | Yes |
a2A5320-34g5mBAS | Yes |
a2A5320-52cc | Yes |
a2A5320-52cm | Yes |
a2A5328-4gcBAS | Yes |
a2A5328-4gcPRO | Yes |
a2A5328-4gmBAS | Yes |
a2A5328-4gmPRO | Yes |
a2A5328-15ucBAS | Yes |
a2A5328-15ucPRO | Yes |
a2A5328-15umBAS | Yes |
a2A5328-15umPRO | Yes |
a2A5328-22g5cBAS | Yes |
a2A5328-22g5mBAS | Yes |
a2A5328-35cc | Yes |
a2A5328-35cm | Yes |
acA640-121gm | Yes |
acA640-300gc | Yes |
acA640-300gm | Yes |
acA640-750uc | Yes |
acA640-750um | Yes |
acA720-290gc | Yes |
acA720-290gm | Yes |
acA720-520uc | Yes |
acA720-520um | Yes |
acA800-200gc | Yes |
acA800-200gm | Yes |
acA800-510uc | Yes |
acA800-510um | Yes |
acA1280-60gc | Yes |
acA1280-60gm | Yes |
acA1300-60gc | Yes |
acA1300-60gm | Yes |
acA1300-60gmNIR | Yes |
acA1300-75gc | Yes |
acA1300-75gm | Yes |
acA1300-200uc | Yes |
acA1300-200um | Yes |
acA1440-73gc | Yes |
acA1440-73gm | Yes |
acA1440-220uc | Yes |
acA1440-220um | Yes |
acA1600-20gc | Yes |
acA1600-20uc | Yes |
acA1600-60gc | Yes |
acA1600-60gm | Yes |
acA1920-25gc | Yes |
acA1920-25gm | Yes |
acA1920-25uc | Yes |
acA1920-25um | Yes |
acA1920-40gc | Yes |
acA1920-40gm | Yes |
acA1920-40uc | Yes |
acA1920-40ucMED | Yes |
acA1920-40um | Yes |
acA1920-40umMED | Yes |
acA1920-48gc | Yes |
acA1920-48gm | Yes |
acA1920-50gc | Yes |
acA1920-50gm | Yes |
acA1920-150uc | Yes |
acA1920-150um | Yes |
acA1920-155uc | Yes |
acA1920-155ucMED | Yes |
acA1920-155um | Yes |
acA1920-155umMED | Yes |
acA2000-50gc | Yes |
acA2000-50gm | Yes |
acA2000-165uc | Yes |
acA2000-165um | Yes |
acA2040-25gc | Yes |
acA2040-25gm | Yes |
acA2040-25gmNIR | Yes |
acA2040-35gc | Yes |
acA2040-35gm | Yes |
acA2040-55uc | Yes |
acA2040-55um | Yes |
acA2040-90uc | Yes |
acA2040-90um | Yes |
acA2040-90umNIR | Yes |
acA2040-120uc | Yes |
acA2040-120um | Yes |
acA2440-20gc | Yes |
acA2440-20gm | Yes |
acA2440-35uc | Yes |
acA2440-35ucMED | Yes |
acA2440-35um | Yes |
acA2440-35umMED | Yes |
acA2440-75uc | Yes |
acA2440-75ucMED | Yes |
acA2440-75um | Yes |
acA2440-75umMED | Yes |
acA2500-14gc | Yes |
acA2500-14gm | Yes |
acA2500-14uc | Yes |
acA2500-14um | Yes |
acA2500-20gc | Yes |
acA2500-20gcMED | Yes |
acA2500-20gm | Yes |
acA2500-20gmMED | Yes |
acA2500-60uc | Yes |
acA2500-60um | Yes |
acA3088-16gc | Yes |
acA3088-16gm | Yes |
acA3088-57uc | Yes |
acA3088-57ucMED | Yes |
acA3088-57um | Yes |
acA3088-57umMED | Yes |
acA3800-10gc | Yes |
acA3800-10gm | Yes |
acA3800-14uc | Yes |
acA3800-14um | Yes |
acA4024-8gc | Yes |
acA4024-8gm | Yes |
acA4024-29uc | Yes |
acA4024-29um | Yes |
acA4096-11gc | Yes |
acA4096-11gm | Yes |
acA4096-30uc | Yes |
acA4096-30ucMED | Yes |
acA4096-30um | Yes |
acA4096-30umMED | Yes |
acA4096-40uc | Yes |
acA4096-40ucMED | Yes |
acA4096-40um | Yes |
acA4096-40umMED | Yes |
acA4112-8gc | Yes |
acA4112-8gm | Yes |
acA4112-20uc | Yes |
acA4112-20ucMED | Yes |
acA4112-20um | Yes |
acA4112-20umMED | Yes |
acA4112-30uc | Yes |
acA4112-30ucMED | Yes |
acA4112-30um | Yes |
acA4112-30umMED | Yes |
acA5472-5gc | Yes |
acA5472-5gm | Yes |
acA5472-17uc | Yes |
acA5472-17ucMED | Yes |
acA5472-17um | Yes |
acA5472-17umMED | Yes |
boA1936-400cc | Yes |
boA1936-400cm | Yes |
boA2448-250cc | Yes |
boA2448-250cm | Yes |
boA2832-190cc | Yes |
boA2832-190cm | Yes |
boA4096-93cc | Yes |
boA4096-93cm | Yes |
boA4096-180cc | Yes |
boA4096-180cm | Yes |
boA4112-68cc | Yes |
boA4112-68cm | Yes |
boA4500-45cc | Yes |
boA4500-45cm | Yes |
boA4504-100cc | Yes |
boA4504-100cm | Yes |
boA5120-150cc | No |
boA5120-150cm | No |
boA5120-230cc | No |
boA5120-230cm | No |
boA5320-150cc | Yes |
boA5320-150cm | Yes |
boA5328-100cc | Yes |
boA5328-100cm | Yes |
boA6500-36cc | Yes |
boA6500-36cm | Yes |
boA8100-16cc | Yes |
boA8100-16cm | Yes |
boA9344-30cc | No |
boA9344-30cm | No |
boA9344-70cc | No |
boA9344-70cm | No |
boA13440-17cm | Yes |
daA720-520uc | Yes |
daA720-520um | Yes |
daA1280-54uc | No |
daA1280-54um | No |
daA1440-220uc | Yes |
daA1440-220um | Yes |
daA1600-60uc | No |
daA1600-60um | No |
daA1920-15um | No |
daA1920-30uc | No |
daA1920-30um | No |
daA1920-160uc | Yes |
daA1920-160um | Yes |
daA2448-70uc | Yes |
daA2448-70um | Yes |
daA2500-14uc | No |
daA2500-14um | No |
daA3840-45uc | Yes |
daA3840-45um | Yes |
dmA720-290gc | Yes |
dmA720-290gm | Yes |
dmA1440-73gc | Yes |
dmA1440-73gm | Yes |
dmA1920-51gc | Yes |
dmA1920-51gm | Yes |
dmA3536-9gc | Yes |
dmA3536-9gm | Yes |
puA1280-54uc | No |
puA1280-54um | No |
puA1600-60uc | No |
puA1600-60um | No |
puA1920-30uc | No |
puA1920-30um | No |
puA2500-14uc | No |
puA2500-14um | No |
r2L2048-29gc | Acquisition Frame Rate feature not supported (see Acquisition Line Rate) |
r2L2048-58gm | Acquisition Frame Rate feature not supported (see Acquisition Line Rate) |
r2L2048-62cc | Acquisition Frame Rate feature not supported (see Acquisition Line Rate) |
r2L2048-62g5c | Acquisition Frame Rate feature not supported (see Acquisition Line Rate) |
r2L2048-172cm | Acquisition Frame Rate feature not supported (see Acquisition Line Rate) |
r2L2048-172g5m | Acquisition Frame Rate feature not supported (see Acquisition Line Rate) |
r2L4096-14gc | Acquisition Frame Rate feature not supported (see Acquisition Line Rate) |
r2L4096-29gm | Acquisition Frame Rate feature not supported (see Acquisition Line Rate) |
r2L4096-42cc | Acquisition Frame Rate feature not supported (see Acquisition Line Rate) |
r2L4096-42g5c | Acquisition Frame Rate feature not supported (see Acquisition Line Rate) |
r2L4096-84cm | Acquisition Frame Rate feature not supported (see Acquisition Line Rate) |
r2L4096-84g5m | Acquisition Frame Rate feature not supported (see Acquisition Line Rate) |
r2L8192-200cm | Acquisition Frame Rate feature not available (see Acquisition Line Rate) |
r2L16384-120cm | Acquisition Frame Rate feature not available (see Acquisition Line Rate) |
Sample Code#
ace Classic/U/L GigE 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 */
/* Set the upper limit of the camera's frame rate to 30 fps */
errRes = PylonDeviceSetBooleanFeature(hdev, "AcquisitionFrameRateEnable", 1);
CHECK(errRes);
errRes = PylonDeviceSetFloatFeature(hdev, "AcquisitionFrameRateAbs", 30.0);
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 */
/* Set the upper limit of the camera's frame rate to 30 fps */
errRes = PylonDeviceSetBooleanFeature(hdev, "AcquisitionFrameRateEnable", 1);
CHECK(errRes);
errRes = PylonDeviceSetFloatFeature(hdev, "AcquisitionFrameRate", 30.0);
CHECK(errRes);
You can also use the pylon Viewer to easily set the parameters.