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>SetAutoWhiteBalance</title>
8  </head>
9  <body>
10<h1><CODE>nn::camera::CTR::SetAutoWhiteBalance</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> SetAutoWhiteBalance(
15     <a href="../../../nn/camera/CTR/CameraSelect.html">CameraSelect</a> select,
16     bool on
17);
18</pre>
19    </div>
20<h2>Arguments</h2>
21    <div class="section">
22      <table class="arguments">
23        <thead>
24          <tr>
25            <td width="15" />
26<th>Name</th>
27<td>Description</td>
28          </tr>
29        </thead>
30        <tr>
31<td>in</td>
32<th>select</th>
33<td>Specifies which camera to change settings for.</td>
34        </tr>
35        <tr>
36<td>in</td>
37<th>on</th>
38<td>Specify <CODE>true</CODE> to enable or <CODE>false</CODE> to disable.</td>
39        </tr> </table>
40    </div>
41<h2>Return Values</h2>
42<div class="section">Returns the result of the operation.<br /><CODE>LEVEL_SUCCESS:SUMMARY_SUCCESS:MODULE_COMMON:DESCRIPTION_SUCCESS</CODE>: Success.<br /><CODE>LEVEL_STATUS:SUMMARY_STATUS_CHANGED:MODULE_NN_CAMERA:DESCRIPTION_CAMERA_IS_SLEEPING</CODE>: Asleep, and thus unavailable.<br /><CODE>LEVEL_FATAL:SUMMARY_INTERNAL:MODULE_NN_CAMERA:DESCRIPTION_CAMERA_FATAL_ERROR</CODE>: There may be something physically wrong with the camera.<br /> </div>
43<h2>Description</h2>
44    <div class="section">
45<p>Enables/disables automatic white balance.</p><P>
46If the camera's white balance is set to &quot;automatic&quot; and <CODE>WHITE_BALANCE_NORMAL</CODE>, this function enables or disables automatic white balancing. When the automatic adjustment feature is disabled, the white balance setting is locked to its value at that time. If the setting is not <CODE>WHITE_BALANCE_NORMAL</CODE>, this function fails.
47            </P><P>
48A camera's exposure value is unstable immediately after the camera is started with the <CODE>Activate</CODE> function.
49            </P><P>
50Calling the <CODE>SetWhiteBalance</CODE> function resets the value set by this function and enables automatic white balancing.
51            </P><P>
52The default value is <CODE>true</CODE> for all cameras.
53</P><p>Note that this function may block internally for an extended period if a camera is restarting.</p></div>
54<h2>Revision History</h2>
55    <div class="section">
56      <dl class="history">
57        <dt>2010/09/24</dt>
58<dd>Added explanation about disabling the automatic adjustment feature.
59        </dd>
60        <dt>2010/07/17</dt>
61<dd>Added explanation about operation during restart.
62        </dd>
63        <dt>2010/07/14</dt>
64<dd>Deleted related text following deletion of <CODE>SynchronizeWhiteBalance</CODE> function.
65        </dd>
66        <dt>2010/06/18</dt>
67<dd>Added information about this function's relationship with the <CODE>SynchronizeWhiteBalance</CODE> function.<br />
68        </dd>
69        <dt>2010/04/14</dt>
70<dd>Added a description of the default values.<br />
71        </dd>
72        <dt>2010/04/09</dt>
73<dd>Added description text.<br />
74        </dd>
75        <dt>2010/02/02</dt>
76<dd>Initial version.<br />
77        </dd>
78      </dl>
79    </div>
80  <hr><p>CONFIDENTIAL</p></body>
81</html>