ly.img.android.acs

Class Cam

java.lang.Object

ly.img.android.acs.Cam

public class Cam
extends java.lang.Object

Complex Camera Wrapper, for simple Camera use

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Cam.ANTI_BANDING
static class	Cam.CAMERA_FACING
static class	Cam.FLASH_MODE
static class	Cam.FOCUS_MODE
static interface	Cam.OnStateChangeListener Camera state change Interface
static class	Cam.PictureCallback Abstract picture callback
static class	Cam.SCENE_MODE
class	Cam.Size Size model
class	Cam.State Current Camera state object
static class	Cam.WHITE_BALANCE

Method Summary

Modifier and Type	Method and Description
Cam.CAMERA_FACING	getCameraFacing() Get the current camera facing.
int	getCameraOrientation() Get camera cameraOrientation
int	getCurrentExifOrientation()
Cam.FLASH_MODE	getFlashMode() Get the current FlashMode
static Cam	getInstance() Get a singleton Camera Instance.
Cam.Size	getPreviewSize() Get Preview Size
Cam.State	getState() Get the State of the current Camera settings.
boolean	hasSceneMode(java.lang.String mode) Check if the current state has scene mode is available.
static boolean	isAvailable() Check if min. 1 Camera is available.
boolean	isFront() Check if Camera is Front Camera
Cam.CAMERA_FACING	setCameraFacing(Cam.CAMERA_FACING cameraFacing) Try to set a Camera Facing.
Cam.FLASH_MODE	setFlashMode(Cam.FLASH_MODE mode) Try to set a flash mode and take a fallback mode if not supported by current Camera.
void	setFocus(java.util.List<android.hardware.Camera.Area> focusAreas) * Set Camera Focus.
void	setOnStateChangeListener(Cam.OnStateChangeListener onStateChangeListener) Set a listener to catch any settings state changes.
void	setPreviewSize(int maxTextureSize, int maxRenderBufferSize) Set the maximum TextureSize the device will support.
Cam.SCENE_MODE	setSceneMode(Cam.SCENE_MODE mode) Try to set a Scene mode and take a fallback mode if not supported by current Camera.
void	setSurface(android.view.SurfaceHolder holder) Set Preview Texture or a Surface holder
void	setSurface(android.graphics.SurfaceTexture surfaceTexture) Set Preview Texture
void	startPreview() Start the Camera Preview, this is async and will begin if the surface are set.
void	stopPreview(boolean release) Stop the Camera Preview and release the surface.
void	takePicture(CamView.CaptureCallback callback, java.lang.String outputPath) * Take a Picture

Methods inherited from class java.lang.Object

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

Method Detail

isAvailable

public static boolean isAvailable()

Check if min. 1 Camera is available.

Returns:

true if a Camera exists

getInstance

public static Cam getInstance()

Get a singleton Camera Instance.

Returns:

Cam Class instance.

getState

@NonNull
public Cam.State getState()

Get the State of the current Camera settings. This is a singleton

Returns:

Cam State object

setOnStateChangeListener

public void setOnStateChangeListener(Cam.OnStateChangeListener onStateChangeListener)

Set a listener to catch any settings state changes.

Parameters:

onStateChangeListener - state change callback.

setSurface

public void setSurface(android.graphics.SurfaceTexture surfaceTexture)

Set Preview Texture

Parameters:

surfaceTexture - SurfaceTexture that should receive the Camera image

setSurface

public void setSurface(android.view.SurfaceHolder holder)

Set Preview Texture or a Surface holder

Parameters:

holder - Surface holder that should receive the Camera image

setFocus

public void setFocus(java.util.List<android.hardware.Camera.Area> focusAreas)

* Set Camera Focus.

Parameters:

focusAreas - list of focus areas

setFlashMode

@Nullable
public Cam.FLASH_MODE setFlashMode(Cam.FLASH_MODE mode)

Try to set a flash mode and take a fallback mode if not supported by current Camera.

Parameters:

mode - flash mode.

Returns:

return the accepted mode, it can be the same as requested or a supported fallback mode.

getFlashMode

public Cam.FLASH_MODE getFlashMode()

Get the current FlashMode

setSceneMode

@Nullable
public Cam.SCENE_MODE setSceneMode(Cam.SCENE_MODE mode)

Try to set a Scene mode and take a fallback mode if not supported by current Camera.

Parameters:

mode - scene mode.

Returns:

return the accepted mode, it can be the same as requested or a supported fallback mode.

hasSceneMode

@Nullable
public boolean hasSceneMode(java.lang.String mode)

Check if the current state has scene mode is available.

Parameters:

mode - scene mode.

Returns:

return the accepted mode, it can be the same as requested or a supported fallback mode.

setCameraFacing

public Cam.CAMERA_FACING setCameraFacing(Cam.CAMERA_FACING cameraFacing)

Try to set a Camera Facing.

Parameters:

cameraFacing - camera facing.

Returns:

return the accepted camera facing.

getCameraFacing

public Cam.CAMERA_FACING getCameraFacing()

Get the current camera facing.

Returns:

current camera facing.

takePicture

public void takePicture(CamView.CaptureCallback callback,
                        java.lang.String outputPath)

* Take a Picture

Parameters:

callback - Callback that fired after image will saved as jpg.

outputPath - the output path for saving the image

getCurrentExifOrientation

public int getCurrentExifOrientation()

startPreview

public void startPreview()

Start the Camera Preview, this is async and will begin if the surface are set.

stopPreview

public void stopPreview(boolean release)

Stop the Camera Preview and release the surface.

setPreviewSize

public void setPreviewSize(int maxTextureSize,
                           int maxRenderBufferSize)

Set the maximum TextureSize the device will support. The preview only start, if it would be set.

Parameters:

maxTextureSize - max OpenGl texture size

maxRenderBufferSize - max OpenGl buffer size

getPreviewSize

@Nullable
public Cam.Size getPreviewSize()

Get Preview Size

Returns:

getCameraOrientation

public int getCameraOrientation()

Get camera cameraOrientation

Returns:

cameraOrientation of the camera.

isFront

public boolean isFront()

Check if Camera is Front Camera

Returns:

true if current camera is front camera