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 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
a2A1920-51gcBAS Yes
a2A1920-51gmBAS Yes
a2A1920-160ucBAS Yes
a2A1920-160umBAS Yes
a2A3840-13gcBAS tbd
a2A3840-13gmBAS tbd
a2A3840-45ucBAS tbd
a2A3840-45umBAS tbd
acA640-90gc Yes
acA640-90gm Yes
acA640-90uc Yes
acA640-90um Yes
acA640-120gc Yes
acA640-120gm Yes
acA640-120uc Yes
acA640-120um 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
acA780-75gc Yes
acA780-75gm Yes
acA800-200gc Yes
acA800-200gm Yes
acA800-510uc Yes
acA800-510um Yes
acA1280-60gc Yes
acA1280-60gm Yes
acA1300-22gc Yes
acA1300-22gm Yes
acA1300-30gc Yes
acA1300-30gm Yes
acA1300-30uc Yes
acA1300-30um 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-20gm Yes
acA1600-20uc Yes
acA1600-20um 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-50gmNIR Yes
acA2000-165uc Yes
acA2000-165um Yes
acA2000-165umNIR 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-57um 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
acA4600-7gc Yes
acA4600-10uc Yes
acA5472-5gc Yes
acA5472-5gm Yes
acA5472-17uc Yes
acA5472-17um Yes
boA4096-93cc Yes
boA4096-93cm Yes
boA4112-68cc Yes
boA4112-68cm Yes
daA1280-54lc No
daA1280-54lm No
daA1280-54uc No
daA1280-54um No
daA1600-60lc No
daA1600-60lm No
daA1600-60uc No
daA1600-60um No
daA1920-15um No
daA1920-30uc No
daA1920-30um No
daA2500-14lc No
daA2500-14lm No
daA2500-14uc No
daA2500-14um No
daA2500-60mc No
puA1280-54uc No
puA1280-54um No
puA1600-60uc No
puA1600-60um No
puA1920-30uc No
puA1920-30um No
puA2500-14uc No
puA2500-14um No

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
CBooleanPtr(nodemap.GetNode("AcquisitionFrameRateEnable"))->SetValue(true);
CFloatPtr(nodemap.GetNode("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);
// Set the upper limit of the camera's frame rate to 30 fps
Pylon.DeviceSetBooleanFeature(hdev, "AcquisitionFrameRateEnable", true);
Pylon.DeviceSetFloatFeature(hdev, "AcquisitionFrameRateAbs", 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);

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
CBooleanPtr(nodemap.GetNode("AcquisitionFrameRateEnable"))->SetValue(true);
CFloatPtr(nodemap.GetNode("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);
// Set the upper limit of the camera's frame rate to 30 fps
Pylon.DeviceSetBooleanFeature(hdev, "AcquisitionFrameRateEnable", true);
Pylon.DeviceSetFloatFeature(hdev, "AcquisitionFrameRate", 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);

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