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

is_ImageStabilization

uEye Camera Manual Version 3.80

is_ImageStabilization

Windows_Logo

Linux_Logo

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 (e.g. enable/disable image stabilization). 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

nCommand

 

IMGSTAB_CMD_GET_CAPABILITIES

Returns the image stabilization functions supported by the camera.

More details

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.

More details

pParam: NULL

nSizeOfParam: 0

IMGSTAB_CMD_SET_DISABLE

Disables image stabilization.

More details

pParam: NULL

nSizeOfParam: 0

IMGSTAB_CMD_GET_ENABLE

Returns the image stabilization status (enabled/disabled).

More details

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

Function executed successfully

IS_NO_SUCCESS

General error message

IS_NOT_SUPPORTED

This function is not supported by the current camera

IS_INVALID_CAPTURE_MODE

This function is not supported in the current operating mode

IS_INVALID_PARAMETER

One of the parameters passed is invalid


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


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