nn::camera::CTR::Activate Function

nn::Result Activate(
CameraSelect select
);

	Name	Description
in	select	Specifies the camera to activate.

Returns the function's execution result. Returns one of the Result values listed below.

Value	Description
ResultSuccess	Process was successful.
ResultIsSleeping	Unusable because the system is closed.
ResultFatalError	There may be something physically wrong with the camera.

Activates a camera.

Note: 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.

This function starts the camera module itself. The CAMERA_StartCapture function must be called to start capturing.

The system has three built-in cameras: an inner camera (SELECT_IN1) and two outer cameras (SELECT_OUT1/OUT2). This function specifies which camera is started. SELECT_IN1 and SELECT_OUT1 cannot be started simultaneously.

While either SELECT_IN1 or SELECT_OUT1 alone is active, it will not enter standby mode if you specify SELECT_OUT2 with this function. Likewise, while SELECT_OUT2 is active it will not enter standby mode if you specify SELECT_IN1 or SELECT_OUT1 with this function. You must specify CAMERA_SELECT_NONE with this function to put the active cameras into standby mode.

You can specify CAMERA_SELECT_NONE to place the inner camera and both outer cameras into standby mode. To conserve power, we recommend specifying CAMERA_SELECT_NONE to place all cameras into standby mode when they are not in use.

The camera LED is illuminated when this function has activated either of the outer cameras. The camera LED turns off when SELECT_NONE is specified to this function and the active cameras are transitioned into standby mode, or when SELECT_IN1 is specified and only the inner camera is active. The illuminated camera LED is turned off momentarily when the PlayShutterSound function plays the shutter sound.

Note: This function may block for an extended period if a camera is restarting.

2010/07/17

Added explanation about operation during restart.

2010/06/25

Revised conditions for the camera LED turning on and off.

2010/06/24

Added information on how the camera LED turns on and off.

2010/06/18

Described behavior when a camera is started while another is still active.

2010/04/09

Added Note.

2010/02/02

Initial version.