nn::camera::CTR::SetPackageParameterWithoutContext Function

nn::Result SetPackageParameterWithoutContext(
     const PackageParameterCameraSelect & param
);

	Name	Description
in	param	Parameter value to set.

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.

Batch-configures settings for a camera with no context specified.

Some members of the param argument are listed below. As explained in the PhotoMode reference, the settings that correspond to these members are usually configured by photoMode, but you can use this function to configure individual settings for these members that take priority over settings made by photoMode.

• exposure
• whiteBalance
• sharpness
• contrast
• autoExposureWindowStartX
• autoExposureWindowStartY
• autoExposureWindowWidth
• autoExposureWindowHeight

For example, the white balance setting for PHOTO_MODE_LANDSCAPE is WHITE_BALANCE_DAYLIGHT, but if photoMode is PHOTO_MODE_LANDSCAPE and you use this function to specify WHITE_BALANCE_NORMAL for whiteBalance, the white balance is set to WHITE_BALANCE_NORMAL.
An argument for setting the gain exists for photoMode. This is something other functions cannot configure.

The param argument member autoWhiteBalanceOn only has effect when whiteBalance is WHITE_BALANCE_NORMAL. It is ignored when whiteBalance is anything other than WHITE_BALANCE_NORMAL.

The following member variables of the param argument can be set even when auto-exposure is disabled (when autoExposureOn is false): autoExposureWindowStartX, autoExposureWindowStartY, autoExposureWindowWidth, and autoExposureWindowHeight. You must therefore set these arguments to appropriate values regardless of whether auto-exposure is enabled or disabled.

In the same way, you must set the following to appropriate values regardless of whether auto white balance is enabled or disabled: autoWhiteBalanceWindowStartX, autoWhiteBalanceWindowStartY, autoWhiteBalanceWindowWidth, and autoWhiteBalanceWindowHeight.

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

2010/12/13

Noted that the response frame must be set regardless of whether auto-exposure and auto white balance are enabled or disabled.

2010/11/23

Explained the conflict with the PhotoMode settings.

2010/07/17

Initial version.