CAMERA_I2CAutoExposure*

Syntax

#include <twl/camera.h>

CAMERAResult CAMERA_I2CAutoExposure(CAMERASelect camera, BOOL on);
CAMERAResult CAMERA_I2CAutoExposureAsync(CAMERASelect camera, BOOL on, CAMERACallback callback, void *arg);

Arguments

camera Camera to configure (CAMERA_SELECT_IN, CAMERA_SELECT_OUT, or CAMERA_SELECT_BOTH).
on When TRUE, enables the automatic exposure feature.
callback Function that is called when asynchronous processing has completed.
arg Arguments when the callback function is invoked.

Return Values

Returns CAMERA_RESULT_SUCCESS if configuration was successful.

Description

Enables or disables the camera's automatic exposure feature. We recommend enabling this when the camera is started because the exposure value is undefined immediately after the camera has been started with the CAMERA_I2CActivate function.

Unlike CAMERA_I2CAutoExposure, the CAMERA_I2CAutoExposureAsync function returns control immediately and runs asynchronously. Use callback to confirm that processing has completed.

Note:
If camera settings are changed using any of the CAMERA_I2C* functions, the changes may be delayed for approximately one frame before they are applied. Consequently, note that if camera settings are changed while capturing, the application may not be able to get an updated image (an image with changes applied) at the time the application intended.

See Also

CAMERASelect
CAMERACallback
CAMERAResult

Revision History

2009/03/25 Added a note on changes to camera settings during capture operations.
2008/10/30 Noted that CAMERA_SELECT_BOTH can also be specified.
2008/07/16 Initial version.


CONFIDENTIAL