# 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.

## See Also

`CAMERASelect`
`CAMERACallback`
`CAMERAResult`

## Revision History

2008/10/30 Added that `CAMERA_SELECT_BOTH` also can be specified.
2008/07/16 Initial version.

CONFIDENTIAL