GetFPS
Top  Previous  Next

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.