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>Activate</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>::Activate</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> Activate(
15     <a href="../../../nn/camera/CTR/CameraSelect.html">CameraSelect</a> select
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>select</th>
32<td>Specifies the camera to activate.</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>Activates a camera.</p><p><B>Note:</B> The images obtained for the first four frames immediately after the camera is started are sometimes extremely dark. Including these four frames, automatic exposure will take approximately 14 frames indoors and 30 frames outdoors to stabilize after the camera is started.</p><P>
60This function starts the camera module itself. The <CODE><a href="../../../nn/camera/CTR/StartCapture.html">nn::camera::CTR::StartCapture</a></CODE> function must be called to start capturing.
61            </P><P>
62The system has three built-in cameras: an inner camera (<CODE>SELECT_IN1</CODE>) and two outer cameras (<CODE>SELECT_OUT1/OUT2</CODE>). This function specifies which camera is started. <CODE>SELECT_IN1</CODE> and <CODE>SELECT_OUT1</CODE> cannot be started simultaneously.
63            </P><P>
64While either <CODE>SELECT_IN1</CODE> or <CODE>SELECT_OUT1</CODE> alone is active, it will not enter standby mode if you specify <CODE>SELECT_OUT2</CODE> with this function. Likewise, while <CODE>SELECT_OUT2</CODE> is active it will not enter standby mode if you specify <CODE>SELECT_IN1</CODE> or <CODE>SELECT_OUT1</CODE> with this function. You must specify <CODE>SELECT_NONE</CODE> with this function to put the active cameras into standby mode.
65            </P><P>
66You can specify <CODE>SELECT_NONE</CODE> to place the inner camera and both outer cameras into standby mode. To conserve power, we recommend specifying <CODE>SELECT_NONE</CODE> to place all cameras into standby mode when they are not in use.
67            </P><P>
68The camera LED is illuminated when this function has activated either of the outer cameras. The camera LED turns off when <CODE>SELECT_NONE</CODE> is specified to this function and the active cameras are transitioned into standby mode, or when <CODE>SELECT_IN1</CODE> is specified and only the inner camera is active. The illuminated camera LED is turned off momentarily when the <CODE><a href="../../../nn/camera/CTR/PlayShutterSound.html">nn::camera::CTR::PlayShutterSound</a></CODE> function plays the shutter sound.
69</P><p><B>Note:</B> This function may block for an extended period if a camera is restarting.</p></div>
70<h2>Revision History</h2>
71    <div class="section">
72      <dl class="history">
73        <dt>2010/07/17</dt>
74<dd>Added explanation about operation during restart.
75        </dd>
76        <dt>2010/06/25</dt>
77<dd>Revised conditions for the camera LED turning on and off.<br />
78        </dd>
79        <dt>2010/06/24</dt>
80<dd>Added information on how the camera LED turns on and off.<br />
81        </dd>
82        <dt>2010/06/18</dt>
83<dd>Described behavior when a camera is started while another is still active.<br />
84        </dd>
85        <dt>2010/04/09</dt>
86<dd>Added <B>Note</B>.<br />
87        </dd>
88        <dt>2010/02/02</dt>
89<dd>Initial version.<br />
90        </dd>
91      </dl>
92    </div>
93  <hr><p>CONFIDENTIAL</p></body>
94</html>
95