Please enable JavaScript to view this site.

IDS Software Suite 4.96.1

Windows_Logo
Linux_Logo

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)

Description

Using is_Sequencer(), you configure and activate the sequencer mode. In sequencer mode, you can define different parameters for image acquisition via sequencer sets that are processed one after another. For example, you can create imaging sequences with different exposure times. Therefore, fast parameter changes are possible.

Each sequencer set has the following settings:

Exposure time

Gain (master, red, green and blue)

X and Y position of the area of interest (AOI)

Flash settings

Reference to the following sequencer set using a sequencer path

The sequencer sets are edited and saved in configuration mode.

Conditions for the use of the sequencer mode

The sequencer mode is supported in trigger mode only.

The sequencer mode must be activated before the image acquisition starts.

The internal image memory must be activated.

The following functions cannot be used in combination with the sequencer mode: multi AOI function, sequence AOI mode, and IDS line scan (AOI merge mode).

hint_info

The sequencer mode is not supported by the UI-359xCP Rev.2 camera model.

The nCommand input parameter is used to select the function mode. The pParam input parameter depends on the selected function mode. If you select functions for setting or returning a value, pParam contains a pointer to a variable of the UINT type. The size of the memory area to which pParam refers is specified in the cbSizeOfParam input parameter.

Input parameters

hCam

Camera handle

pParam

Pointer to a function parameter, whose function depends on nCommand.

cbSizeOfParam

Size (in bytes) of the memory area to which pParam refers.

Contents of the IS_SEQUENCER_PATH structure

UINT

u32PathIndex

Configuration path

Possible values: 0 or 1

UINT

u32NextIndex

Defines the next sequencer set.

Value range: 0…31

UINT

u32TriggerSource

Defines the trigger source:

IS_TRIGGER_SOURCE_EXPOSURE_END: Triggers the next sequencer set with end of exposure.

IS_TRIGGER_SOURCE_FRAME_END: Triggers the next sequencer set with the end of image readout.

IS_TRIGGER_SOURCE_FRAME_START: Triggers the next sequencer set with the beginn of image readout.

IS_TRIGGER_SOURCE_OFF: Disables the sequencer trigger source, which means that no further set is started after this sequencer set.

The supported trigger sources can be queried with IS_SEQUENCER_TRIGGER_SOURCE_SUPPORTED_GET.

UINT

u32TriggerActivation

Defines the activation mode.

Possible value: 0

Contents of the IS_SEQUENCER_GAIN_CONFIGURATION structure

UINT

Master

Sets the master gain factor (0...100)

UINT

Red

Sets the red channel gain factor (0...100).

UINT

Green

Sets the green channel gain factor (0...100).

UINT

Blue

Sets the blue channel gain factor (0...100)

Contents of the IS_SEQUENCER_FLASH_CONFIGURATION structure

UINT

u32Mode

Flash mode, see Using flash

UINT

u32Duration

Flash duration (in μs)

If 0 is passed, the flash output will be active until the end of the exposure time. For sensors with Global Start Shutter this is the time until the end of exposure of the first sensor row.

UINT

u32Delay

Flash delay (in μs)

Return values

IS_CAPTURE_RUNNING

A capturing operation is in progress and must be terminated first.

IS_INVALID_CAMERA_HANDLE

Invalid camera handle

IS_INVALID_PARAMETER

One of the submitted parameters is outside the valid range or is not supported for this sensor or is not available in this mode.

IS_IO_REQUEST_FAILED

An IO request from the uEye driver failed. Possibly the versions of the ueye_api.dll (API) and the driver file (ueye_usb.sys or ueye_eth.sys) do not match.

IS_NO_SUCCESS

General error message

IS_NOT_SUPPORTED

The camera model used here does not support this function or setting.

IS_SUCCESS

Function executed successfully

Related functions

is_GetImageInfo()

Example 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));

Example 2

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

Example 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
}

© 2022 IDS Imaging Development Systems GmbH