Please enable JavaScript to view this site.

IDS Software Suite 4.96.1

Windows_Logo
Linux_Logo

 

USB uEye XS

 

USB uEye XS

Syntax

INT is_Saturation (HIDS hCam, UINT nCommand, void *pParam, UINT nSizeOfParam)

Description

Using is_Saturation(), you can enhance or reduce the color saturation if supported by your uEye 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 nSizeOfParam input parameter.

hint_info

This function is currently supported by the following camera models:

UI-1007XS

Input parameters

hCam

Camera handle

pParam

Pointer to a function parameter; which function parameter is referred to here depends on nCommand.

nSizeOfParam

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

Status flags from SATURATION_CAPABILITY_FLAGS

SATURATION_CAP_INVALID

The camera does not support setting the color saturation

SATURATION_CAP_SATURATION_SUPPORTED

The camera supports setting the color saturation

Return values

IS_CANT_COMMUNICATE_WITH_DRIVER

Communication with the driver failed because no driver has been loaded.

IS_CANT_OPEN_DEVICE

An attempt to initialize or select the camera failed (no camera connected or initialization error).

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_NULL_POINTER

Invalid array

IS_SUCCESS

Function executed successfully

Related functions

is_SetSaturation()

© 2022 IDS Imaging Development Systems GmbH