MasCameraDevice Class Reference

class for camera device handling More...

#import <MasCameraDevice.h>

Inheritance diagram for MasCameraDevice:

Collaboration diagram for MasCameraDevice:

Instance Methods
(MasResultCode)	- start:width:height:
	Start camera preview. More...
(void)	- stop
	Stop camera preview. More...
(int)	- getWidth
(int)	- getHeight
(bool)	- setFocusMode:
(bool)	- setZoom:
	Set Camera Zoom Scale. More...
(int)	- getMaxZoomValue
	Get Camera Device Max Zoom value. More...
(bool)	- setFlashLightMode:
	Turn on/off flash light. More...
(bool)	- setAutoWhiteBalanceLock:
	Turn on/off auto white balance lock. More...
(void)	- flipVideo:toggle:
	Flip video. More...
(void)	- setCalibrationData:
(void)	- setNewFrame:length:width:height:format:
	Set new image data for tracking and background rendering (Free, Enterprise license key can activate this interface) More...
(void)	- setNewFrameAndTimestamp:length:width:height:format:timestamp:
	Set new image data for tracking and background rendering (Free, Enterprise license key can activate this interface) More...
(matrix_float4x4)	- getProjectionMatrix
	Get projection matrix. This is used for augmented objects projection and background rendering. More...
(matrix_float4x4)	- getBackgroundPlaneProjectionMatrix
	Get projection matrix for background plane rendering. More...

Protected Types
enum	MasFocusMode : int { FOCUS_MODE_CONTINUOUS_AUTO = 1, FOCUS_MODE_AUTO = 2 }
	Camera focus mode @constant FOCUS_MODE_CONTINUOUS_AUTO Continuous focus mode. This focus mode is proper for AR @constant FOCUS_MODE_AUTO Scingle auto focus mode. More...
enum	MasFlipDirection : int { HORIZONTAL = 0, VERTICAL = 1 }
	Video data flip direction @constant HORIZONTAL Flip video horizontally @constant VERTICAL Flip video vertically. More...
enum	MasResultCode : int {   Success = 0, CameraPermissionIsNotResolved = 100, CameraDevicedRestriced = 101, CameraPermissionIsNotGranted = 102,   CameraAlreadyOpened = 103, TrackerAlreadyStarted = 200, UnknownError = 1000 }
	Camera Open State @constant Success @constant CameraPermissionIsNotResolved @constant CameraDevicedRestriced @constant CameraPermissionIsNotGranted @constant CameraAlreadyOpened @constant TrackerAlreadyStarted @constant UnknownError. More...

Detailed Description

class for camera device handling

Member Enumeration Documentation

MasFlipDirection

- (enum MasFlipDirection) :

protected

Video data flip direction @constant HORIZONTAL Flip video horizontally @constant VERTICAL Flip video vertically.

Enumerator
HORIZONTAL
VERTICAL

MasFocusMode

- (enum MasFocusMode) :

protected

Camera focus mode @constant FOCUS_MODE_CONTINUOUS_AUTO Continuous focus mode. This focus mode is proper for AR @constant FOCUS_MODE_AUTO Scingle auto focus mode.

Enumerator
FOCUS_MODE_CONTINUOUS_AUTO
FOCUS_MODE_AUTO

MasResultCode

- (enum MasResultCode) :

protected

Camera Open State @constant Success @constant CameraPermissionIsNotResolved @constant CameraDevicedRestriced @constant CameraPermissionIsNotGranted @constant CameraAlreadyOpened @constant TrackerAlreadyStarted @constant UnknownError.

Enumerator
Success
CameraPermissionIsNotResolved
CameraDevicedRestriced
CameraPermissionIsNotGranted
CameraAlreadyOpened
TrackerAlreadyStarted
UnknownError

Method Documentation

flipVideo:toggle:()

- (void) flipVideo:		(MasFlipDirection)	direction
toggle:		(bool)	toggle

Flip video.

Parameters

direction	Flip direction
toggle	true for set, false for reset

getBackgroundPlaneProjectionMatrix()

- (matrix_float4x4) getBackgroundPlaneProjectionMatrix

Get projection matrix for background plane rendering.

Returns

4x4 matrix (Column major)

getHeight()

- (int) getHeight

Returns

camera preview height

getMaxZoomValue()

- (int) getMaxZoomValue

Get Camera Device Max Zoom value.

Returns

Max Zoom value.

getProjectionMatrix()

- (matrix_float4x4) getProjectionMatrix

Get projection matrix. This is used for augmented objects projection and background rendering.

Returns

4x4 matrix (Column major)

getWidth()

- (int) getWidth

Returns

camera preview width

setAutoWhiteBalanceLock:()

- (bool) setAutoWhiteBalanceLock:

(bool)

toggle

Turn on/off auto white balance lock.

setCalibrationData:()

- (void) setCalibrationData:

(NSString *)

filePath

setFlashLightMode:()

- (bool) setFlashLightMode:

(bool)

toggle

Turn on/off flash light.

setFocusMode:()

- (bool) setFocusMode:

(MasFocusMode)

mode

Returns

true if focus setting success

setNewFrame:length:width:height:format:()

- (void) setNewFrame:		(Byte *)	data
length:		(int)	length
width:		(int)	width
height:		(int)	height
format:		(MasColorFormat)	format

Set new image data for tracking and background rendering (Free, Enterprise license key can activate this interface)

Parameters

data	image data bytes.
length	image length
width	image width
height	image height
format	image format

setNewFrameAndTimestamp:length:width:height:format:timestamp:()

- (void) setNewFrameAndTimestamp:		(Byte *)	data
length:		(int)	length
width:		(int)	width
height:		(int)	height
format:		(MasColorFormat)	format
timestamp:		(unsigned long long int)	timestamp

Set new image data for tracking and background rendering (Free, Enterprise license key can activate this interface)

Parameters

data	image data bytes.
length	image length
width	image width
height	image height
format	image format
timestamp	image timestamp

setZoom:()

- (bool) setZoom:

(float)

zoomScale

Set Camera Zoom Scale.

Parameters

zoomScale

Zoom value

Returns

result Zoom.

start:width:height:()

- (MasResultCode) start:		(int)	cameraId
width:		(int)	width
height:		(int)	height

Start camera preview.

Parameters

cameraId	0 is rear camera, 1 is face camera. camera index may depends on device.
width	prefer camera width
height	prefer camera height

Returns

MasResultCode

stop()

- (void) stop

Stop camera preview.

---

The documentation for this class was generated from the following file:

• /Users/keane/Work/MaxstARSDK/MaxstARSDK_master/MaxstAR/MaxstARiOS/MasCameraDevice.h