GetTimestamp
Top  Previous  Next

Description

Returns the timestamp of the last acquired frame in seconds.


Syntax


[VB]
Value=objActiveGige.GetTimestamp


[C/C++]
HRESULT GetTimestamp(double* pValue);


Data Types
[VB]

Return value: Double


Parameters
[C/C++]

pValue [out,retval]  
Pointer to the timestamp value  


Return Values


S_OK  
Success  
E_FAIL  
Failure.  

Example


This VB example displays the timestamp value of each frame in a text box.

Private Sub ActiveGige1_FrameAcquired()  
Label1.Caption = ActiveGige1.GetTimestamp  
End Sub  
 

Remarks


If your GigE Vision™ camera support the timestamp function, it will mark each frame with a very accurate time value indicating the precise moment at which the frame was acquired by the camera relative to the moment at which the camera was powered up. Timestamps can be used to imprint a text with the timeline information into images during the AVI capture.

If this method is used in the FrameAcquired event handler, it must be called immediately after the event has been received. This will guarantee that the value of the timestamp will not be taken from the next frame while the current frame is being processed.

If the camera doesn't support timestamps, this method will return zero.