Table of Contents

Class MotionTrackerCameraDevice

命名空間
easyar

MotionTrackerCameraDevice實現了一個真實尺度6DOF運動追蹤的camera設備，輸出 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

檢查設備是否支持Motion Tracking. 當設備支持運動追蹤功能時返回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

獲取設備上Motion Tracking的質量，結合應用場景，可以通過此值判斷是否啓動Motion Tracking。

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 緩衝的容量，如果有超過此數量的 InputFrame 從該設備中輸出並且沒有被釋放，該設備將不再輸出新的 InputFrame ，直到之前的 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

camera類型。在成功的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

camera圖像在設備的自然方向上顯示時需要順時針旋轉的角度。在成功的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,點擊到某個水平面後返回該平面上距離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>