# CAMERA_I2CPhotoMode*

## Syntax

  `#include <twl/camera.h>`
  `CAMERAResult CAMERA_I2CPhotoMode(CAMERASelect camera, CAMERAPhotoMode mode);`
  `CAMERAResult CAMERA_I2CPhotoModeAsync(CAMERASelect camera, CAMERAPhotoMode mode, CAMERACallback callback, void *arg);`

## Arguments

camera | Camera to configure (`CAMERA_SELECT_IN`, `CAMERA_SELECT_OUT`, or `CAMERA_SELECT_BOTH`).
mode | Photo mode to set.
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

Sets the camera's photo mode.
Unlike `CAMERA_I2CPhotoMode`, the `CAMERA_I2CPhotoModeAsync` 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`
`CAMERAPhotoMode`
`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.
2007/10/12 Initial version.

CONFIDENTIAL