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_I2CEffect*</TITLE> 8<LINK rel="stylesheet" href="../css/nitro.css" type="text/css"> 9</HEAD> 10<BODY> 11<H1 align="left">CAMERA_I2CEffect* <IMG src="../image/TWL.gif" align="middle"></H1> 12<H2>Syntax</H2> 13<DL> 14 <DD> 15<CODE>#include <twl/camera.h></CODE><BR> <BR> <CODE><A href="CAMERAResult.html">CAMERAResult</A> CAMERA_I2CEffect(<A href="CAMERASelect.html">CAMERASelect</A> camera, <A href="CAMERAEffect.html">CAMERAEffect</A> effect);</CODE> <BR> <CODE><A href="CAMERAResult.html">CAMERAResult</A> CAMERA_I2CEffectAsync(<A href="CAMERASelect.html">CAMERASelect</A> camera, <A href="CAMERAEffect.html">CAMERAEffect</A> effect, <A href="CAMERACallback.html">CAMERACallback</A> callback, void *arg);</CODE> <BR> <CODE><A href="CAMERAResult.html">CAMERAResult</A> CAMERA_I2CEffectEx(<A href="CAMERASelect.html">CAMERASelect</A> camera, <A href="CAMERAContext.html">CAMERAContext</A> context, <A href="CAMERAEffect.html">CAMERAEffect</A> effect);</CODE> <BR> <CODE><A href="CAMERAResult.html">CAMERAResult</A> CAMERA_I2CEffectExAsync(<A href="CAMERASelect.html">CAMERASelect</A> camera, <A href="CAMERAContext.html">CAMERAContext</A> context, <A href="CAMERAEffect.html">CAMERAEffect</A> effect, <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>context</STRONG></EM></TD> 26<TD width="87%">Context to change.</TD> 27 </TR> 28 <TR> 29<TD width="13%"><EM><STRONG>effect</STRONG></EM></TD> 30<TD width="87%">Effect to set.</TD> 31 </TR> 32 <TR> 33<TD width="13%"><EM><STRONG>callback</STRONG></EM></TD> 34<TD width="87%">Function that is called when asynchronous processing has completed.</TD> 35 </TR> 36 <TR> 37<TD width="13%"><EM><STRONG>arg</STRONG></EM></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> 48Changes the camera effects.<BR><BR> The <code>CAMERA_I2CEffectEx</code> function is used to change the setting with the context specified. The non-Ex functions change the setting for both context A and B. See <A href="CAMERAContext.html"><CODE>CAMERAContext</CODE></A> for information on contexts.<BR><BR> Unlike <code>CAMERA_I2CEffect</code>, the <code>CAMERA_I2CEffectAsync</code> function returns control immediately and runs asynchronously. Use <SPAN class="argument">callback</SPAN> to confirm that processing has completed.<BR><BR><B>Note:</B> When specifying an effect with this function, you can vary the result of the effect by changing another setting at the same time. 49<ol> 50<li>When <CODE>CAMERA_EFFECT_NEGAFILM</CODE> is specified, you can emphasize red tones by raising the color temperature of the white balance (<CODE>CAMERA_WHITE_BALANCE_SHADE</CODE>).</li> 51<li>When <CODE>CAMERA_EFFECT_SEPIA</CODE> is set, a soft impression can be obtained by lowering the sharpness setting.</li> 52</ol> 53</P> 54<P> 55<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 updated image (an image with changes applied) at the time the application intended. 56</P> 57 58<H2>See Also</H2> 59<P><A href="CAMERASelect.html"><CODE>CAMERASelect</CODE></A><BR> <A href="CAMERAContext.html"><CODE>CAMERAContext</CODE></A><BR> <A href="CAMERAEffect.html"><CODE>CAMERAEffect</CODE></A><BR> <A href="CAMERACallback.html"><CODE>CAMERACallback</CODE></A><BR> <A href="CAMERAResult.html"><CODE>CAMERAResult</CODE></A></P> 60<H2>Revision History</H2> 61<P> 622009/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 Added a description of combinations with other settings. <BR>2007/10/12 Initial version.</P> 63<hr><p>CONFIDENTIAL</p></body> 64</HTML> 65
