is_EnableEvent

USB 2.0

USB 3.0

GigE

USB 2.0

USB 3.0

GigE

Syntax

INT is_EnableEvent (HIDS hCam, INT which)

Beschreibung

Mit is_EnableEvent() wird ein Event-Objekt aktiviert. Nach der Freigabe werden die Ereignismeldungen für das angelegte Event-Objekt zugelassen. Hierbei sind je nach Betriebssystem unterschiedliche Funktionen aufzurufen.

Windows

•Event muss vom Anwenderprogramm bereitgestellt werden

•Event muss über is_InitEvent() angemeldet werden

•Event muss über is_EnableEvent() aktiviert werden

•Im Anwender-Programm wird per WaitForSingleObject oder WaitForMultipleObject auf das Event gewartet

•Event wird über is_DisableEvent() deaktiviert

•Event wird über is_ExitEvent() abgemeldet

Linux

•Event wird durch die uEye API bereitgestellt

•Event muss über is_EnableEvent() aktiviert werden

•Über is_WaitEvent() kann auf das Event gewartet werden

•Event wird über is_DisableEvent() deaktiviert

Event-Handling bei Bildern

Wenn Sie das Event-Handling einsetzen, um neue Bilder von der Kamera zu signalisieren, kann es unter hoher Systemlast vorkommen, dass die event-basierte Anwendung nicht für jedes Bild eine Signalisierung erhält. Der Grund hierfür ist, dass das Eventkonzept nicht vorsieht, mehrere Events desselben Typs zu speichern. Wird aufgrund der Systemlast mehr als ein Bild per Event signalisiert, bevor die Anwendung wieder bereit ist (z.B. WaitForSingleObject), so haben Sie keine Möglichkeit diese verpassten Events zu erfassen.

Übergabeparameter

hCam

Handle auf Kamera

ID des freizugebenden Events

IS_SET_EVENT_AUTOBRIGHTNESS_FINISHED	Die automatische Helligkeitsregelung im Run-Once-Modus ist abgeschlossen.
IS_SET_EVENT_AUTOFOCUS_FINISHED	Die automatische Regelung für den Fokus ist abgeschlossen (siehe is_Focus()).
IS_SET_EVENT_CAMERA_MEMORY	Eine Aufnahmen-Iteration im Kamera-Memory-Modus wurde beendet.
IS_SET_EVENT_CAPTURE_STATUS	Es liegt eine Information zur Bilderfassung vor. Diese Information kann über is_CaptureStatus() abgefragt werden. Beachten Sie, dass dieses Event das bisherige IS_SET_EVENT_TRANSFER_FAILED aus vorherigen Versionen ersetzt.
IS_SET_EVENT_CONNECTIONSPEED_CHANGED	Die Verbindungsgeschwindigkeit einer USB 3 uEye Kamera hat sich von USB 2.0 auf USB 3.0 oder von USB 3.0 auf USB 2.0 geändert.
IS_SET_EVENT_DEVICE_PLUGGED_IN	Eine bereits gepairte GigE uEye Kamera wurde wieder mit den Netzwerk verbunden (Voraussetzung: die Kamera wird im Trusted-Pairing-Modus betrieben, siehe is_Configuration()).
IS_SET_EVENT_DEVICE_UNPLUGGED	Eine gepairte GigE uEye Kamera wurde vom Netzwerk getrennt (Voraussetzung: die Kamera wird im Trusted-Pairing-Modus betrieben, siehe is_Configuration()).
IS_SET_EVENT_DEVICE_RECONNECTED	Eine mit is_InitCamera() geöffnete und danach entfernte Kamera wurde wieder eingesteckt.
IS_SET_EVENT_EXTTRIG	Ein Bild, dessen Aufnahme durch einen Trigger ausgelöst wurde, wurde komplett übertragen. Dies ist der frühestmögliche Zeitpunkt für eine neue Aufnahme. Das Bild muss noch das Postprocessing des Treibers durchlaufen und steht nach dem Event IS_FRAME zur Verarbeitung bereit.
IS_SET_EVENT_FIRST_PACKET_RECEIVED	Das erste Datenpaket des Bildes wurde an den PC übertragen. Dies ist der frühestmögliche Zeitpunkt, an dem festgestellt werden kann, ob die Belichtung des Bildes abgeschlossen ist.
IS_SET_EVENT_FRAME	Ein neues Bild steht zur Verfügung.
IS_SET_EVENT_FRAME_RECEIVED	Das Event wird signalisiert, wenn eine neues Bild in der API eingetroffen ist, bevor die Nachbearbeitung durchgeführt wird.
IS_SET_EVENT_NEW_DEVICE	Eine Kamera wurde neu angeschlossen. Unabhängig vom Device Handle (hCam wird ignoriert).
IS_SET_EVENT_OVERLAY_DATA_LOST	Direct3D-/OpenGL-Modus: Durch eine Umprogrammierung sind die Parameter des Overlay ungültig geworden. Das Overlay muss neu gezeichnet werden.
IS_SET_EVENT_PMC_IMAGE_PARAMS_CHANGED	Multicast-Betrieb: Der Master hat Kameraparameter geändert, die sich auf das Datenformat auswirken wie z. B. Bildgröße oder Farbformat. Der Client muss die virtuelle Kamera neu konfigurieren.
IS_SET_EVENT_REMOVAL	Eine Kamera wurde entfernt. Unabhängig vom Device Handle (hCam wird ignoriert).
IS_SET_EVENT_REMOVE	Eine mit is_InitCamera() geöffnete Kamera wurde entfernt.
IS_SET_EVENT_SEQ	Die Sequenz wurde durchlaufen.
IS_SET_EVENT_STATUS_CHANGED	Nur unter Linux: Die Verfügbarkeit einer Kamera hat sich geändert, z.B. eine verfügbare Kamera wurde geöffnet.
IS_SET_EVENT_STEAL	Ein dem Overlay entzogenes Bild steht zur Verfügung.
IS_SET_EVENT_TEMPERATURE_STATUS	Nur USB 3 uEye CP Rev. 2/GigE uEye CP Rev. 2/GigE uEye FA/GigE uEye SE Rev. 4: Der Temperaturstatus der Kamera hat sich geändert, siehe Temperaturstatus abfragen
IS_SET_EVENT_WB_FINISHED	Der automatische Weißabgleich hat seine Regelung beendet.

Rückgabewert

IS_INVALID_CAMERA_HANDLE	Ungültiges Kamera-Handle
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_NO_SUCCESS	Allgemeine Fehlermeldung
IS_SUCCESS	Funktion erfolgreich

Verwandte Funktionen

•is_DisableEvent()

•Nur Windows: is_InitEvent()

•Nur Windows: is_ExitEvent()

•Nur Linux: is_WaitEvent()

Beispiel Windows

HANDLE hEvent = CreateEvent(NULL, FALSE, FALSE, NULL);

is_InitEvent(hCam, hEvent, IS_SET_EVENT_FRAME);

is_EnableEvent(hCam, IS_SET_EVENT_FRAME);

is_FreezeVideo(hCam, IS_DONT_WAIT);

DWORD dwRet = WaitForSingleObject(hEvent, 1000);

if (dwRet == WAIT_TIMEOUT)

{

/* wait timed out */

}

else if (dwRet == WAIT_OBJECT_0)

{

/* event signalled */

}

is_DisableEvent(hCam, IS_SET_EVENT_FRAME);

is_ExitEvent(hCam, IS_SET_EVENT_FRAME);

CloseHandle(hEvent);

Beispiel Linux

is_EnableEvent(hCam, IS_SET_EVENT_FRAME);

is_FreezeVideo(hCam, IS_DONT_WAIT);

INT nRet = is_WaitEvent(hCam, IS_SET_EVENT_FRAME, 1000);

if (nRet == IS_TIMED_OUT)

{

/* wait timed out */

}

else if (nRet == IS_SUCCESS)

{

/* event signalled */

}

is_DisableEvent(hCam, IS_SET_EVENT_FRAME);

Beispielprogramme

•Simple Live (C++)

•uEye Event (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.