Resulting Frame Rate

The Resulting Frame Rate camera feature allows you to determine the estimated frame rate with the current camera settings.

This is useful, for example, if you want to know how long you have to wait between triggers.

The frame rate is expressed in frames per second (fps).

In this topic Hide

Using the Feature

Why Check the Resulting Frame Rate

Optimizing the Frame Rate

When the camera is configured for free run image acquisition and continuous acquisition, knowing the resulting frame rate is useful if you want to optimize the frame rate for your imaging application. You can adjust the camera settings limiting the frame rate until the resulting frame rate reaches the desired value.

Optimizing Triggered Image Acquisition

When the camera is configured for triggered image acquisition, knowing the resulting frame rate is useful if you want to trigger the camera as often as possible without overtriggering. You can calculate how long you must wait after each trigger signal by taking the reciprocal of the resulting frame rate: 1 / Resulting Frame Rate.

Example: If the resulting frame rate is 12.5, you must wait for a minimum of 1/12.5 = 0.08 seconds after each trigger signal. Otherwise, the camera ignores the trigger signal and generates a Frame Start Overtrigger event.

Checking the Resulting Frame Rate

To check the resulting frame rate, i.e., the estimated frame rate with the current camera settings, read the value of the ResultingFrameRateAbsResultingFrameRate parameter. The value is expressed in frames per second (fps).

The parameter value takes all factors limiting the frame rate into account.

Factors Limiting the Frame Rate

Several factors may limit the frame rate on any Basler camera:

External Links

Sample Code

// Get the resulting frame rate
double d = camera.ResultingFrameRate.GetValue();
INodeMap& nodemap = camera.GetNodeMap();
// Get the resulting frame rate
double d = CFloatPtr(nodemap.GetNode("ResultingFrameRate"))->GetValue();
// Get the resulting frame rate
double d = camera.Parameters[PLCamera.ResultingFrameRate].GetValue();
// Get the resulting frame rate
double d = Pylon.DeviceGetFloatFeature(hdev, "ResultingFrameRate");
/* 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 */
double d = 0;
/* Get the resulting frame rate */
errRes = PylonDeviceGetFloatFeature(hdev, "ResultingFrameRate", &d);
CHECK(errRes);

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