camera_scenemode_t

The scene mode to use for the camera.

Synopsis:

#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.

Last modified: 2014-05-14



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus