Table of Contents

Class MotionTrackerCameraDevice

命名空間
easyar

MotionTrackerCameraDevice實現了一款真實尺度6DOF運動追蹤的攝影機裝置，輸出 InputFrame（包含影像、攝影機參數、時間戳、6DOF位置資訊和追蹤狀態）。 創建後可調用start/stop來啟動及停止資料流。 當不再需要此裝置時，可調用close進行關閉。close後不應繼續使用。 MotionTrackerCameraDevice透過inputFrameSource輸出 InputFrame，應將inputFrameSource連接至 InputFrameSink 使用。

MotionTrackerCameraDevice

建構函式

MotionTrackerCameraDevice

建立MotionTrackerCameraDevice物件。

void easyar_MotionTrackerCameraDevice__ctor(easyar_MotionTrackerCameraDevice * * Return)
MotionTrackerCameraDevice()
public MotionTrackerCameraDevice()
constructor()
+ (easyar_MotionTrackerCameraDevice *) create
public convenience init()
public MotionTrackerCameraDevice()

方法

isAvailable

檢查裝置是否支援運動追蹤。裝置支援此功能時回傳True，否則回傳False。

bool easyar_MotionTrackerCameraDevice_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()

傳回值

類型 描述
Boolean

getQualityLevel

取得裝置上運動追蹤的品質，可結合應用場景以此值判斷是否啟動運動追蹤。

easyar_MotionTrackerCameraDeviceQualityLevel easyar_MotionTrackerCameraDevice_getQualityLevel(void)
static MotionTrackerCameraDeviceQualityLevel getQualityLevel()
public static int getQualityLevel()
companion object fun getQualityLevel(): Int
+ (easyar_MotionTrackerCameraDeviceQualityLevel)getQualityLevel
public static func getQualityLevel() -> MotionTrackerCameraDeviceQualityLevel
public static MotionTrackerCameraDeviceQualityLevel getQualityLevel()

傳回值

類型 描述
MotionTrackerCameraDeviceQualityLevel

setFrameRateType

設定當前裝置的幀率。需於start前調用。若未調用此功能，預設為30fps

bool easyar_MotionTrackerCameraDevice_setFrameRateType(easyar_MotionTrackerCameraDevice * This, easyar_MotionTrackerCameraDeviceFPS fps)
bool setFrameRateType(MotionTrackerCameraDeviceFPS fps)
public boolean setFrameRateType(int fps)
fun setFrameRateType(fps: Int): Boolean
- (bool)setFrameRateType:(easyar_MotionTrackerCameraDeviceFPS)fps
public func setFrameRateType(_ fps: MotionTrackerCameraDeviceFPS) -> Bool
public virtual bool setFrameRateType(MotionTrackerCameraDeviceFPS fps)

參數

名稱 類型 描述
fps MotionTrackerCameraDeviceFPS

傳回值

類型 描述
Boolean

setFocusMode

設定對焦模式為focusMode。需於start前調用。若未調用此功能，預設為連續自動對焦

bool easyar_MotionTrackerCameraDevice_setFocusMode(easyar_MotionTrackerCameraDevice * This, easyar_MotionTrackerCameraDeviceFocusMode focusMode)
bool setFocusMode(MotionTrackerCameraDeviceFocusMode focusMode)
public boolean setFocusMode(int focusMode)
fun setFocusMode(focusMode: Int): Boolean
- (bool)setFocusMode:(easyar_MotionTrackerCameraDeviceFocusMode)focusMode
public func setFocusMode(_ focusMode: MotionTrackerCameraDeviceFocusMode) -> Bool
public virtual bool setFocusMode(MotionTrackerCameraDeviceFocusMode focusMode)

參數

名稱 類型 描述
focusMode MotionTrackerCameraDeviceFocusMode

傳回值

類型 描述
Boolean

setFrameResolutionType

設定幀解析度。需於start前調用。若未調用此功能，預設為1280x960或1280x720

bool easyar_MotionTrackerCameraDevice_setFrameResolutionType(easyar_MotionTrackerCameraDevice * This, easyar_MotionTrackerCameraDeviceResolution resolution)
bool setFrameResolutionType(MotionTrackerCameraDeviceResolution resolution)
public boolean setFrameResolutionType(int resolution)
fun setFrameResolutionType(resolution: Int): Boolean
- (bool)setFrameResolutionType:(easyar_MotionTrackerCameraDeviceResolution)resolution
public func setFrameResolutionType(_ resolution: MotionTrackerCameraDeviceResolution) -> Bool
public virtual bool setFrameResolutionType(MotionTrackerCameraDeviceResolution resolution)

參數

名稱 類型 描述
resolution MotionTrackerCameraDeviceResolution

傳回值

類型 描述
Boolean

setTrackingMode

設定追蹤模式。需於start前調用。若未調用此功能，預設為錨點模式

bool easyar_MotionTrackerCameraDevice_setTrackingMode(easyar_MotionTrackerCameraDevice * This, easyar_MotionTrackerCameraDeviceTrackingMode trackingMode)
bool setTrackingMode(MotionTrackerCameraDeviceTrackingMode trackingMode)
public boolean setTrackingMode(int trackingMode)
fun setTrackingMode(trackingMode: Int): Boolean
- (bool)setTrackingMode:(easyar_MotionTrackerCameraDeviceTrackingMode)trackingMode
public func setTrackingMode(_ trackingMode: MotionTrackerCameraDeviceTrackingMode) -> Bool
public virtual bool setTrackingMode(MotionTrackerCameraDeviceTrackingMode trackingMode)

參數

名稱 類型 描述
trackingMode MotionTrackerCameraDeviceTrackingMode

傳回值

類型 描述
Boolean

setBufferCapacity

設定 InputFrame 緩衝區容量。 bufferCapacity表示緩衝區容量上限，若輸出且未被釋放的 InputFrame 數量超過此值，裝置將停止輸出新幀，直至舊幀被釋放。此情況可能導致畫面卡頓等問題。

void easyar_MotionTrackerCameraDevice_setBufferCapacity(easyar_MotionTrackerCameraDevice * 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)

參數

名稱 類型 描述
capacity Int32

傳回值

類型 描述
Void

bufferCapacity

取得 InputFrame 緩衝區容量，預設值為8。

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

傳回值

類型 描述
Int32

inputFrameSource

InputFrame 輸出端口。

void easyar_MotionTrackerCameraDevice_inputFrameSource(easyar_MotionTrackerCameraDevice * 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()

傳回值

類型 描述
InputFrameSource

start

啟動運動追蹤，或從暫停狀態觸發重定位，成功後繼續追蹤。 注意：若裝置經stop暫停後再調用start，將觸發重定位流程，僅在重定位成功後才會恢復追蹤。

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

傳回值

類型 描述
Boolean

stop

暫停運動追蹤。調用start將觸發重定位，成功後繼續追蹤。

void easyar_MotionTrackerCameraDevice_stop(easyar_MotionTrackerCameraDevice * This)
void stop()
public void stop()
fun stop(): Unit
- (void)stop
public func stop() -> Void
public virtual void stop()

傳回值

類型 描述
Void

close

關閉運動追蹤流程。close後不應繼續使用。

void easyar_MotionTrackerCameraDevice_close(easyar_MotionTrackerCameraDevice * This)
void close()
public void close()
fun close(): Unit
- (void)close
public func close() -> Void
public virtual void close()

傳回值

類型 描述
Void

type

攝影機類型。需在成功start後調用。

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

傳回值

類型 描述
CameraDeviceType

cameraOrientation

攝影機影像於裝置自然方向顯示時需順時針旋轉的角度。需在成功start後調用。

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

傳回值

類型 描述
Int32

size

取得當前影像尺寸。需在成功start後調用。

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

傳回值

類型 描述
Vec2I

frameRateRangeLower

取得當前幀率範圍下限值。需在成功open後調用。

double easyar_MotionTrackerCameraDevice_frameRateRangeLower(const easyar_MotionTrackerCameraDevice * This)
double frameRateRangeLower()
public double frameRateRangeLower()
fun frameRateRangeLower(): Double
- (double)frameRateRangeLower
public func frameRateRangeLower() -> Double
public virtual double frameRateRangeLower()

傳回值

類型 描述
Double

frameRateRangeUpper

取得當前幀率範圍上限值。需在成功open後調用。

double easyar_MotionTrackerCameraDevice_frameRateRangeUpper(const easyar_MotionTrackerCameraDevice * This)
double frameRateRangeUpper()
public double frameRateRangeUpper()
fun frameRateRangeUpper(): Double
- (double)frameRateRangeUpper
public func frameRateRangeUpper() -> Double
public virtual double frameRateRangeUpper()

傳回值

類型 描述
Double

hitTestAgainstPointCloud

於當前點雲中進行Hit Test，取得距離攝影機由近至遠射線上最近3D點位座標。該點以三個連續數值表示X、Y、Z軸座標。 輸入影像座標系（[0,1]^2）採x朝右、y朝下，原點位於左上角。可使用 imageCoordinatesFromScreenCoordinates 將螢幕座標轉換為影像座標。

void easyar_MotionTrackerCameraDevice_hitTestAgainstPointCloud(easyar_MotionTrackerCameraDevice * This, easyar_Vec2F cameraImagePoint, easyar_ListOfVec3F * * Return)
std::vector<Vec3F> hitTestAgainstPointCloud(Vec2F cameraImagePoint)
public java.util.@Nonnull ArrayList<@Nonnull Vec3F> hitTestAgainstPointCloud(@Nonnull Vec2F cameraImagePoint)
fun hitTestAgainstPointCloud(cameraImagePoint: Vec2F): ArrayList<Vec3F>
- (NSArray<easyar_Vec3F *> *)hitTestAgainstPointCloud:(easyar_Vec2F *)cameraImagePoint
public func hitTestAgainstPointCloud(_ cameraImagePoint: Vec2F) -> [Vec3F]
public virtual List<Vec3F> hitTestAgainstPointCloud(Vec2F cameraImagePoint)

參數

名稱 類型 描述
cameraImagePoint Vec2F

傳回值

類型 描述
List<Vec3F>

hitTestAgainstHorizontalPlane

於當前視野即時偵測的水平面上進行Hit Test，點擊平面後回傳該平面距離射線最近的3D點位座標。 輸入影像座標系（[0,1]^2）採x朝右、y朝下，原點位於左上角。可使用 imageCoordinatesFromScreenCoordinates 將螢幕座標轉換為影像座標。 輸出為平面上點雲在世界座標系中的座標，每點以三個連續數值表示X、Y、Z軸座標。

void easyar_MotionTrackerCameraDevice_hitTestAgainstHorizontalPlane(easyar_MotionTrackerCameraDevice * This, easyar_Vec2F cameraImagePoint, easyar_ListOfVec3F * * Return)
std::vector<Vec3F> hitTestAgainstHorizontalPlane(Vec2F cameraImagePoint)
public java.util.@Nonnull ArrayList<@Nonnull Vec3F> hitTestAgainstHorizontalPlane(@Nonnull Vec2F cameraImagePoint)
fun hitTestAgainstHorizontalPlane(cameraImagePoint: Vec2F): ArrayList<Vec3F>
- (NSArray<easyar_Vec3F *> *)hitTestAgainstHorizontalPlane:(easyar_Vec2F *)cameraImagePoint
public func hitTestAgainstHorizontalPlane(_ cameraImagePoint: Vec2F) -> [Vec3F]
public virtual List<Vec3F> hitTestAgainstHorizontalPlane(Vec2F cameraImagePoint)

參數

名稱 類型 描述
cameraImagePoint Vec2F

傳回值

類型 描述
List<Vec3F>

getLocalPointsCloud

取得當前點雲資料位置資訊。點雲位置為世界座標系座標，每點以三個連續數值表示X、Y、Z軸座標值。

void easyar_MotionTrackerCameraDevice_getLocalPointsCloud(easyar_MotionTrackerCameraDevice * This, easyar_ListOfVec3F * * Return)
std::vector<Vec3F> getLocalPointsCloud()
public java.util.@Nonnull ArrayList<@Nonnull Vec3F> getLocalPointsCloud()
fun getLocalPointsCloud(): ArrayList<Vec3F>
- (NSArray<easyar_Vec3F *> *)getLocalPointsCloud
public func getLocalPointsCloud() -> [Vec3F]
public virtual List<Vec3F> getLocalPointsCloud()

傳回值

類型 描述
List<Vec3F>