Skip to content

Acquisition Frame Rate#

The Acquisition Frame Rate camera feature allows you to set an upper limit for the camera's 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#

  1. Set the AcquisitionFrameRateEnable parameter to true (if available).
  2. Set the AcquisitionFrameRate parameter to the desired upper limit for the camera's frame rate in frames per second.

Specifics#

Show all camera models

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
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
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
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#
// Set the upper limit of the camera's frame rate to 30 fps
camera.AcquisitionFrameRateEnable.SetValue(true);
camera.AcquisitionFrameRateAbs.SetValue(30.0);
INodeMap& nodemap = camera.GetNodeMap();
// Set the upper limit of the camera's frame rate to 30 fps
CBooleanParameter(nodemap, "AcquisitionFrameRateEnable").SetValue(true);
CFloatParameter(nodemap, "AcquisitionFrameRateAbs").SetValue(30.0);
// Set the upper limit of the camera's frame rate to 30 fps
camera.Parameters[PLCamera.AcquisitionFrameRateEnable].SetValue(true);
camera.Parameters[PLCamera.AcquisitionFrameRateAbs].SetValue(30.0);
/* 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);
# Set the upper limit of the camera's frame rate to 30 fps
camera.AcquisitionFrameRateEnable.Value = True
camera.AcquisitionFrameRateAbs.Value = 30.0
Other Cameras#
// Set the upper limit of the camera's frame rate to 30 fps
camera.AcquisitionFrameRateEnable.SetValue(true);
camera.AcquisitionFrameRate.SetValue(30.0);
INodeMap& nodemap = camera.GetNodeMap();
// Set the upper limit of the camera's frame rate to 30 fps
CBooleanParameter(nodemap, "AcquisitionFrameRateEnable").SetValue(true);
CFloatParameter(nodemap, "AcquisitionFrameRate").SetValue(30.0);
// Set the upper limit of the camera's frame rate to 30 fps
camera.Parameters[PLCamera.AcquisitionFrameRateEnable].SetValue(true);
camera.Parameters[PLCamera.AcquisitionFrameRate].SetValue(30.0);
/* 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);
# Set the upper limit of the camera's frame rate to 30 fps
camera.AcquisitionFrameRateEnable.Value = True
camera.AcquisitionFrameRate.Value = 30.0

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