|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
public interface EnhancedFocusControl
EnhancedFocusControl extends the functionality provided by
FocusControl to provide more functionality over the
camera focus. Note: If usage relies on a particular focus mode setting, then that
focus mode should be set explicitly via EnhancedFocusControl.setFocusMode(java.lang.String). Even if the desired focus mode currently
appears to be the default, the default focus mode is not guaranteed to stay the same.
Player player = javax.microedition.media.Manager.createPlayer( "capture://video?encoding=image/jpeg" );
EnhancedFocusControl efc = (EnhancedFocusControl) player.getControl("net.rim.device.api.amms.control.camera.EnhancedFocusControl");
| Field Summary | ||
|---|---|---|
static String |
FOCUS_MODE_CONTINUOUS
Focus Mode Type: Continuous. |
|
static String |
FOCUS_MODE_FIXED
Focus Mode Type: Fixed. |
|
static String |
FOCUS_MODE_SINGLESHOT
Focus Mode Type: Singleshot. |
|
| Fields inherited from interface javax.microedition.amms.control.camera.FocusControl |
|---|
AUTO, AUTO_LOCK, NEXT, PREVIOUS, UNKNOWN |
| Method Summary | ||
|---|---|---|
String |
getCurrentFocusMode()
Returns the currently set focus mode. |
|
boolean |
isAutoFocusLocked()
Returns whether or not the autofocus is locked. |
|
boolean |
isFocusModeSupported(String focusModeID)
Used to determine if the device supports the input Focus Mode settings is supported on the device. |
|
void |
setFocusMode(String focusMode)
Sets the desired focus mode setting. |
|
void |
startAutoFocus()
Locks the camera autofocus. |
|
void |
stopAutoFocus()
Unlocks the camera autofocus. |
|
| Methods inherited from interface javax.microedition.amms.control.camera.FocusControl |
|---|
getFocus, getFocusSteps, getMacro, getMinFocus, isAutoFocusSupported, isMacroSupported, isManualFocusSupported, setFocus, setMacro |
| Field Detail |
|---|
static final String FOCUS_MODE_FIXED
static final String FOCUS_MODE_SINGLESHOT
static final String FOCUS_MODE_CONTINUOUS
| Method Detail |
|---|
void startAutoFocus()
throws MediaException
EnhancedFocusControl.stopAutoFocus() is called, until a picture is taken (via burst shooting with a
SnapshotControl or
a call to VideoControl.getSnapshot(String)), or until the
viewfinder is stopped or closed. If the autofocus is already locked, this method
does nothing.
UnsupportedOperationException - If autofocus is not supported.
MediaException - If locking the autofocus fails.
void stopAutoFocus()
throws MediaException
MediaException - If unlocking the autofocus fails.boolean isAutoFocusLocked()
true if autofocus is locked, false otherwise.void setFocusMode(String focusMode)
focusMode - A value indicating the type of Focus Mode that will be set. Currently,
there are 3 focus modes settings, the focusMode values for each of the possible Focus Mode
settings are defined as follows:
FOCUS_MODE_FIXED - The focus is locked to infinity.
FOCUS_MODE_SINGLESHOT - The focus locked can be set manually via
EnhancedFocusControl.startAutoFocus()/EnhancedFocusControl.stopAutoFocus(). As well, if the focus,
is not manually locked, it will be locked during the photo capture when
VideoControl.getSnapshot(String)
is called.
FOCUS_MODE_CONTINUOUS - The focus is continuously scanned and set
automatically.
String getCurrentFocusMode()
boolean isFocusModeSupported(String focusModeID)
focusMode - A value indicating the type of Focus Mode that is checked. Currently,
there are 3 focus modes settings, the focusMode values for each of the possible Focus Mode
settings are defined as follows:
FOCUS_MODE_FIXED - The focus is locked to infinity.
FOCUS_MODE_SINGLESHOT - The focus locked can be set manually via
EnhancedFocusControl.startAutoFocus()/EnhancedFocusControl.stopAutoFocus(). As well, if the focus,
is not manually locked, it will be locked during the photo capture when
VideoControl.getSnapshot(String)
is called.
FOCUS_MODE_CONTINUOUS - The focus is continuously scanned and set
automatically.
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
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