GetTimestamp
Top  Previous  Next

Description

Returns the timestamp of the last acquired frame in seconds passed since the reboot of your system.


Syntax


[VB]
Value=objActiveDcam.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 ActiveDcam1_FrameAcquired()  
Label1.Caption = ActiveDcam1.GetTimestamp  
End Sub  
 

Remarks


The timestamp of a frame is measured upon the arrival of the frame into the system memory. The precision of timestamps depends on the settings of your sysem clock. It is recommended to use a time synchronization software to synchronize your system clock with public time servers.

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.