#include <twl/camera.h>CAMERAResult CAMERA_I2CAutoExposure(CAMERASelect camera, BOOL on); CAMERAResult CAMERA_I2CAutoExposureAsync(CAMERASelect camera, BOOL on, CAMERACallback callback, void *arg);
| 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. |
Returns CAMERA_RESULT_SUCCESS if configuration was successful.
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. If camera settings are changed during image capture, therefore, an application's timing may make it impossible to get an image with the changes applied.
Although this function disables automatic exposure, you can enable it by calling a CAMERA_I2CExposure* function.
Occasional Shifting of Captured Images
The captured image may shift if this function is called during image capture.
Before calling this function, first stop the image capture with CAMERA_StopCapture. Then call this function. After this function completes execution, restart the image capture with CAMERA_StartCapture.
CAMERASelect
CAMERACallback
CAMERAResult CAMERA_I2CExposure*
2009/11/11 Explained occasional shifting of captured images.
2009/10/14 Added a description of operations when automatic exposure has been disabled.
2009/03/25 Added information about changing camera settings during capture operations.
2008/10/30 Added that CAMERA_SELECT_BOTH can also be specified.
2008/07/16 Initial version.
CONFIDENTIAL