1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>CAMERA_I2CAutoExposure*</TITLE>
8<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">CAMERA_I2CAutoExposure* <IMG src="../image/TWL.gif" align="middle"></H1>
12<H2>Syntax</H2>
13<DL>
14  <DD>
15  <CODE>#include &lt;twl/camera.h&gt;</CODE><BR>
16  <BR>
17  <CODE><A href="CAMERAResult.html">CAMERAResult</A> CAMERA_I2CAutoExposure(<A href="CAMERASelect.html">CAMERASelect</A> camera, BOOL on);</CODE>
18  <BR>
19  <CODE><A href="CAMERAResult.html">CAMERAResult</A> CAMERA_I2CAutoExposureAsync(<A href="CAMERASelect.html">CAMERASelect</A> camera, BOOL on, <A href="CAMERACallback.html">CAMERACallback</A> callback, void *arg);</CODE>
20</DL>
21<H2>Arguments</H2>
22<TABLE border="1" width="100%">
23  <TBODY>
24    <TR>
25<TD width="13%"><SPAN class="argument">camera</SPAN></TD>
26<TD width="87%">Camera to configure (<CODE>CAMERA_SELECT_IN</CODE>, <CODE>CAMERA_SELECT_OUT</CODE>, or <CODE>CAMERA_SELECT_BOTH</CODE>).</TD>
27    </TR>
28    <TR>
29<TD width="13%"><SPAN class="argument">on</SPAN></TD>
30<TD width="87%">When <CODE>TRUE</CODE>, enables the automatic exposure feature.</TD>
31    </TR>
32    <TR>
33<TD width="13%"><SPAN class="argument">callback</SPAN></TD>
34<TD width="87%">Function that is called when asynchronous processing has completed.</TD>
35    </TR>
36    <TR>
37<TD width="13%"><SPAN class="argument">arg</SPAN></TD>
38<TD width="87%">Arguments when the callback function is invoked.</TD>
39    </TR>
40  </TBODY>
41</TABLE>
42
43<H2>Return Values</H2>
44<P>Returns <CODE>CAMERA_RESULT_SUCCESS</CODE> if configuration was successful.</P>
45
46<H2>Description</H2>
47<P>
48Enables 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 <a href="CAMERA_I2CActivate.html"><CODE>CAMERA_I2CActivate</CODE></a> function.<BR><BR> Unlike <code>CAMERA_I2CAutoExposure</code>, the <code>CAMERA_I2CAutoExposureAsync</code> function returns control immediately and runs asynchronously. Use <SPAN class="argument">callback</SPAN> to confirm that processing has completed.
49</P>
50
51<H2>See Also</H2>
52<P><A href="CAMERASelect.html"><CODE>CAMERASelect</CODE></A><BR> <A href="CAMERACallback.html"><CODE>CAMERACallback</CODE></A><BR> <A href="CAMERAResult.html"><CODE>CAMERAResult</CODE></A></P>
53<H2>Revision History</H2>
54<P>
552008/10/30 Added that <CODE>CAMERA_SELECT_BOTH</CODE> also can be specified.<br> 2008/07/16 Initial version.</P>
56<hr><p>CONFIDENTIAL</p></body>
57</HTML>
58