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_I2CContextSwitch*</TITLE> 8<LINK rel="stylesheet" href="../css/nitro.css" type="text/css"> 9</HEAD> 10<BODY> 11<H1 align="left">CAMERA_I2CContextSwitch* <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_I2CContextSwitch(<A href="CAMERASelect.html">CAMERASelect</A> camera, <A href="CAMERAContext.html">CAMERAContext</A> context);</CODE> <BR> <CODE><A href="CAMERAResult.html">CAMERAResult</A> CAMERA_I2CContextSwitchAsync(<A href="CAMERASelect.html">CAMERASelect</A> camera, <A href="CAMERAContext.html">CAMERAContext</A> context, <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 change the context for (<CODE>CAMERA_SELECT_IN</CODE> or <CODE>CAMERA_SELECT_OUT</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>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 changes were possible.</P> 41 42<H2>Description</H2> 43<P> 44Switches the camera settings context. It is faster to switch the context than to configure settings individually.<BR><BR> Because this function replaces the specified camera's settings with the settings in the specified context (A or B), you cannot set <SPAN class="argument">camera</SPAN> to <CODE>CAMERA_SELECT_NONE</CODE> or <SPAN class="argument">context</SPAN> to <CODE>CAMERA_CONTEXT_BOTH</CODE>.<BR> <BR> Unlike <code>CAMERA_I2CContextSwitch</code>, the <code>CAMERA_I2CContextSwitchAsync</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> <font color="red">・About Occasional Shifting of the Capture Image</font><br> The captured image may shift if the context is switched from CAMERA_CONTEXT_B to CAMERA_CONTEXT_A with this function during image capture.<br>When switching from <CODE>CAMERA_CONTEXT_B</CODE> to <CODE>CAMERA_CONTEXT_A</CODE>, 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="CAMERAContext.html"><CODE>CAMERAContext</CODE></A><BR> <A href="CAMERACallback.html"><CODE>CAMERACallback</CODE></A><BR> <A href="CAMERAResult.html"><CODE>CAMERAResult</CODE></A></P> 49<H2>Revision History</H2> 50<P> 512009/11/11 Explained the occasional shifting of captured images.<br>2009/03/25 Added information about changing camera settings during capture operations.<br>2007/10/12 Initial version.</P> 52<hr><p>CONFIDENTIAL</p></body> 53</HTML> 54
