Table of Contents

Class ThreeDofCameraDevice

Namespace
easyar

ThreeDofCameraDevice implements a three DOF camera device, outputs CameraTransformType as ThreeDofRotOnly of InputFrame (including image, camera parameters, timestamp, pose transformation matrix, and tracking status). After creation, start/stop can be called to start and stop collecting video stream data. When no longer needed, the device can be closed by calling close. It should not be used after close. ThreeDofCameraDevice outputs InputFrame through inputFrameSource, which should be connected to InputFrameSink for use. bufferCapacity indicates the buffer capacity of InputFrame. If there are more than this number of InputFrame output from the device and not released, the device will no longer output new InputFrame until the previous InputFrame is released. This may cause issues such as screen freezing.

ThreeDofCameraDevice

Constructors

ThreeDofCameraDevice

Default creation method.

void easyar_ThreeDofCameraDevice__ctor(easyar_ThreeDofCameraDevice * * Return)
ThreeDofCameraDevice()
public ThreeDofCameraDevice()
constructor()
+ (easyar_ThreeDofCameraDevice *) create
public convenience init()
public ThreeDofCameraDevice()

Methods

isAvailable

Check if available. Returns true only on Android or iOS and when gyroscope is available.

bool easyar_ThreeDofCameraDevice_isAvailable(void)
static bool isAvailable()
public static boolean isAvailable()
companion object fun isAvailable(): Boolean
+ (bool)isAvailable
public static func isAvailable() -> Bool
public static bool isAvailable()

Returns

Boolean

bufferCapacity

Buffer capacity of InputFrame, default value is 8.

int easyar_ThreeDofCameraDevice_bufferCapacity(const easyar_ThreeDofCameraDevice * This)
int bufferCapacity()
public int bufferCapacity()
fun bufferCapacity(): Int
- (int)bufferCapacity
public func bufferCapacity() -> Int32
public virtual int bufferCapacity()

Returns

Int32

setBufferCapacity

Set buffer capacity of InputFrame.

void easyar_ThreeDofCameraDevice_setBufferCapacity(easyar_ThreeDofCameraDevice * This, int capacity)
void setBufferCapacity(int capacity)
public void setBufferCapacity(int capacity)
fun setBufferCapacity(capacity: Int): Unit
- (void)setBufferCapacity:(int)capacity
public func setBufferCapacity(_ capacity: Int32) -> Void
public virtual void setBufferCapacity(int capacity)

Parameters

capacity Int32

Returns

Void

inputFrameSource

Output port of InputFrame.

void easyar_ThreeDofCameraDevice_inputFrameSource(easyar_ThreeDofCameraDevice * This, easyar_InputFrameSource * * Return)
std::shared_ptr<InputFrameSource> inputFrameSource()
public @Nonnull InputFrameSource inputFrameSource()
fun inputFrameSource(): InputFrameSource
- (easyar_InputFrameSource *)inputFrameSource
public func inputFrameSource() -> InputFrameSource
public virtual InputFrameSource inputFrameSource()

Returns

InputFrameSource

setFocusMode

Set focus mode to focusMode. Called before start.

void easyar_ThreeDofCameraDevice_setFocusMode(easyar_ThreeDofCameraDevice * This, easyar_ThreeDofCameraDeviceFocusMode focusMode)
void setFocusMode(ThreeDofCameraDeviceFocusMode focusMode)
public void setFocusMode(int focusMode)
fun setFocusMode(focusMode: Int): Unit
- (void)setFocusMode:(easyar_ThreeDofCameraDeviceFocusMode)focusMode
public func setFocusMode(_ focusMode: ThreeDofCameraDeviceFocusMode) -> Void
public virtual void setFocusMode(ThreeDofCameraDeviceFocusMode focusMode)

Parameters

focusMode ThreeDofCameraDeviceFocusMode

Returns

Void

type

Camera type. Called after successful open.

easyar_CameraDeviceType easyar_ThreeDofCameraDevice_type(const easyar_ThreeDofCameraDevice * This)
CameraDeviceType type()
public int type()
fun type(): Int
- (easyar_CameraDeviceType)type
public func type() -> CameraDeviceType
public virtual CameraDeviceType type()

Returns

CameraDeviceType

cameraOrientation

The angle that the camera image needs to rotate clockwise when displayed in the device's natural orientation. Called after successful open.

int easyar_ThreeDofCameraDevice_cameraOrientation(const easyar_ThreeDofCameraDevice * This)
int cameraOrientation()
public int cameraOrientation()
fun cameraOrientation(): Int
- (int)cameraOrientation
public func cameraOrientation() -> Int32
public virtual int cameraOrientation()

Returns

Int32

size

Get current image size. Called after successful open.

easyar_Vec2I easyar_ThreeDofCameraDevice_size(const easyar_ThreeDofCameraDevice * This)
Vec2I size()
public @Nonnull Vec2I size()
fun size(): Vec2I
- (easyar_Vec2I *)size
public func size() -> Vec2I
public virtual Vec2I size()

Returns

Vec2I

supportedSizeCount

Get the number of all supported image sizes of the current device. Called after successful open.

int easyar_ThreeDofCameraDevice_supportedSizeCount(const easyar_ThreeDofCameraDevice * This)
int supportedSizeCount()
public int supportedSizeCount()
fun supportedSizeCount(): Int
- (int)supportedSizeCount
public func supportedSizeCount() -> Int32
public virtual int supportedSizeCount()

Returns

Int32

supportedSize

Get the index-th supported image size of the current device. Returns {0, 0} if index is out of range. Called after successful open.

easyar_Vec2I easyar_ThreeDofCameraDevice_supportedSize(const easyar_ThreeDofCameraDevice * This, int index)
Vec2I supportedSize(int index)
public @Nonnull Vec2I supportedSize(int index)
fun supportedSize(index: Int): Vec2I
- (easyar_Vec2I *)supportedSize:(int)index
public func supportedSize(_ index: Int32) -> Vec2I
public virtual Vec2I supportedSize(int index)

Parameters

index Int32

Returns

Vec2I

setSize

Set current image size. The closest optional value to the set value will be used. Use size to get the actual size. Called after successful open. frameRateRange may change after setting size.

bool easyar_ThreeDofCameraDevice_setSize(easyar_ThreeDofCameraDevice * This, easyar_Vec2I size)
bool setSize(Vec2I size)
public boolean setSize(@Nonnull Vec2I size)
fun setSize(size: Vec2I): Boolean
- (bool)setSize:(easyar_Vec2I *)size
public func setSize(_ size: Vec2I) -> Bool
public virtual bool setSize(Vec2I size)

Parameters

size Vec2I

Returns

Boolean

open

Open the device's rear camera. Returns false if opening fails.

bool easyar_ThreeDofCameraDevice_open(easyar_ThreeDofCameraDevice * This)
bool open()
public boolean open()
fun open(): Boolean
- (bool)open
public func `open`() -> Bool
public virtual bool open()

Returns

Boolean

start

Start collecting video stream data.

bool easyar_ThreeDofCameraDevice_start(easyar_ThreeDofCameraDevice * This)
bool start()
public boolean start()
fun start(): Boolean
- (bool)start
public func start() -> Bool
public virtual bool start()

Returns

Boolean

stop

Stop collecting video stream data.

void easyar_ThreeDofCameraDevice_stop(easyar_ThreeDofCameraDevice * This)
void stop()
public void stop()
fun stop(): Unit
- (void)stop
public func stop() -> Void
public virtual void stop()

Returns

Void

close

Close. Should not be used after close.

void easyar_ThreeDofCameraDevice_close(easyar_ThreeDofCameraDevice * This)
void close()
public void close()
fun close(): Unit
- (void)close
public func close() -> Void
public virtual void close()

Returns

Void

frameRateRangeLower

Get current frame rate range lower bound. Called after successful open.

double easyar_ThreeDofCameraDevice_frameRateRangeLower(const easyar_ThreeDofCameraDevice * This)
double frameRateRangeLower()
public double frameRateRangeLower()
fun frameRateRangeLower(): Double
- (double)frameRateRangeLower
public func frameRateRangeLower() -> Double
public virtual double frameRateRangeLower()

Returns

Double

frameRateRangeUpper

Get current frame rate range upper bound. Called after successful open.

double easyar_ThreeDofCameraDevice_frameRateRangeUpper(const easyar_ThreeDofCameraDevice * This)
double frameRateRangeUpper()
public double frameRateRangeUpper()
fun frameRateRangeUpper(): Double
- (double)frameRateRangeUpper
public func frameRateRangeUpper() -> Double
public virtual double frameRateRangeUpper()

Returns

Double