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.

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

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.