 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_CaptureVideo (HIDS hCam, INT Wait)
Beschreibung
is_CaptureVideo() aktiviert den Livemodus (freilaufender Modus, freerun) der Kamera. Der Treiber überträgt die Bilder in einen zuvor allozierten Bildspeicher oder unter Direct3D/OpenGL in die Grafikkarte. Die Bilddaten (DIB Mode) werden in den Speicher abgelegt, der mit is_AllocImageMem() angelegt und mit is_SetImageMem() als aktiver Bildspeicher bestimmt wurde. Über die Funktion is_GetImageMem() lässt sich die Speicheradresse abfragen.
Wird mit Ringbuffering gearbeitet, so durchläuft die Bildaufnahme alle in die Sequenz aufgenommenen Bildspeicher in einer Endlosschleife. Mit is_LockSeqBuf() gesperrte Sequenzspeicher werden übersprungen. Wenn der letzte nicht gesperrte Sequenzspeicher gefüllt wurde, wird das Sequenz-Event bzw. die Sequenz-Message ausgelöst. Die Aufnahme beginnt immer mit dem ersten Element der Sequenz.
Im Trigger-Modus wird die Kamera beim Aufruf von is_CaptureVideo() in eine fortlaufende Triggerbereitschaft versetzt. Auf jedes elektrische Triggersignal hin wird ein Bild aufgenommen, die Kamera befindet sich danach wieder in Triggerbereitschaft.
Für weitere Informationen zu den Bildaufnahmemodi siehe Vorgehensweise: Bilderfassung.
Übergabeparameter
hCam |
Handle auf Kamera |
Rückgabewert
In Verbindung mit IS_GET_LIVE |
TRUE wenn Live-Aufnahme aktiv |
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_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_SUCCESS |
Funktion erfolgreich |
IS_TIMED_OUT |
Ein Timeout trat auf. Eine Bildaufnahme konnte nicht in der vorgeschriebenen Zeit beendet werden. |
IS_TRIGGER_ACTIVATED |
Die Funktion ist nicht möglich, da die Kamera auf ein Triggersignal wartet. |
Verwandte Funktionen
Beispielprogramme
•SimpleLive (C++)
•uEye C# Demo (C#)
