is_FreezeVideo

USB 2.0

USB 3.0

GigE

USB 2.0

USB 3.0

GigE

Syntax

INT is_FreezeVideo (HIDS hCam, INT Wait)

Beschreibung

is_FreezeVideo() zieht ein Einzelbild von der Kamera ein. Im DIB-Modus wird das Bild im aktiven Bildspeicher abgelegt. Wird im DIB-Modus mit Ringbuffering gearbeitet, so erfolgt die Bildaufnahme in den nächsten nicht gesperrten Bildspeicher der Sequenz. Sobald der letzte nicht gesperrte Sequenzspeicher gefüllt wurde, wird das Sequenz-Event bzw. die Sequenz-Message ausgelöst.

Hinweis: Die Funktion is_FreezeVideo() wird nicht für mehrfache oder kontinuierliche Aufnahmen empfohlen. Verwenden Sie stattdessen die Funktion is_CaptureVideo().

Im Direct3D- oder OpenGL-Modus wird das Bild direkt in die Grafikkarte kopiert und dargestellt.

Die Bildaufnahme erfolgt getriggert, wenn der Triggermodus mit is_SetExternalTrigger() aktiviert wurde. Eine hardwaregetriggerte Aufnahme kann mit is_StopLiveVideo() abgebrochen werden, wenn das Bild noch nicht belichtet wurde. Wenn Sie is_FreezeVideo() mit dem Parameter IS_WAIT aufgerufen haben, müssen Sie mit is_ForceTrigger() ein Triggersignal simulieren, um die Aufnahme abzubrechen.

Abb. 216: is_FreezeVideo() - Aufnahme abbrechen

Für weitere Informationen zu den Bildaufnahmemodi der uEye siehe Vorgehensweise: Bildaufnahme.

Übergabeparameter

hCam

Handle auf Kamera

Hinweis zu UI-3013XC

Das Kameramodell UI-3013XC unterstützt nicht den Parameter IS_DONT_WAIT. Bei einem Aufruf von IS_DONT_WAIT wird der Rückgabewert IS_NOT_SUPPORTED zurückgegeben.

Rückgabewert

3 = IS_CAPTURE_STATUS	Beim Datentransfer trat ein Fehler auf, siehe is_CaptureStatus(). Der Parameter IS_CAPTURE_STATUS ersetzt den bisherigen Parameter IS_TRANSFER_FAILED. Der Parameter IS_TRANSFER_FAILED wurde in die neue Header-Datei ueye_deprecated.h verschoben, die alle veralteten Funktionsdefinitionen und Konstanten enthält. Falls Bedarf besteht, kann die Header-Datei ueye_deprecated.h zusätzlich zu ueye.h eingebunden werden.
IS_BAD_STRUCTURE_SIZE	Eine interne Struktur hat die falsche Größe.
IS_CANT_COMMUNICATE_WITH_DRIVER	Kommunikation mit dem Kameratreiber schlug fehl, weil kein Treiber geladen ist.
IS_CAPTURE_RUNNING	Es läuft bereits eine Aufnahme, die zuerst beendet werden muss.
IS_INVALID_BUFFER_SIZE	Der Bildspeicher hat die falsche Größe um das Bild im gewünschten Format aufzunehmen.
IS_INVALID_CAMERA_TYPE	Kameratyp der .ini-Datei stimmt nicht mit dem aktuellen Kameramodell überein.
IS_INVALID_EXPOSURE_TIME	Diese Einstellung ist bei der aktuell eingestellten Belichtungszeit nicht möglich.
IS_INVALID_CAMERA_HANDLE	Ungültiges Kamera-Handle
IS_INVALID_MEMORY_POINTER	Ungültiger Zeiger oder ungültige Speicher-ID
IS_INVALID_PARAMETER	Einer der übergebenen Parameter ist außerhalb des gültigen Bereichs, oder für diesen Sensor nicht unterstützt, bzw. in diesem Modus nicht zugänglich.
IS_IO_REQUEST_FAILED	Eine IO Anforderung des uEye Treibers schlug fehl. Eventuell passen die Versionen der Dateien ueye_api.dll (API) und ueye_usb.sys bzw. ueye_eth.sys (Treiber) nicht zusammen.
IS_NO_ACTIVE_IMG_MEM	Kein aktivierter Bildspeicher vorhanden. Der Speicher muss mit der Funktion is_SetImageMem() aktiviert werden, oder es muss mit der Funktion is_AddToSequence() eine Sequenz aufgebaut werden.
IS_NO_USB20	Die Kamera ist an einem Port verbunden, der USB 2.0 nicht unterstützt.
IS_NO_SUCCESS	Allgemeine Fehlermeldung
IS_NOT_CALIBRATED	Die Kamera enthält keine Kalibrierungsdaten.
IS_NOT_SUPPORTED	Das verwendete Kameramodell unterstützt diese Funktion oder Einstellung nicht.
IS_OUT_OF_MEMORY	Es konnte kein Speicher alloziert werden.
IS_TIMED_OUT	Ein Timeout trat auf. Eine Bildaufnahme konnte nicht in der vorgeschriebenen Zeit beendet werden.
IS_SUCCESS	Funktion erfolgreich
IS_TRANSFER_ERROR	Übertragungsfehler. Permanente Übertragungsfehler können häufig durch eine Verringerung des Pixeltaktes behoben werden.

Verwandte Funktionen

•is_HasVideoStarted()

•is_IsVideoFinish()

•is_SetExternalTrigger()

Beispiel

Triggermodus einschalten, High-Active Blitzmodus setzen und Bild aufnehmen:

is_SetExternalTrigger(hCam, IS_SET_TRIGGER_SOFTWARE);

// Set the flash to a high active pulse for each image in the trigger mode

UINT nMode = IO_FLASH_MODE_TRIGGER_HI_ACTIVE;

is_IO(m_hCam, IS_IO_CMD_FLASH_SET_MODE, (void*)&nMode, sizeof(nMode));

is_FreezeVideo(hCam, IS_WAIT);

Beispielprogramme

•Simple Acquire (C++)

•uEye C# Demo (C#)

Haben Sie Verbesserungshinweise? Senden Sie ein kurzes Feedback zu diesem Kapitel. Vielen Dank!
Bei technischen Fragen wenden Sie sich bitte an Ihren lokalen Händler oder nutzen Sie das Support-Formular auf unserer Internetseite.