Class SurfaceTracker

命名空間

easyar

SurfaceTracker實現了對環境表面的追蹤。 SurfaceTracker佔用1個camera的buffer。應使用camera的setBufferCapacity設置不少於所有元件佔用的camera的buffer數量。 創建之後，可以呼叫start/stop來開始和停止運行，start/stop是非常輕量的呼叫。 當不再需要該元件時，可以呼叫close對其進行關閉。close之後不應繼續使用。 SurfaceTracker通過inputFrameSink輸入 InputFrame ，應將 InputFrameSource 連接到inputFrameSink上進行使用。

SurfaceTracker

方法

isAvailable

只在Android、iOS系統上且加速度計、陀螺儀可用時返回true。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

bool easyar_SurfaceTracker_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

inputFrameSink

InputFrame 輸入端口。InputFrame要求必須擁有圖像、時間戳和camera參數。 注意：camera不支持魚眼相機模型。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_SurfaceTracker_inputFrameSink(easyar_SurfaceTracker * This, easyar_InputFrameSink * * Return)

std::shared_ptr<InputFrameSink> inputFrameSink()

public @Nonnull InputFrameSink inputFrameSink()

fun inputFrameSink(): InputFrameSink

- (easyar_InputFrameSink *)inputFrameSink

public func inputFrameSink() -> InputFrameSink

public virtual InputFrameSink inputFrameSink()

傳回值

類型	描述
InputFrameSink

bufferRequirement

當前元件佔用camera buffer的數量。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

int easyar_SurfaceTracker_bufferRequirement(easyar_SurfaceTracker * This)

int bufferRequirement()

public int bufferRequirement()

fun bufferRequirement(): Int

- (int)bufferRequirement

public func bufferRequirement() -> Int32

public virtual int bufferRequirement()

傳回值

類型	描述
Int32

outputFrameSource

OutputFrame 輸出端口。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_SurfaceTracker_outputFrameSource(easyar_SurfaceTracker * This, easyar_OutputFrameSource * * Return)

std::shared_ptr<OutputFrameSource> outputFrameSource()

public @Nonnull OutputFrameSource outputFrameSource()

fun outputFrameSource(): OutputFrameSource

- (easyar_OutputFrameSource *)outputFrameSource

public func outputFrameSource() -> OutputFrameSource

public virtual OutputFrameSource outputFrameSource()

傳回值

類型	描述
OutputFrameSource

create

創建。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_SurfaceTracker_create(easyar_SurfaceTracker * * Return)

static std::shared_ptr<SurfaceTracker> create()

public static @Nonnull SurfaceTracker create()

companion object fun create(): SurfaceTracker

+ (easyar_SurfaceTracker *)create

public static func create() -> SurfaceTracker

public static SurfaceTracker create()

傳回值

類型	描述
SurfaceTracker

start

開始追蹤算法。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

bool easyar_SurfaceTracker_start(easyar_SurfaceTracker * This)

bool start()

public boolean start()

fun start(): Boolean

- (bool)start

public func start() -> Bool

public virtual bool start()

傳回值

類型	描述
Boolean

stop

暫停追蹤算法。呼叫start來重新啟動追蹤。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_SurfaceTracker_stop(easyar_SurfaceTracker * This)

void stop()

public void stop()

fun stop(): Unit

- (void)stop

public func stop() -> Void

public virtual void stop()

傳回值

類型	描述
Void

close

關閉。close之後不應繼續使用。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_SurfaceTracker_close(easyar_SurfaceTracker * This)

void close()

public void close()

fun close(): Unit

- (void)close

public func close() -> Void

public virtual void close()

傳回值

類型	描述
Void

alignTargetToCameraImagePoint

將追蹤目標點對準到相機圖像的指定點。圖像坐標系（[0, 1]^2）的x朝右、y朝下，原點在左上角。可以使用 imageCoordinatesFromScreenCoordinates 來從屏幕坐標轉換為圖像坐標。

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_SurfaceTracker_alignTargetToCameraImagePoint(easyar_SurfaceTracker * This, easyar_Vec2F cameraImagePoint)

void alignTargetToCameraImagePoint(Vec2F cameraImagePoint)

public void alignTargetToCameraImagePoint(@Nonnull Vec2F cameraImagePoint)

fun alignTargetToCameraImagePoint(cameraImagePoint: Vec2F): Unit

- (void)alignTargetToCameraImagePoint:(easyar_Vec2F *)cameraImagePoint

public func alignTargetToCameraImagePoint(_ cameraImagePoint: Vec2F) -> Void

public virtual void alignTargetToCameraImagePoint(Vec2F cameraImagePoint)

參數

名稱	類型	描述
cameraImagePoint	Vec2F

傳回值

類型	描述
Void