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.

In this topic Hide

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:

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 AcquisitionFrameRateAbsAcquisitionFrameRate parameter to the desired upper limit for the camera's frame rate in frames per second.

Specifics

Camera Model

AcquisitionFrameRateEnable Parameter Available

All ace 2 GigE camera models Yes
All ace 2 USB 3.0 camera models Yes
All ace USB 3.0 camera models Yes
All ace GigE camera models Yes
All boost CXP-12 camera models Yes
All dart BCON for LVDS camera models No
All dart BCON for MIPI cameras models No
All dart USB 3.0 camera models No
All pulse USB 3.0 camera models No

Sample Code

// Set the upper limit of the camera's frame rate to 30 fps
camera.AcquisitionFrameRateEnable.SetValue(true);
camera.AcquisitionFrameRateAbs.SetValue(30.0);
// 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("AcquisitionFrameRateAbs"))->SetValue(30.0);
// 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);
// 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
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, "AcquisitionFrameRateAbs", 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, "AcquisitionFrameRateAbs", 30.0);
CHECK(errRes);
/* 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.