camera_scenemode_t

#include <camera/camera_api.h>
 

typedef enum {
      CAMERA_SCENE_DEFAULT = 0   
      CAMERA_SCENE_AUTO   
      CAMERA_SCENE_SPORTS   
      CAMERA_SCENE_WHITEBOARD   
      CAMERA_SCENE_CLOSEUP   
      CAMERA_SCENE_BUSINESSCARD   
      CAMERA_SCENE_BARCODE   
      CAMERA_SCENE_ACTION   
      CAMERA_SCENE_TEST   
      CAMERA_SCENE_BEACHANDSNOW   
      CAMERA_SCENE_NIGHT   
      CAMERA_SCENE_NUMSCENEMODES   
} camera_scenemode_t;

Since:

BlackBerry 10.0.0

Data:

CAMERA_SCENE_DEFAULT

The camera default scene mode.

This value acts as an alias for the preferred scene mode for a particular camera. When you start the viewfinder, a default scene mode is selected, such as CAMERA_SCENE_AUTO. The default that is selected is dependent on the specific camera hardware. If you have changed the scene mode, you can later revert back to the default scene mode setting by calling camera_set_scene_mode() with a value of CAMERA_SCENE_DEFAULT. If you read the scene mode using camera_get_scene_mode(), the camera will report the actual scene mode that has been selected, rather than the CAMERA_SCENE_DEFAULT alias.

CAMERA_SCENE_AUTO

Auto scene mode is a specific exposure program, which tries to achieve the best picture by automatically varying shutter speed, iso, and white balance.

This differs from the other more specialized scene modes which may constrain one or more of these parameters to achieve a particular result under different lighting conditions.

CAMERA_SCENE_SPORTS

Use a faster shutter speed.

A fast shutter speed allows you to capture images with less motion blur where the subjects are quickly moving, such as sports shots.

CAMERA_SCENE_WHITEBOARD

Drop the mid-range tones in an image.

CAMERA_SCENE_CLOSEUP

Produce a soft-effect when photographing people.

CAMERA_SCENE_BUSINESSCARD

The scene being photographed is a piece of paper with text on it.

CAMERA_SCENE_BARCODE

The scene being photographed is a barcode.

CAMERA_SCENE_ACTION

Use a faster shutter speed.

A fast shutter speed allows you to capture images with less motion blur where the subjects are quickly moving, such as action shots.

CAMERA_SCENE_TEST

Don't apply any post-processing effects.

In test mode, pixels are untouched by the image signal processor (ISP) as image optimizations are turned off. This mode is used for factory testing and calibration.

CAMERA_SCENE_BEACHANDSNOW

Compensate exposure for bright scenes.

CAMERA_SCENE_NIGHT

Compensate exposure for dark scenes.

CAMERA_SCENE_NUMSCENEMODES

The total number of supported scene modes.

Library:

libcamapi (For the qcc command, use the -l camapi option to link against this library)

Description:

A scene mode specifies a predefined visual style applied by the camera hardware to achieve a specific image result. For example, one scene mode may use a faster shutter speed in order to capture fast moving subjects more clearly, whereas another scene mode may use a slower shutter speed in order to capture images in lower light. You can use the camera_get_scene_modes() function to determine which modes are supported by the current camera.