USB 2.0 USB 3.0 GigE	USB 2.0 USB 3.0 GigE

Syntax

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

Beschreibung

is_GetImageInfo()liefert zusätzliche Informationen zu aufgenommenen Bildern. Es werden ein Zeitstempel mit dem Zeitpunkt der Bildaufnahme sowie die Zustände der Ein-/Ausgänge der Kamera zu diesem Zeitpunkt zurückgegeben. Um Informationen zu einem gerade aufgenommenen Bild abzufragen, kann is_GetImageInfo() direkt nach dem Eintreffen des IS_FRAME-Events aufgerufen werden.

Verwendung bei GigE und USB 3 uEye Kameras

Die Struktur UEYEIMAGEINFO gibt den kamerainternen Zeitstempel u64TimestampDevice zurück, der den Zeitpunkt der Bildaufnahme mit einer Auflösung von 0,1 μs angibt. Als Zeitpunkt der Bildaufnahme ist definiert:

•Im getriggerten Modus der Eingang des Triggerereignisses (Hardware- oder Softwaretrigger) an der Kamera. Die Verzögerung zwischen dem Eingang des Triggersignals und dem Beginn der Belichtung ist sensorabhängig.

•Im freilaufenden Modus der Zeitpunkt, an dem der Sensor beginnt, Bilddaten auszugeben (siehe auch Vorgehensweise: Bildaufnahme). Ein Rolling-Shutter-Sensor gibt nach Belichtung der ersten Zeile Bilddaten aus. Ein Global-Shutter-Sensor gibt nach Belichtung aller Zeilen Bilddaten aus.

Die Struktur UEYETIME gibt einen auf die PC-Systemzeit synchronisierten Zeitstempel mit einer Auflösung von 1 ms zurück. Dieser Zeitstempel wird in 60-Sekunden-Intervallen neu synchronisiert. Dadurch können leichte Sprünge in der über UEYETIME übergebenen Zeit auftreten (durchschnittlich ca. 3 ms).

Zur genauen Bestimmung von Intervallen zwischen zwei Aufnahmen sollte daher der kamerainterne Zeitstempel u64TimestampDevice verwendet werden.

Verwendung bei USB 2 uEye Kameras, USB 3 uEye CP Rev. 1 und USB 3 uEye LE Kameras (ab Version 4.82)

Der Zeitstempel u64TimestampDevice gibt den Zeitpunkt an, zu dem die Übertragung der Bilddaten in den PC abgeschlossen ist.

Die Struktur UEYETIME gibt den Zeitstempel als synchronisierte PC-Systemzeit mit einer Auflösung von 1 ms zurück.

Für den normalen Triggermodus (ohne verzahntes Triggern) kann mit folgender Formel annähernd der Zeitstempel auf den Start der Bildaufnahme zurückgerechnet werden:

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

Bildspeicher in einer Sequenz müssen mit is_LockSeqBuf() gelockt werden, damit die Zuordnung zwischen Bilddaten und Bildinformationen gewährleistet ist. Andernfalls kann es vorkommen, dass ein Bildspeicher mit neuen Bilddaten gefüllt wird. Die Bildinformationen stimmen in diesem Fall nicht mehr mit den Bilddaten überein.

Übergabeparameter

Inhalt der Struktur UEYEIMAGEINFO

Statusflags in UEYEIMAGEINFO::dwIoStatus

Inhalt der Struktur UEYEIMAGEINFO::UEYETIME

Rückgabewert

Verwandte Funktionen

•is_CaptureStatus()

•is_LockSeqBuf()

•is_UnlockSeqBuf()

•is_SetImageMem()

•is_IO()

•is_DeviceFeature()

Beispiel

UEYEIMAGEINFO ImageInfo;
// Zeitstempel der Kamera auslesen
INT nRet = is_GetImageInfo( hCam,
          m_lMemoryId, &ImageInfo, sizeof(ImageInfo));
if (nRet == IS_SUCCESS)
{
unsigned long long u64TimestampDevice;
  u64TimestampDevice = ImageInfo.u64TimestampDevice;  
 
CString Str; // Zeitstempel in Systemzeit auslesen
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;
}

Beispielprogramme

•uEye Timestamp (C++)