Home > C: Programming > Function descriptions > History back  Previous chapter  Next chapter  Print  

is_SetSensorScaler

uEye Camera Manual Version 4.00

is_SetSensorScaler

Windows_Logo

Linux_Logo

USB 2.0

USB 3.0

GigE

USB 2.0

USB 3.0

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.

Hinweis

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

Hinweis

The use of the internal scaler has no effect on the attainable frame rate.

Input parameters

hCam

Camera handle

hmtoggle_plus1nMode: Function mode

IS_ENABLE_SENSOR_SCALER

Enable image scaling

IS_ENABLE_SENSOR_SCALER |
IS_ENABLE_ANTI_ALIASING

Enable image scaling with smoothed edges (anti-aliasing effect)

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


Suggestion for improvement? Send us your short Feedback on this chapter. Thank you very much!

For technical questions please contact you local distributor or use the support form on our website.


© 2012 IDS Imaging Development Systems GmbH
http://www.ids-imaging.com