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> 16 <BR> 17 <CODE><A href="CAMERAResult.html">CAMERAResult</A> CAMERA_I2CEffect(<A href="CAMERASelect.html">CAMERASelect</A> camera, <A href="CAMERAEffect.html">CAMERAEffect</A> effect);</CODE> 18 <BR> 19 <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> 20 <BR> 21 <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> 22 <BR> 23 <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> 24</DL> 25<H2>Arguments</H2> 26<TABLE border="1" width="100%"> 27 <TBODY> 28 <TR> 29<TD width="13%"><SPAN class="argument">camera</SPAN></TD> 30<TD width="87%">Camera to configure (<CODE>CAMERA_SELECT_IN</CODE>, <CODE>CAMERA_SELECT_OUT</CODE>, or <CODE>CAMERA_SELECT_BOTH</CODE>).</TD> 31 </TR> 32 <TR> 33<TD width="13%"><SPAN class="argument">context</SPAN></TD> 34<TD width="87%">Context to change.</TD> 35 </TR> 36 <TR> 37<TD width="13%"><SPAN class="argument">effect</SPAN></TD> 38<TD width="87%">Effect to set.</TD> 39 </TR> 40 <TR> 41<TD width="13%"><SPAN class="argument">callback</SPAN></TD> 42<TD width="87%">Function that is called when asynchronous processing has completed.</TD> 43 </TR> 44 <TR> 45<TD width="13%"><SPAN class="argument">arg</SPAN></TD> 46<TD width="87%">Arguments when the callback function is invoked.</TD> 47 </TR> 48 </TBODY> 49</TABLE> 50 51<H2>Return Values</H2> 52<P>Returns <CODE>CAMERA_RESULT_SUCCESS</CODE> if configuration was successful.</P> 53 54<H2>Description</H2> 55<P> 56Changes 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. 57<ol> 58<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> 59<li>When <CODE>CAMERA_EFFECT_SEPIA</CODE> is set, a soft impression can be obtained by lowering the sharpness setting.</li> 60</ol> 61</P> 62 63<H2>See Also</H2> 64<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> 65<H2>Revision History</H2> 66<P> 672008/10/30 Added that <CODE>CAMERA_SELECT_BOTH</CODE> also can be specified.<br> 2008/03/17 Added explanation about combining with other settings.<BR> 2007/10/12 Initial version.</P> 68<hr><p>CONFIDENTIAL</p></body> 69</HTML> 70