GetFPS

Description

Returns the current frame rate of the camera in frames per second.


Syntax

[VB]
Value=objActiveDcam.GetFPS

[C/C++]
HRESULT GetFPS(float* pValue);


Data Types [VB]

Return value: Single


Parameters [C/C++]

pValue [out,retval]

Pointer to the fps value

Return Values

S_OK

Success

E_FAIL

Failure.

Example

This VB example displays the actual frame rate of the camera.

Private Sub ActiveDcam1_FrameAcquired()

Label1.Caption = ActiveDcam1.GetFPS

End Sub

Remarks

This method measures the frame rate based on the arrival of frames into the system memory. The IEEE-1394 bus is using DMA (Direct Memory Access) for the data transfer which delivers the frames into RAM without the CPU involvement. However, a heavy CPU and data load on the system bus can theoretically disrupt the DMA or time measurements and cause the fps value measured by GetFPS to deviate from the actual camera frame rate.