net.rim.device.api.amms.control.camera
Interface FeatureControl

All Superinterfaces:
Control

public interface FeatureControl
extends Control

The FeatureControl interface allows you to access the camera-related features for camera-based applications, but not access the camera hardware directly.

Since:
BlackBerry API 7.0.0

Field Summary
static String SCENE_MODE_AUTO
          Scene Mode Type: Automatic.
static String SCENE_MODE_BEACH
          Scene Mode Type: Beach.
static String SCENE_MODE_FACEDETECTION
          Scene Mode Type: Face Detection.
static String SCENE_MODE_LANDSCAPE
          Scene Mode Type: Landscape.
static String SCENE_MODE_MACRO
          Scene Mode Type: Macro.
static String SCENE_MODE_NIGHT
          Scene Mode Type: Night.
static String SCENE_MODE_PARTY
          Scene Mode Type: Party.
static String SCENE_MODE_PORTRAIT
          Scene Mode Type: Portrait.
static String SCENE_MODE_SNOW
          Scene Mode Type: Snow.
static String SCENE_MODE_SPORT
          Scene Mode Type: Sport.
static String SCENE_MODE_TEXT
          Scene Mode Type: Text.
 
Method Summary
 String getCurrentSceneMode()
          Retrieves the currently set scene mode on the device.
 boolean isSceneModeSupported(String modeID)
          Checks if the device supports the specified scene mode.
 void setSceneMode(String modeID)
          Enables the input Scene Mode specified by the modeID parameter.
 



Field Detail

SCENE_MODE_AUTO

static final String SCENE_MODE_AUTO
Scene Mode Type: Automatic. Ideal for capturing a wide range of subjects under most conditions.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

SCENE_MODE_FACEDETECTION

static final String SCENE_MODE_FACEDETECTION
Scene Mode Type: Face Detection. Detects the faces of subjects and puts them in focus in most lighting conditions.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

SCENE_MODE_PORTRAIT

static final String SCENE_MODE_PORTRAIT
Scene Mode Type: Portrait. Ideal for capturing people; skin tones are accurately reproduced.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

SCENE_MODE_SPORT

static final String SCENE_MODE_SPORT
Scene Mode Type: Sport. Ideal for capturing sports or other quickly moving subjects.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

SCENE_MODE_LANDSCAPE

static final String SCENE_MODE_LANDSCAPE
Scene Mode Type: Landscape. Ideal for capturing bright, outdoor scenes; enhances the detail and sharpness of the scene.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

SCENE_MODE_PARTY

static final String SCENE_MODE_PARTY
Scene Mode Type: Party. Ideal for capturing people in dim, indoor environments.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

SCENE_MODE_MACRO

static final String SCENE_MODE_MACRO
Scene Mode Type: Macro. Ideal for capturing subjects that are close to the camera; enhances the detail and sharpness of close-up subjects.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

SCENE_MODE_SNOW

static final String SCENE_MODE_SNOW
Scene Mode Type: Snow. Ideal for capturing snow scenes; colors are accurately reproduced in scenes that are primarily white.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

SCENE_MODE_BEACH

static final String SCENE_MODE_BEACH
Scene Mode Type: Beach. Ideal for capturing beach scenes; colors are accurately reproduced in scenes of sea, sand, and sky.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

SCENE_MODE_NIGHT

static final String SCENE_MODE_NIGHT
Scene Mode Type: Night. Ideal for capturing dim, outdoor scenes.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

SCENE_MODE_TEXT

static final String SCENE_MODE_TEXT
Scene Mode Type: Text. Ideal for capturing text on white backgrounds; enhances the detail and sharpness of text.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0


Method Detail

setSceneMode

void setSceneMode(String modeID)
Enables the input Scene Mode specified by the modeID parameter. The modeID parameter can be any of the defined scene mode constants. When setting a scene mode, first check that the specified scene mode is available using isSceneModeSupported(String modeID) first. If you attempt to set an unavailable scene mode, this method does nothing. Setting a particular scene mode may modify other camera settings such as flash settings.

Parameters:
modeID - The scene mode to enable.
Since:
BlackBerry API 7.0.0

getCurrentSceneMode

String getCurrentSceneMode()
Retrieves the currently set scene mode on the device.

Returns:
The scene mode constant.
Since:
BlackBerry API 7.0.0

isSceneModeSupported

boolean isSceneModeSupported(String modeID)
Checks if the device supports the specified scene mode.

Parameters:
modeID - The scene mode to check for availability.
Returns:
true if the scene mode is available on the device, false otherwise.
Since:
BlackBerry API 7.0.0





Copyright 1999-2011 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Java is a trademark of Oracle America Inc. in the US and other countries.
Legal