 |
 |
|---|---|
USB 2.0 USB 3.x GigE |
USB 2.0 USB 3.x GigE |
Syntax
INT is_SetExternalTrigger (HIDS hCam, INT nTriggerMode)
Beschreibung
is_SetExternalTrigger() aktiviert den Triggermodus. Falls die Kamera sich im Standby befindet, verlässt sie diesen Modus und aktiviert den Triggermodus. Beachten Sie, dass durch is_SetExternalTrigger() eine bereits laufende Bildaufnahme beendet wird. Sie müssen deshalb nach dem Aufruf von is_SetExternalTrigger() die Bildaufnahme wieder starten.
Im Hardware-Triggermodus wird bei jedem Aufruf der Funktion mit der Bildaufnahme gewartet, bis das ausgewählte Triggerereignis stattgefunden hat.
Im Software-Triggermodus wird bei einem Aufruf von is_FreezeVideo() sofort ein Bild aufgenommen oder beim Aufruf von is_CaptureVideo() eine kontinuierliche getriggerte Aufnahme gestartet. Im Hardware-Triggermodus kann mit dem Befehl is_ForceTrigger() auch ohne elektrisches Signal eine Bildaufnahme ausgelöst werden.
Wenn die Triggerfunktionalität ausgeschaltet wird, kann der Pegel am Triggereingang abgefragt werden. Bei dieser Option wechselt die Kamera in den Freerun-Modus.
Für weitere Informationen zu den Bildaufnahmemodi der uEye siehe Vorgehensweise: Bildaufnahme.
|
Bei den Platinenversionen der USB uEye LE kann hardwarebedingt nur auf die fallende Flanke getriggert werden. Die Modelle UI-122xLE Rev. 2 und UI-154xLE Rev. 2 können sowohl auf die steigende als auch auf die fallende Flanke getriggert werden. |
|
USB uEye XS besitzen keinen I/O-Anschluss. Die Funktion is_SetExternalTrigger() kann für UI-1007XS nur in Verbindung mit dem Software-Trigger verwendet werden. |
Übergabeparameter
hCam |
Handle auf Kamera |
|---|---|
Rückgabewert
In Verbindung mit |
Gibt die aktuelle Einstellung zurück. |
In Verbindung mit |
Gibt den aktuellen Pegel am Triggereingang zurück |
In Verbindung mit |
Gibt die unterstützten Modi logisch verodert zurück |
IS_INVALID_CAPTURE_MODE |
Die Funktion kann im aktuellen Betriebsmodus der Kamera (Freilaufend, Trigger oder Standby) nicht ausgeführt werden. |
IS_INVALID_CAMERA_HANDLE |
Ungültiges Kamera-Handle |
IS_NO_SUCCESS |
Allgemeine Fehlermeldung |
IS_SUCCESS |
Funktion erfolgreich |
Verwandte Funktionen
Beispiel
//Enable trigger mode and set high-active flash mode.
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
•uEye Simple Trigger (C++)
•uEye IO (C++)
