nn::camera::CTR::SetAutoExposureWindow Function

nn::Result SetAutoExposureWindow(
     CameraSelect select,
     s16 startX,
     s16 startY,
     s16 width,
     s16 height
);

	Name	Description
in	select	Specifies which camera to change settings for.
in	startX	Specifies the x-coordinate of the region's upper-left corner. If the x-coordinate of the image's upper-left corner is defined as 0, this argument can be specified in 40-pixel increments in the range [0, 600].
in	startY	Specifies the y-coordinate of the region's upper-left corner. If the y-coordinate of the image's upper-left corner is defined as 0, this argument can be specified in 30-pixel increments in the range [0, 450].
in	width	Specifies the region's width. This can be specified in 40-pixel increments in the range [40, 640]. The sum of this value and startX must be no larger than 640.
in	height	Specifies the height of the region. This can be specified in 30-pixel increments in the range [30, 480]. The sum of this value and startY must be no larger than 480.

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

Value	Description
Result::IsSuccess	Process was successful.
ResultIsSleeping	This function is unusable because the system cover is closed.
ResultFatalError	There may be something physically wrong with the camera.

Sets the region within the view to use as the basis for calculating auto exposure (the response frame).

The rectangular region specified by startX, startY, width, and height must be no larger than 640x480.

The default values for each camera are shown below.

	Inner Camera	Right Outer Camera	Left Outer Camera
startX	80	0	0
startY	60	0	0
width	480	640	640
height	360	480	480

Although the cameras use the response frame that can be set by this function only when auto-exposure is enabled, you can set the response frame with this function even when auto-exposure is disabled. You must therefore specify appropriate values when you call this function even if auto-exposure is disabled.

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

2010/12/10

Mentioned that this function can set values even when auto-exposure is disabled.

2010/12/07

Fixed errors in the description of the range for the width and height values.

2010/07/17

Added explanation about operation during restart.

2010/04/13

Initial version.