 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x 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. 206: is_FreezeVideo() - Aufnahme abbrechen
Für weitere Informationen zu den Bildaufnahmemodi der uEye siehe Vorgehensweise: Bildaufnahme.
Übergabeparameter
hCam |
Handle auf Kamera |
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
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#)
