com.pili.pldroid.streaming

Class CameraStreamingSetting

java.lang.Object

com.pili.pldroid.streaming.CameraStreamingSetting

public class CameraStreamingSetting
extends java.lang.Object

CameraStreamingSetting is the main setting class for Camera.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CameraStreamingSetting.PREVIEW_SIZE_LEVEL Preview size level that can be used.
static class	CameraStreamingSetting.PREVIEW_SIZE_RATIO Preview size ratio that can be used.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	FOCUS_MODE_AUTO Auto-focus mode.
static java.lang.String	FOCUS_MODE_CONTINUOUS_PICTURE Continuous auto focus mode intended for taking pictures.
static java.lang.String	FOCUS_MODE_CONTINUOUS_VIDEO Continuous auto focus mode intended for video recording.

Constructor Summary

Constructors

Constructor and Description
CameraStreamingSetting()

Method Summary

Modifier and Type	Method and Description
int	getCameraPreviewHeight()
int	getCameraPreviewWidth()
java.lang.String	getFocusMode() Gets current focus mode.
CameraStreamingSetting.PREVIEW_SIZE_LEVEL	getPrvSizeLevel() Gets current preview size level.
CameraStreamingSetting.PREVIEW_SIZE_RATIO	getPrvSizeRatio() Gets current preview size ratio.
int	getReqCameraId() Get the request camera id.
int	getResetTouchFocusDelay() Gets current delay of reset touch focus mode.
boolean	hasRecordingHint() Gets the recording hint setting.
boolean	isCAFEnabled() Gets CAF if enabled.
boolean	isCameraSourceImproved()
boolean	isFrontCameraMirror() Gets the flag if mirror the front camera.
boolean	isPreferredRatioAdded()
CameraStreamingSetting	setCameraId(int reqCamId) Sets request camera id of android.hardware.Camera.CameraInfo#CAMERA_FACING_FRONT or android.hardware.Camera.CameraInfo#CAMERA_FACING_BACK.
CameraStreamingSetting	setCameraPreviewSize(int w, int h)
CameraStreamingSetting	setCameraPrvSizeLevel(CameraStreamingSetting.PREVIEW_SIZE_LEVEL level) set the preview size level.
CameraStreamingSetting	setCameraPrvSizeRatio(CameraStreamingSetting.PREVIEW_SIZE_RATIO ratio) set the preview size ratio.
CameraStreamingSetting	setContinuousFocusModeEnabled(boolean enabled) enable/disable the continuous auto focus (CAF) mode.
CameraStreamingSetting	setFocusMode(java.lang.String focusMode) Sets focus mode of FOCUS_MODE_CONTINUOUS_VIDEO, FOCUS_MODE_CONTINUOUS_PICTURE, and FOCUS_MODE_AUTO.
CameraStreamingSetting	setFrontCameraMirror(boolean isMirror) Mirror the front camera while encoding.
CameraStreamingSetting	setRecordingHint(boolean hint) Sets recording mode hint.
CameraStreamingSetting	setResetTouchFocusDelayInMs(int delayInMs) The delay of reset touch focus mode in millisecond.
void	updateCameraPrvSizeRatio(CameraStreamingSetting.PREVIEW_SIZE_RATIO ratio)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

FOCUS_MODE_AUTO

public static final java.lang.String FOCUS_MODE_AUTO

Auto-focus mode. Applications should call Camera#autoFocus(Camera.AutoFocusCallback) to start the focus in this mode.

FOCUS_MODE_CONTINUOUS_PICTURE

public static final java.lang.String FOCUS_MODE_CONTINUOUS_PICTURE

Continuous auto focus mode intended for taking pictures. The camera continuously tries to focus. The speed of focus change is more aggressive than FOCUS_MODE_CONTINUOUS_VIDEO.

FOCUS_MODE_CONTINUOUS_VIDEO

public static final java.lang.String FOCUS_MODE_CONTINUOUS_VIDEO

Continuous auto focus mode intended for video recording. The camera continuously tries to focus. This is the best choice for video recording because the focus changes smoothly.

It is strongly recommend that set this focus mode to avoid sharp focusing.

Constructor Detail

CameraStreamingSetting

public CameraStreamingSetting()

Method Detail

setCameraPrvSizeLevel

public CameraStreamingSetting setCameraPrvSizeLevel(CameraStreamingSetting.PREVIEW_SIZE_LEVEL level)

set the preview size level.

Parameters:

level - the level of CameraStreamingSetting.PREVIEW_SIZE_LEVEL

Returns:

this

setCameraPrvSizeRatio

public CameraStreamingSetting setCameraPrvSizeRatio(CameraStreamingSetting.PREVIEW_SIZE_RATIO ratio)

set the preview size ratio.

Parameters:

ratio - the ratio of CameraStreamingSetting.PREVIEW_SIZE_RATIO

Returns:

this

setContinuousFocusModeEnabled

public CameraStreamingSetting setContinuousFocusModeEnabled(boolean enabled)

enable/disable the continuous auto focus (CAF) mode.

If the device do not support CAF, there isn't only focusing effect even enable the CAF.

The default value is true.

Parameters:

enabled - true means enable the CAF; otherwise, disable.

Returns:

this

setRecordingHint

public CameraStreamingSetting setRecordingHint(boolean hint)

Sets recording mode hint.

This can have a big impact on frame rate.

The default value is false.

Parameters:

hint - true means enable the hint; otherwise, disable.

Returns:

this

setCameraId

public CameraStreamingSetting setCameraId(int reqCamId)

Sets request camera id of android.hardware.Camera.CameraInfo#CAMERA_FACING_FRONT or android.hardware.Camera.CameraInfo#CAMERA_FACING_BACK.

Parameters:

reqCamId - the request camera id.

Returns:

this

setFocusMode

public CameraStreamingSetting setFocusMode(java.lang.String focusMode)

Sets focus mode of FOCUS_MODE_CONTINUOUS_VIDEO, FOCUS_MODE_CONTINUOUS_PICTURE, and FOCUS_MODE_AUTO. If set the FOCUS_MODE_CONTINUOUS_VIDEO or FOCUS_MODE_CONTINUOUS_PICTURE, the value by setContinuousFocusModeEnabled(boolean) will be forced to true, otherwise, false. That means, call this will affect the value witch set by setContinuousFocusModeEnabled(boolean).

Parameters:

focusMode - can be FOCUS_MODE_CONTINUOUS_VIDEO, FOCUS_MODE_CONTINUOUS_PICTURE, and FOCUS_MODE_AUTO.

Returns:

this

setResetTouchFocusDelayInMs

public CameraStreamingSetting setResetTouchFocusDelayInMs(int delayInMs)

The delay of reset touch focus mode in millisecond.

Parameters:

delayInMs - If delayInMs is greater than 0, after delayInMs the focus area will be reset and focus mode will be reset to the previous focus mode which set by setFocusMode(String) or the default focus mode FOCUS_MODE_CONTINUOUS_VIDEO. If delayInMs is lower than 0, after the absolute value of delayInMs, the focus area will be reset but focus mode still keep FOCUS_MODE_AUTO without change.

Returns:

this

setFrontCameraMirror

public CameraStreamingSetting setFrontCameraMirror(boolean isMirror)

Mirror the front camera while encoding.

Parameters:

isMirror - true means mirror the front camera; false means not mirror.

Returns:

this

isFrontCameraMirror

public boolean isFrontCameraMirror()

Gets the flag if mirror the front camera.

Returns:

true if mirror.

getResetTouchFocusDelay

public int getResetTouchFocusDelay()

Gets current delay of reset touch focus mode.

Returns:

current delay in millisecond.

getFocusMode

public java.lang.String getFocusMode()

Gets current focus mode.

Returns:

current focus mode of FOCUS_MODE_AUTO, FOCUS_MODE_CONTINUOUS_PICTURE and FOCUS_MODE_CONTINUOUS_VIDEO.

hasRecordingHint

public boolean hasRecordingHint()

Gets the recording hint setting.

Returns:

true means enable the hint; otherwise, disable.

getPrvSizeRatio

public CameraStreamingSetting.PREVIEW_SIZE_RATIO getPrvSizeRatio()

Gets current preview size ratio.

Returns:

the ratio of CameraStreamingSetting.PREVIEW_SIZE_RATIO

getPrvSizeLevel

public CameraStreamingSetting.PREVIEW_SIZE_LEVEL getPrvSizeLevel()

Gets current preview size level.

Returns:

the ratio of CameraStreamingSetting.PREVIEW_SIZE_LEVEL

getReqCameraId

public int getReqCameraId()

Get the request camera id.

Returns:

the request camera id.

isCAFEnabled

public boolean isCAFEnabled()

Gets CAF if enabled.

Returns:

true means enable the CAF; otherwise, disable.

isCameraSourceImproved

public boolean isCameraSourceImproved()

updateCameraPrvSizeRatio

public void updateCameraPrvSizeRatio(CameraStreamingSetting.PREVIEW_SIZE_RATIO ratio)

getCameraPreviewWidth

public int getCameraPreviewWidth()

getCameraPreviewHeight

public int getCameraPreviewHeight()

isPreferredRatioAdded

public boolean isPreferredRatioAdded()

setCameraPreviewSize

public CameraStreamingSetting setCameraPreviewSize(int w,
                                                   int h)