Please enable JavaScript to view this site.

IDS Software Suite 4.96.1

Windows_Logo
Linux_Logo

USB 2.0

USB 3.x

GigE

USB 2.0

USB 3.x

GigE

Syntax

INT is_SetFrameRate (HIDS hCam, double FPS, double* newFPS)

Description

Using is_SetFrameRate(), you can set the sensor frame rate in freerun mode (live mode). Since this value depends on the sensor timing, the exposure time actually used may slightly deviate from the value set here. After you have called the function, the actual frame rate is returned through the newFPS parameter.

If the frame rate is set too high, it might not be possible to transfer every single frame. In this case, the effective frame rate may vary from the set value.

For minimum and maximum frame rates as well as other sensor-based dependencies, please refer to Camera and sensor data chapter.

hint_info

Newer driver versions sometimes allow an extended value range for the frame rate setting. We recommend to query the value range every time and set the frame rate explicitly.

Changes to the frame rate affect the value ranges of the exposure time. After executing is_SetFrameRate(), calling the function is_Exposure() is recommended in order to keep the defined camera settings.

hint_info

The use of the following functions will affect the frame rate:

is_PixelClock()

is_SetOptimalCameraTiming()

is_AOI() (if the image size is changed)

is_SetSubSampling()

is_SetBinning()

Changes made to the window size or the read-out timing (pixel clock frequency) also affect the defined frame rate. For this reason, you need to call is_SetFrameRate() again after such changes.

hint_info

To be able to set the default frame rate, you have to set a pixel clock equal to or higher than the default pixel clock.

hint_info

In general, the pixel clock is set once when opening the camera and will not be changed. Note that, if you change the pixel clock, the setting ranges for frame rate and exposure time also changes. If you change a parameter, the following order is recommended:

1.Change pixel clock.

2.Query frame rate range and, if applicable, set new value.

3.Query exposure time range and, if applicable, set new value.

If one parameter is changed, the following parameters have to be adjusted due to the dependencies.

Input parameters

hCam

Camera handle

FPS

Desired frame rate in frames per second (fps)

IS_GET_FRAMERATE

Returns the set frame rate in the newFPS parameter. To query the frame rate actually reached by the camera, use is_GetFramesPerSecond().

IS_GET_DEFAULT_FRAMERATE

Returns the default frame rate.

newFPS

Returns the frame rate actually set.

Return values

IS_INVALID_CAMERA_HANDLE

Invalid camera handle

IS_INVALID_MODE

Camera is in standby mode, function not allowed

IS_INVALID_PARAMETER

One of the submitted parameters is outside the valid range or is not supported for this sensor or is not available in this mode.

IS_NO_SUCCESS

General error message

IS_SUCCESS

Function executed successfully

Related functions

is_GetFramesPerSecond()

is_GetFrameTimeRange()

is_PixelClock()

is_SetOptimalCameraTiming()

is_Exposure()

is_SetAutoParameter()

is_AOI()

is_SetSubSampling()

is_SetBinning()

is_CaptureVideo()

© 2022 IDS Imaging Development Systems GmbH