IDS Software Suite 4.96.1

Syntax

INT is_GetImageInfo (HIDS hCam, INT nMemId, UEYEIMAGEINFO *pImageInfo, INT nImageInfoSize)

Description

is_GetImageInfo() provides additional information on the images you take. The function returns a timestamp indicating the time of image capture, and the states of the camera I/Os at that point in time. To get information on the last image that was taken, call is_GetImageInfo() directly after receiving the IS_SET_EVENT_FRAME event.

Using the function with GigE and USB 3 uEye cameras

The UEYEIMAGEINFO structure returns the camera timestamp u64TimestampDevice, which indicates the time of image capture with a resolution of 0.1 μs. The time of image capture is defined as:

•The time when a (hardware or software) trigger event is received by the camera in trigger mode. The delay between the receipt of the trigger signal and the start of exposure depends on the sensor.

•The time when the sensor starts to output image data in freerun mode (see also How to proceed: Image capture). A rolling shutter sensors starts to output image data after exposure of the first row. With a global shutter sensor, image data is output after exposure of all rows.

The UEYETIME structure returns a timestamp with a resolution of 1 ms. The timestamp is synchronized with the PC's system time, and resynchronized every 60 seconds. This may cause minor time shifts in the value passed in UEYETIME (average time about 3 ms).

To determine the exact interval between two image captures, it is therefore recommended to read out the camera timestamp u64TimestampDevice.

Using the function with USB 2 uEye cameras, USB 3 uEye CP Rev. 1 and USB 3 uEye LE cameras (from version 4.82 on)

The u64TimestampDevice timestamp returns the time when image data transfer to the PC was completed.

The UEYETIME structure returns the timestamp (with a resolution of 1 ms) synchronized with the PC system time.

For the normal trigger mode (without overlapping trigger), the following formula can be used to calculate approximately the time stamp for the start of image acquisition:

u64TimestampDevice -= static_cast<uint64_t>((frametime_inc * static_cast<double>(aoi.s32Height) * 10000000.0) + (exposure * 10000.0));

Input parameters

Contents of the UEYEIMAGEINFO structure

Status flags in UEYEIMAGEINFO::dwIoStatus

Contents of the UEYEIMAGEINFO::UEYETIME structure

Return values

Related functions

•is_CaptureStatus()

•is_LockSeqBuf()

•is_UnlockSeqBuf()

•is_SetImageMem()

•is_IO()

•is_DeviceFeature()

Example

UEYEIMAGEINFO ImageInfo;
// Read out camera timestamp
INT nRet = is_GetImageInfo( m_hCam, m_lMemoryId, &ImageInfo, sizeof(ImageInfo));
if (nRet == IS_SUCCESS)
{
unsigned long long u64TimestampDevice;
  u64TimestampDevice = ImageInfo.u64TimestampDevice;  
 
CString Str; // Read out timestamp in system time
Str.Format("%02d.%02d.%04d, %02d:%02d:%02d:%03d",
        ImageInfo.TimestampSystem.wDay,
        ImageInfo.TimestampSystem.wMonth,
        ImageInfo.TimestampSystem.wYear,
        ImageInfo.TimestampSystem.wHour,
        ImageInfo.TimestampSystem.wMinute,
        ImageInfo.TimestampSystem.wSecond,
        ImageInfo.TimestampSystem.wMilliseconds);
 
DWORD dwTotalBuffers = ImageInfo.dwImageBuffers;
DWORD dwUsedBuffers = ImageInfo.dwImageBuffersInUse;
}

Sample Program

•uEyeTimestamp (C++)