nn::camera::CTR::SetAutoExposureWindow Function

Syntax

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

Arguments

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 [0, 640].
in height Specifies the region's height. This can be specified in 30-pixel increments in the range [0, 480].

Return Values

Returns the result of the operation.
LEVEL_SUCCESS:SUMMARY_SUCCESS:MODULE_COMMON:DESCRIPTION_SUCCESS: Success.
LEVEL_STATUS:SUMMARY_STATUS_CHANGED:MODULE_NN_CAMERA:DESCRIPTION_CAMERA_IS_SLEEPING: Asleep, and thus unavailable.
LEVEL_FATAL:SUMMARY_INTERNAL:MODULE_NN_CAMERA:DESCRIPTION_CAMERA_FATAL_ERROR: There may be something physically wrong with the camera.

Description

Sets the region within the view to use as the basis for calculating auto exposure.

The default values for each camera are shown below.

Inner CameraRight Outer CameraLeft Outer Camera
startX8000
startY6000
width480640640
height360480480

Note that this function may block internally for an extended period if a camera is restarting.

Revision History

2010/07/17
Added explanation about operation during restart.
2010/04/13
Initial version.

CONFIDENTIAL