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_I2CActivate*</TITLE>
8<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">CAMERA_I2CActivate* <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_I2CActivate(<A href="CAMERASelect.html">CAMERASelect</A> camera);</CODE>
18  <BR>
19  <CODE><a href="CAMERAResult.html">CAMERAResult</a> CAMERA_I2CActivateAsync(<A href="CAMERASelect.html">CAMERASelect</A> camera, <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%"><EM><STRONG>camera</STRONG></EM></TD>
26      <TD width="87%">Specifies which camera to enable, or sets both cameras to standby mode.</TD>
27    </TR>
28    <TR>
29      <TD width="13%"><EM><STRONG>callback</STRONG></EM></TD>
30      <TD width="87%">Completion callback function.<BR>
31	  Specify <CODE>NULL</CODE> if this is unnecessary.</TD>
32    </TR>
33    <TR>
34      <TD width="13%"><EM><STRONG>arg</STRONG></EM></TD>
35      <TD width="87%">Arguments to pass to the completion callback function.<BR>
36	  This is simply ignored if <CODE>NULL</CODE> was specified for <CODE>callback</CODE>.</TD>
37    </TR>
38  </TBODY>
39</TABLE>
40<H2>Return Values</H2>
41<P>Returns <CODE>CAMERA_RESULT_SUCCESS</CODE> when successful. Returns errors on failure.</P>
42<H2>Description</H2>
43<P>
44Starts the cameras or places them in standby mode. This function starts the camera module itself. The <code><A href="CAMERA_StartCapture.html">CAMERA_StartCapture</A></code> function must be called to start capturing. <BR><BR>The system has two internal cameras: an inner camera (<CODE>CAMERA_SELECT_IN</CODE>) and an outer camera (<CODE>CAMERA_SELECT_OUT</CODE>). The camera specified to this function is started. The unspecified camera will automatically be put into standby mode. <BR><BR>Both the inner and outer cameras can be placed into standby mode by specifying <CODE>CAMERA_SELECT_NONE</CODE>. To conserve power, we recommend specifying <CODE>CAMERA_SELECT_NONE</CODE> to place both cameras into standby mode when they are not in use.<BR><BR> Unlike the <code>CAMERA_I2CActivate</code> function, the <code>CAMERA_I2CActivateAsync</code> function will return control immediately and run asynchronously. Use <SPAN class="argument">callback</SPAN> to confirm that processing has completed. <BR><BR><B>Note:</B> Immediately after starting the camera, the images obtained from the first four frames may be extremely dark. Including these four frames, automatic exposure will take approximately 14 frames indoors and 30 frames outdoors to stabilize after the camera is started.
45</P>
46<H2>See Also</H2>
47<P><CODE><A href="CAMERA_StartCapture.html">CAMERA_StartCapture</A></CODE><BR> <CODE><A href="CAMERASelect.html">CAMERASelect</A><BR> <A href="CAMERACallback.html">CAMERACallback</A></CODE></P>
48<H2>Revision History</H2>
49<P>
502008/08/18 Revised the description of the time taken to adjust the exposure immediately after the camera is started. <BR>2008/07/16 Added a note about the number of frames taken for automatic exposure correction to stabilize. <BR>2007/11/12 Initial version.</P>
51<hr><p>CONFIDENTIAL</p></body>
52</HTML>
53