Please enable JavaScript to view this site.

IDS Software Suite 4.96.1

Windows_Logo
Linux_Logo

USB 2.0

USB 3.x

GigE

USB 2.0

USB 3.x

GigE

Syntax

INT is_SetSensorScaler (HIDS hCam, UINT nMode, double dblFactor)

Description

is_SetSensorScaler() enables internal image scaling for some sensors. This allows to reduce the image resolution by adjustable factors. Thus, the amount of data from high resolution sensors can be reduced.

hint_info

Internal image scaling is only supported by UI-149x/UI-549x, UI-124x/UI-324x/UI-524x and UI-125x/UI-325x/UI-525x series sensors.

hint_info

The use of the internal scaler has no effect on the attainable frame rate on the UI-149x/UI-549x models.

Input parameters

hCam

Camera handle

hmtoggle_plus0nMode: Function mode

dblFactor

Scaling factor

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_TYPE

The camera type defined in the .ini file does not match the current camera model.

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_CALIBRATED

The camera does not contain any calibration data.

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

IS_TIMED_OUT

A timeout occurred. An image capturing process could not be terminated within the allowable period.

Related functions

is_GetSensorScalerInfo()

Example

SENSORSCALERINFO Info;
INT nRet;
double dblNewFactor;
 
// Query information on image scaling
nRet = is_GetSensorScalerInfo (hCam, &Info, sizeof(Info));
 
// Enable scaling with anti aliasing
dblNewFactor = Info.dblMinFactor + Info.dblFactorIncrement;
nRet = is_SetSensorScaler (hCam, IS_ENABLE_SENSOR_SCALER | IS_ENABLE_ANTI_ALIASING, dblNewFactor);
 
// Disable scaling with anti aliasing
dblNewFactor = 0.0;
nRet = is_SetSensorScaler (hCam, IS_DISABLE_SENSOR_SCALER, dblNewFactor);

© 2022 IDS Imaging Development Systems GmbH