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_I2CFrameRate*</TITLE>
8<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">CAMERA_I2CFrameRate* <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_I2CFrameRate(<A href="CAMERASelect.html">CAMERASelect</A> camera, <A href="CAMERAFrameRate.html">CAMERAFrameRate</A> rate);</CODE> <BR> <CODE><A href="CAMERAResult.html">CAMERAResult</A> CAMERA_I2CFrameRateAsync(<A href="CAMERASelect.html">CAMERASelect</A> camera, <A href="CAMERAFrameRate.html">CAMERAFrameRate</A> rate, <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>rate</STRONG></EM></TD>
26<TD width="87%">Frame rate.</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>
41Returns <CODE>CAMERA_RESULT_SUCCESS</CODE> if configuration was successful.
42</P>
43
44<H2>Description</H2>
45<P>
46Changes the camera's frame rate.<BR><BR> Unlike <code>CAMERA_I2CFrameRate</code>, the <code>CAMERA_I2CFrameRateAsync</code> function returns control immediately and runs asynchronously. Use <SPAN class="argument">callback</SPAN> to confirm that processing has completed.<BR> <BR>Do not set <CODE>CAMERA_FRAME_RATE_30_TO_5</CODE> or <CODE>CAMERA_FRAME_RATE_30</CODE> with this function while either <CODE>CAMERA_SIZE_VGA</CODE> or <CODE>CAMERA_SIZE_DS_LCDx4</CODE> is specified with the <A href="CAMERA_I2CSize.html"><CODE>CAMERA_I2CSize*</CODE></A> functions. Capture data becomes impossible to receive if these settings are used at the same time.<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. Consequently, note that if camera settings are changed while capturing, the application may not be able to get an image with the changes applied at the time the application intended.
47</P>
48
49<H2>See Also</H2>
50<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><BR> <A href="CAMERAFrameRate.html"><CODE>CAMERAFrameRate</CODE></A><BR> <A href="CAMERA_I2CSize.html"><CODE>CAMERA_I2CSize*</CODE></A></P>
51<H2>Revision History</H2>
52<P>
532009/03/25 Added a note on changes to camera settings during capture operations. <br>2008/10/30 Noted that <CODE>CAMERA_SELECT_BOTH</CODE> can also be specified.<br> 2008/03/17 Explained that images cannot be captured at 30 fps for the DS_LCDx4 size.<BR> 2008/01/23 Explained that images cannot be captured at 30 fps for the VGA size.<BR> 2007/11/12 Initial version.</P>
54<hr><p>CONFIDENTIAL</p></body>
55</HTML>
56