USB 3 uEye CP Rev. 2 uEye SE USB 3.1 Gen 1	USB 3 uEye CP Rev. 2 uEye SE USB 3.1 Gen 1

Syntax

INT is_Sequencer(HIDS hCam, UINT nCommand, void* pParam, UINT cbSizeOfParams)

Beschreibung

Mit is_Sequencer() konfigurieren und aktivieren Sie den Sequencer-Modus. Im Sequencer-Modus können Sie über Sequencer-Sets unterschiedliche Parameter für die Bildaufnahme definieren, die nacheinander abgearbeitet werden. So können Sie Aufnahmesequenzen bspw. mit unterschiedlichen Belichtungszeiten erstellen. Dadurch sind schnelle Parameterwechsel für die Bildaufnahme möglich.

Jedes Sequencer-Set enthält die folgenden Einstellungen:

•Belichtungszeit

•Verstärkung (Master, Rot, Grün und Blau)

•X- und Y-Position des Bildauschnitts (AOI)

•Blitzeinstellungen

•Angabe des folgenden Sequencer-Sets über einen Sequencer-Pfad

Die Sequencer-Sets werden im Konfigurationsmodus bearbeitet und gespeichert.

Voraussetzungen für die Verwendung des Sequencer-Modus

•Der Sequencer-Modus wird nur im Trigger-Modus unterstützt.

•Der Sequencer-Modus muss aktiviert werden, bevor die Bildaufnahme gestartet wird.

•Der interne Kamera-Bildspeicher muss aktiviert sein.

•Die folgenden Funktionen können nicht in Verbindung mit dem Sequencer-Modus verwendet werden: Multi-AOI-Funktion, Sequenz-AOI-Modus und IDS LInescan ("AOI-Merge-Modus").

Der Sequencer-Modus wird nicht vom Kameramodell UI-359xCP Rev. 2 unterstützt.

Über den Übergabeparameter nCommand wird dabei der Funktionsmodus gewählt. Der Übergabeparameter pParam ist abhängig vom Funktionsmodus unterschiedlich belegt; bei Funktionen zum Setzen oder Rücklesen eines Wertes enthält pParam einen Zeiger auf eine Variable vom Typ UINT. Die Größe des Speicherbereichs, auf den pParam verweist, wird im Übergabeparameter cbSizeOfParam angegeben.

Übergabeparameter

hCam	Handle auf Kamera
nCommand IS_SEQUENCER_MODE_ENABLED_GET Gibt zurück, ob der Sequencer-Modus aktiv ist. •1 = Sequencer-Modus ist aktiv. •0 = Sequencer-Modus ist nicht aktiv. IS_SEQUENCER_MODE_ENABLED_SET Aktiviert oder deaktiviert den Sequencer-Modus. Der Sequencer-Modus kann erst aktiviert werden, wenn mindestens ein Sequencer-Set gespeichert wurde. •1 = Aktiviert den Sequencer-Modus. •0 = Deaktiviert den Sequencer-Modus. IS_SEQUENCER_CONFIGURATION_ENABLED_GET Gibt zurück, ob der Konfigurationsmodus aktiv ist. •1 = Der Konfigurationsmodus ist aktiv. •0 = Der Konfigurationsmodus ist nicht aktiv. IS_SEQUENCER_CONFIGURATION_ENABLED_SET Aktiviert oder deaktiviert den Konfigurationsmodus. •1 = Aktiviert den Konfigurationsmodus. •0 = Deaktiviert den Konfigurationsmodus. IS_SEQUENCER_MODE_SUPPORTED_GET Gibt zurück, ob der Sequencer-Modus von der Kamera unterstützt wird. •1 = Sequencer-Modus wird unterstützt. •0 = Sequencer-Modus wird nicht unterstützt. IS_SEQUENCER_RESET Setzt den Sequencer-Modus zurück. IS_SEQUENCER_SET_SAVE Speichert die aktuelle Parameter für das gewählte Sequencer-Set. Der Konfigurationsmodus muss aktiviert sein. IS_SEQUENCER_SET_START_GET Gibt das erste Sequencer-Set zurück, mit dem der Sequencer gestartet wird. IS_SEQUENCER_SET_START_SET Setzt das erste Sequencer-Set, mit dem der Sequencer gestartet wird. Der Konfigurationsmodus muss aktiviert sein. •Wertebereich: 0…31 IS_SEQUENCER_SET_SELECTED_GET Gibt das aktuelle Sequencer-Set zurück, für das weitere Einstellungen vorgenommen werden. •Wertebereich: 0…31 IS_SEQUENCER_SET_SELECTED_SET Setzt das Sequencer-Set, für das weitere Einstellungen vorgenommen werden. •Wertebereich: 0…31 IS_SEQUENCER_SET_MAX_COUNT_GET Liefert die maximale Anzahl an möglichen Sets zurück IS_SEQUENCER_PATH_MAX_COUNT_GET Liefert die maximale Anzahl an möglichen Pfade pro Set zurück IS_SEQUENCER_SET_PATH_GET Gibt die Konfiguration des Sequencer-Pfads für das gewählte Sequencer-Set zurück. Siehe IS_SEQUENCER_PATH IS_SEQUENCER_SET_PATH_SET Setzt die Konfiguration des Sequencer-Pfads für das gewählte Sequencer-Set. Der Konfigurationsmodus muss aktiviert sein. Siehe IS_SEQUENCER_PATH IS_SEQUENCER_TRIGGER_SOURCE_SUPPORTED_GET Gibt eine Liste der unterstützten Triggerquellen zurück. Siehe IS_SEQUENCER_PATH (Beispiel 3) IS_SEQUENCER_FEATURE_SELECTED_GET Gibt den gewählten Parameter zurück, der über den Sequencer gesteuert wird. IS_SEQUENCER_FEATURE_SELECTED_SET Setzt den Parameter, der über den Sequencer gesteuert wird. IS_SEQUENCER_FEATURE_ENABLED_GET Gibt zurück, ob der gewählte Parameter aktiv ist. •1 = Parameter ist aktiv. •0 = Parameter ist nicht aktiv. IS_SEQUENCER_FEATURE_ENABLED_SET Aktiviert oder deaktiviert den gewählten Parameter und übernimmt die Einstellung für alle Sequencer-Sets. Der Konfigurationsmodus muss aktiviert sein. •1 = Aktiviert den Parameter. •0 = Deaktiviert den Parameter. IS_SEQUENCER_FEATURE_SUPPORTED_GET Gibt eine Bitmaske mit den unterstützten Parametern zurück: •IS_FEATURE_EXPOSURE: Belichtungszeit in Millisekunden(DOUBLE) Beachten Sie, dass der mögliche Bereich für die Belichtungszeit durch den Pixeltakt und die Bildrate bestimmt wird. Bei niedrigen Bildraten sind hohe Belichtungszeiten möglich, bei hohen Bildraten verkürzt sich die maximal mögliche Belichtungszeit. •IS_FEATURE_GAIN: Verstärkung in Prozent (IS_SEQUENCER_GAIN_CONFIGURATION) •IS_FEATURE_AOI_OFFSET_X: Offset für die X-Position der AOI (INT32) •IS_FEATURE_AOI_OFFSET_Y: Offset für die Y-Position der AOI (INT32) •IS_FEATURE_FLASH: Blitzeinstellungen (IS_SEQUENCER_FLASH_CONFIGURATION, Beispiel 2) IS_SEQUENCER_FEATURE_VALUE_GET Gibt den gespeicherten Wert für den gewählten Parameter zurück. IS_SEQUENCER_CONFIGURATION_SAVE Speichert die aktuelle Sequencer-Konfiguration in der angegebenen Datei. IS_SEQUENCER_CONFIGURATION_LOAD Lädt eine Sequencer-Konfiguration aus der angegebenen Datei.
pParam	Zeiger auf Funktionsparameter, der abhängig von nCommand unterschiedlich belegt ist.
cbSizeOfParam	Größe des Speicherbereichs in Byte, auf den pParam verweist.

Inhalte der Struktur IS_SEQUENCER_PATH

Inhalte der Struktur IS_SEQUENCER_GAIN_CONFIGURATION

Inhalte der Struktur IS_SEQUENCER_FLASH_CONFIGURATION

Rückgabewerte

Verwandte Funktionen

•is_GetImageInfo()

Beispiel 1

/* Enable sequencer configuration */
int enableConfiguration = 1;
nRet = is_Sequencer(hCam, IS_SEQUENCER_CONFIGURATION_ENABLED_SET, &enableConfiguration, sizeof(enableConfiguration));
 
/* Select feature and enable it */
/* Select feature */
int64_t feature = IS_FEATURE_EXPOSURE;
nRet = is_Sequencer(hCam, IS_SEQUENCER_FEATURE_SELECTED_SET, &feature, sizeof(feature));
 
/* Enable feature */
int enableFeature = 1;
nRet = is_Sequencer(hCam, IS_SEQUENCER_FEATURE_ENABLED_SET, &enableFeature, sizeof(enableFeature));
 
/* Select the set */
selectedSet = 0;
nRet = is_Sequencer(hCam, IS_SEQUENCER_SET_SELECTED_SET, &selectedSet, sizeof(selectedSet));
 
/* Set exposure value */
nRet = is_Exposure(hCam, IS_EXPOSURE_CMD_SET_EXPOSURE, &exposureValue, sizeof(exposureValue));
 
/* Set path configuration */
IS_SEQUENCER_PATH path = { 0, 1, IS_TRIGGER_SOURCE_FRAME_END, 0 };
nRet = is_Sequencer(hCam, IS_SEQUENCER_SET_PATH_SET, &path, sizeof(path));
 
/* Save configuration for the selected set */
nRet = is_Sequencer(hCam, IS_SEQUENCER_SET_SAVE, 0, 0);
 
/* Disable configuration mode */
enableConfiguration = 0;
nRet = is_Sequencer(hCam, IS_SEQUENCER_CONFIGURATION_ENABLED_SET, &enableConfiguration, sizeof(enableConfiguration));
 
/* Enable sequencer mode */
int enableSequencer = 1;
nRet = is_Sequencer(hCam, IS_SEQUENCER_MODE_ENABLED_SET, &enableSequencer, sizeof(enableSequencer));

Beispiel 2

/* Flash value example */
 
/* Select flash feature */
int64_t feature = IS_FEATURE_FLASH;
nRet = is_Sequencer(hCam, IS_SEQUENCER_FEATURE_SELECTED_SET, &feature, sizeof(feature));
 
/* Get flash configuration */
IS_SEQUENCER_FLASH_CONFIGURATION flashConfiguration;
nRet = is_Sequencer(hCam, IS_SEQUENCER_FEATURE_VALUE_GET, &flashConfiguration, sizeof(flashConfiguration));

Beispiel 3

INT nSupportedTriggerSource = 0;
int nRet = is_Sequencer(hCam, IS_SEQUENCER_TRIGGER_SOURCE_SUPPORTED_GET, &nSupportedTriggerSource, sizeof(nSupportedTriggerSource));
if ((nSupportedTriggerSource & IS_TRIGGER_SOURCE_FRAME_END) == IS_TRIGGER_SOURCE_FRAME_END)
{
// Trigger source 'IS_TRIGGER_SOURCE_FRAME_END' is supported
}
if ((nSupportedTriggerSource & IS_TRIGGER_SOURCE_EXPOSURE_END) == IS_TRIGGER_SOURCE_EXPOSURE_END)
{
// Trigger source 'IS_TRIGGER_SOURCE_EXPOSURE_END' is supported
}