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