USB 2.0 USB 3.0 GigE	USB 2.0 USB 3.0 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.

Die Kameramodelle USB 3 uEye XC und USB uEye XS besitzen keinen I/O-Anschluss. Die Funktion is_SetExternalTrigger() kann für die USB 3 uEye XC nur in Verbindung mit dem Software-Trigger verwendet werden. Die USB uEye XS unterstützt keine Trigger-Funktion.

Übergabeparameter

hCam

Handle auf Kamera

nTriggerMode   Triggermodus Triggerereignis IS_SET_TRIGGER_OFF Aus - IS_SET_TRIGGER_HI_LO Hardwaretrigger Aktiviert im Memory-Modus den Post-Trigger Fallende Signalflanke IS_SET_TRIGGER_LO_HI Hardwaretrigger Aktiviert im Memory-Modus den Post-Trigger Steigende Signalflanke IS_SET_TRIGGER_PRE_HI_LO Aktiviert im Memory-Modus den Pre-Trigger Fallende Signalflanke IS_SET_TRIGGER_PRE_LO_HI Aktiviert im Memory-Modus den Pre-Trigger Steigende Signalflanke IS_SET_TRIGGER_HI_LO_SYNC Freerun-Sync./Hardwaretrigger Der Modus Freerun-Synchronisation wird derzeit nur von den Kameramodellen UI-146x/UI-546x unterstützt. Fallende Signalflanke IS_SET_TRIGGER_LO_HI_SYNC Freerun-Sync./Hardwaretrigger Der Modus Freerun-Synchronisation wird derzeit nur von den Kameramodellen UI-146x/UI-546x unterstützt. Steigende Signalflanke IS_SET_TRIGGER_SOFTWARE Softwaretrigger Aufruf von is_FreezeVideo() (Einzelbild) Aufruf von is_CaptureVideo() (Kontinuierlich) IS_GET_EXTERNALTRIGGER Triggermodus-Einstellung zurücklesen IS_GET_TRIGGER_STATUS Gibt den aktuellen Pegel am Triggereingang zurück. IS_GET_SUPPORTED_TRIGGER_MODE Gibt die unterstützten Triggermodi zurück.

Rückgabewert

Verwandte Funktionen

•is_CaptureVideo()

•is_FreezeVideo()

•is_ForceTrigger()

•is_SetTriggerDelay()

•is_IO()

•is_Trigger()

•is_TriggerDebounce()

•is_Transfer()

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++)