nn::camera::CTR::SetEffect Function

Syntax

nn::Result SetEffect(
     CameraSelect select,
     Effect effect,
     Context context = CONTEXT_BOTH
);

Parameters

Name Description
in select Specifies which camera to change settings for.
in effect Specifies the effect.
in context Specifies which context to change settings for. If omitted, the settings will be applied both to context A and context B.

Return Values

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.

Description

Sets an image effect.

Both context A and context B for all cameras have an initial value of EFFECT_NONE.

Note: When you specify an effect with this function, you can vary the result of the effect by changing other settings at the same time.

  1. When you specify EFFECT_NEGAFILM, you can emphasize red tones by raising the color temperature of WhiteBalance (moving it toward WHITE_BALANCE_SHADE).
  2. When you specify EFFECT_SEPIA, you can get a soft impression by lowering the Sharpness setting.

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

Revision History

2010/07/17
Added explanation about operation during restart.
2010/04/14
Added a description of the default values.
2010/04/09
Added description text.
2010/02/02
Initial version.

CONFIDENTIAL