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>nn::camera::CTR::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>Arguments</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 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>
37<h2>Description</h2>
38    <div class="section">
39<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>
40This function starts the camera module itself. The <CODE>CAMERA_StartCapture</CODE> function must be called to start capturing.
41            </P><P>
42The 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.
43            </P><P>
44While 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>CAMERA_SELECT_NONE</CODE> with this function to put the active cameras into standby mode.
45            </P><P>
46You can specify <CODE>CAMERA_SELECT_NONE</CODE> to place the inner camera and both outer cameras into standby mode. To conserve power, we recommend specifying <CODE>CAMERA_SELECT_NONE</CODE> to place all cameras into standby mode when they are not in use.
47            </P><P>
48The 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>PlayShutterSound</CODE> function plays the shutter sound.
49</P><p>Note that this function may block internally for an extended period if a camera is restarting.</p></div>
50<h2>Revision History</h2>
51    <div class="section">
52      <dl class="history">
53        <dt>2010/07/17</dt>
54<dd>Added explanation about operation during restart.
55        </dd>
56        <dt>2010/06/25</dt>
57<dd>Revised conditions for the camera LED turning on and off.<br />
58        </dd>
59        <dt>2010/06/24</dt>
60<dd>Added information on how the camera LED turns on and off.<br />
61        </dd>
62        <dt>2010/06/18</dt>
63<dd>Described behavior when a camera is started while another is still active.<br />
64        </dd>
65        <dt>2010/04/09</dt>
66<dd>Added <B>Note</B>.<br />
67        </dd>
68        <dt>2010/02/02</dt>
69<dd>Initial version.<br />
70        </dd>
71      </dl>
72    </div>
73  <hr><p>CONFIDENTIAL</p></body>
74</html>
75