1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2<html xml:lang="en-US" lang="en-US" xmlns="http://www.w3.org/1999/xhtml">
3  <head>
4    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5    <meta http-equiv="Content-Style-Type" content="text/css" />
6    <link rel="stylesheet" href="../../../css/manpage.css" type="text/css" />
7<title>SetBrightnessSynchronization</title>
8  </head>
9  <body>
10<h1><CODE><a href="../../../nn/Overview.html">nn</a>::<a href="../../../nn/camera/Overview.html">camera</a>::<a href="../../../nn/camera/CTR/Overview.html">CTR</a>::SetBrightnessSynchronization</CODE> Function</h1>
11<h2>Syntax</h2>
12    <div class="section">
13      <pre class="definition">
14<a href="../../../nn/Result/Overview.html">nn::Result</a> SetBrightnessSynchronization(
15     bool enable
16);
17</pre>
18    </div>
19<h2>Parameters</h2>
20    <div class="section">
21      <table class="arguments">
22        <thead>
23          <tr>
24            <td width="15" />
25<th>Name</th>
26<td>Description</td>
27          </tr>
28        </thead>
29        <tr>
30<td>in</td>
31<th>enable</th>
32<td>Specify <CODE>true</CODE> to start brightness synchronization, and <CODE>false</CODE> to end it.</td>
33        </tr> </table>
34    </div>
35<h2>Return Values</h2>
36<div class="section">Returns the function's execution result. Returns one of the <a href="../../../nn/Result/Overview.html"><CODE>Result</CODE></A> values listed below. <br />
37      <table class="arguments">
38        <thead>
39          <tr>
40<th>Value</th>
41<td>Description</td>
42          </tr>
43        </thead>
44        <tr>
45<th><CODE>Result::IsSuccess</CODE></th>
46<td>Process was successful.</td>
47        </tr>
48        <tr>
49<th><CODE>ResultIsSleeping</CODE></th>
50<td>This function is unusable because the system cover is closed.</td>
51        </tr>
52        <tr>
53<th><CODE>ResultFatalError</CODE></th>
54<td>There may be something physically wrong with the camera.</td>
55        </tr>
56      </table> </div>
57<h2>Description</h2>
58    <div class="section">
59<p>Configures the start and end of brightness synchronization.</p><P>
60The CTR's stereo camera performs internal processing of the left and right cameras independently (for example, auto exposure), and this can cause the image brightness to differ for some subjects.
61            </P><P>
62This function synchronizes (links) the brightness of the stereo camera images by periodically writing the exposure settings of the right outer camera to the left outer camera. When auto exposure is enabled in particular, this function tracks changes in the exposure of the right outer camera, and changes the exposure of the left outer camera accordingly.
63            </P><P>
64By default, synchronization is disabled (that is, <SPAN class="argument">enable</SPAN> is set to <CODE>false</CODE>).
65            </P><P>
66This function is only effective when the left and right outer cameras are used at the same time. It has no effect if the left outer camera and inner camera are used in combination.
67            </P><P>
68This function can be called both before and after the left and right outer cameras are activated via <CODE>nn::camera::Activate</CODE>. Once synchronization has been enabled via this function, the configuration is retained even if the camera goes into standby. Synchronization will thus continue after both cameras have been activated again. To disable synchronization, call this function with <SPAN class="argument">enable</SPAN> set to <CODE>false</CODE>.
69            </P><P>
70Internally, the configuration is written using the system's lowest-priority thread. Synchronization could thus be delayed when the system is under heavy load.
71            </P><P>
72This function will fail if any of the following apply to the camera configuration. None of the following settings are available after synchronization has been enabled by this function. Function execution will fail.
73                <ul><li>
74When white balance is set to other than <CODE>WHITE_BALANCE_NORMAL</CODE>.
75                    </li><li>
76When the white balance setting is disabled.
77                    </li><li>
78When the photo mode is <CODE>PHOTO_MODE_LANDSCAPE</CODE>.
79                    </li><li>
80When the contrast setting is <CODE>CONTRAST_PATTERN_10</CODE>.
81</li></ul></P><p><B>Note:</B> This function may block for an extended period if a camera is restarting.</p></div>
82<h2>Revision History</h2>
83    <div class="section">
84      <dl class="history">
85        <dt>2011/03/22</dt>
86<dd>Initial version.<br />
87        </dd>
88      </dl>
89    </div>
90  <hr><p>CONFIDENTIAL</p></body>
91</html>
92