is_ImageStabilization


USB uEye XS	USB uEye XS

Syntax

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

Description

Using is_ImageStabilization(), you can enable the electronic image stabilization function 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.

Hinweis

This function is currently only supported by the USB uEye XS camera model.

Hinweis

Notes on the image stabilization feature of the USB uEye XS

•Enable automatic exposure time control for best image stabilization results (see is_SetAutoParameter()).

•The image is stabilized electronically using part of the field of view for movement compensation. When this function is enabled, the visible field of view is reduced by about 10 %.

•The image stabilization feature at the same time activates the USB uEye XS camera's anti flicker function.

•If you have mounted the camera (e.g. on a stand) so that it is vibration-free, you should disable the image stabilization function. Otherwise, slight image background movement could occur.

Input parameters

hCam

Camera handle

IMGSTAB_CMD_GET_CAPABILITIES

Returns the image stabilization functions supported by the camera.

•pParam: Pointer to bit mask of type UINT
In the bit mask, the status flags from IMGSTAB_CAPABILITY_FLAGS are returned.

•nSizeOfParam: 4

IMGSTAB_CMD_SET_ENABLE

Enables image stabilization.

•pParam: NULL

•nSizeOfParam: 0

IMGSTAB_CMD_SET_DISABLE

Disables image stabilization.

•pParam: NULL

•nSizeOfParam: 0

IMGSTAB_CMD_GET_ENABLE

Returns the image stabilization status (enabled/disabled).

•pParam: Pointer to variable of type UINT
The bit mask returns either:
0 = image stabilization disabled
1 = image stabilization enabled

•nSizeOfParam: 4

pParam

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

nSizeOfParam

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

Status flags from IMGSTAB_CAPABILITY_FLAGS

IMGSTAB_CAP_IMAGE_STABILIZATION_SUPPORTED	The camera supports image stabilization
IMGSTAB_CAP_INVALID	The camera does not support image stabilization

Return values

IS_INVALID_CAPTURE_MODE	The function can not be executed in the current camera operating mode (free run, trigger or standby).
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_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

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.

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