nn::camera::CTR::SetBrightnessSynchronization Function

nn::Result SetBrightnessSynchronization(
     bool enable
);

	Name	Description
in	enable	Specify true to start brightness synchronization, and false to end it.

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.

Configures the start and end of brightness synchronization.

The CTR's stereo camera performs internal processing of the left and right cameras independently (for example, auto exposure), and this can cause the image brightness to differ for some subjects.

This function synchronizes (links) the brightness of the stereo camera images by periodically writing the exposure settings of the right outer camera to the left outer camera. When auto exposure is enabled in particular, this function tracks changes in the exposure of the right outer camera, and changes the exposure of the left outer camera accordingly.

By default, synchronization is disabled (that is, enable is set to false).

This function is only effective when the left and right outer cameras are used at the same time. It has no effect if the left outer camera and inner camera are used in combination.

This function can be called both before and after the left and right outer cameras are activated via nn::camera::Activate. Once synchronization has been enabled via this function, the configuration is retained even if the camera goes into standby. Synchronization will thus continue after both cameras have been activated again. To disable synchronization, call this function with enable set to false.

Internally, the configuration is written using the system's lowest-priority thread. Synchronization could thus be delayed when the system is under heavy load.

This function will fail if any of the following apply to the camera configuration. None of the following settings are available after synchronization has been enabled by this function. Function execution will fail.

• When white balance is set to other than WHITE_BALANCE_NORMAL.
• When the white balance setting is disabled.
• When the photo mode is PHOTO_MODE_LANDSCAPE.
• When the contrast setting is CONTRAST_PATTERN_10.

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

2011/03/22

Initial version.