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=utf-8">
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_I2CExposure*</TITLE>
8<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">CAMERA_I2CExposure* <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> <BR> <CODE><A href="CAMERAResult.html">CAMERAResult</A> CAMERA_I2CExposure(<A href="CAMERASelect.html">CAMERASelect</A> camera, int exposure);</CODE> <BR> <CODE><A href="CAMERAResult.html">CAMERAResult</A> CAMERA_I2CExposureAsync(<A href="CAMERASelect.html">CAMERASelect</A> camera, int exposure, <A href="CAMERACallback.html">CAMERACallback</A> callback, void *arg);</CODE>
16</DL>
17<H2>Arguments</H2>
18<TABLE border="1" width="100%">
19  <TBODY>
20    <TR>
21<TD width="13%"><EM><STRONG>camera</STRONG></EM></TD>
22<TD width="87%">Camera to configure (<CODE>CAMERA_SELECT_IN</CODE>, <CODE>CAMERA_SELECT_OUT</CODE>, or <CODE>CAMERA_SELECT_BOTH</CODE>).</TD>
23    </TR>
24    <TR>
25<TD width="13%"><EM><STRONG>exposure</STRONG></EM></TD>
26<TD width="87%">Amount of exposure to set.</TD>
27    </TR>
28    <TR>
29<TD width="13%"><EM><STRONG>callback</STRONG></EM></TD>
30<TD width="87%">Function that is called when asynchronous processing has completed.</TD>
31    </TR>
32    <TR>
33<TD width="13%"><EM><STRONG>arg</STRONG></EM></TD>
34<TD width="87%">Arguments when the callback function is invoked.</TD>
35    </TR>
36  </TBODY>
37</TABLE>
38
39<H2>Return Values</H2>
40<P>Returns <CODE>CAMERA_RESULT_SUCCESS</CODE> if configuration was successful.</P>
41
42<H2>Description</H2>
43<P>
44Sets the camera exposure (illumination time). The <SPAN class="argument">exposure</SPAN> argument must be specified between -5 and 5.<BR><BR> Unlike <code>CAMERA_I2CExposure</code>, the <code>CAMERA_I2CExposureAsync</code> function returns control immediately and runs asynchronously. Use <SPAN class="argument">callback</SPAN> to confirm that processing has completed.<br><br> <font color="red"><B>Note:</B></font><br> If camera settings are changed using any of the <code>CAMERA_I2C*</code> 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.<br><br> Although this function enables automatic exposure, it is reenabled if a <code><a href="CAMERA_I2CAutoExposure.html">CAMERA_I2CAutoExposure*</a></code> function is called.<br><br> <font color="red">Occasional Shifting of Captured Images</font><br> The captured image may shift if this function is called during image capture.<br>Before calling this function, first stop the image capture with <code><a href="CAMERA_StopCapture.html">CAMERA_StopCapture</a></code>. Then call this function. After this function completes execution, restart the image capture with <code><a href="CAMERA_StartCapture.html">CAMERA_StartCapture</a></code>.
45</P>
46
47<H2>See Also</H2>
48<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> <a href="CAMERA_I2CAutoExposure.html">CAMERA_I2CAutoExposure*</a></CODE></P>
49<H2>Revision History</H2>
50<P>
512009/11/11 Explained occasional shifting of captured images.<br>2009/10/14 Added a description of operations when automatic exposure has been disabled.<br>2009/03/25 Added information about changing camera settings during capture operations.<br>2008/10/30 Added that <CODE>CAMERA_SELECT_BOTH</CODE> can also be specified.<br>2007/10/12 Initial version.</P>
52<hr><p>CONFIDENTIAL</p></body>
53</HTML>
54