Class SparseSpatialMap

命名空間: easyar

提供SparseSpatialMap系統主要功能，包含地圖生成與儲存、地圖載入與定位，同時可獲取點雲、平面等環境資訊並進行hit Test。 SparseSpatialMap佔用2個camera的buffer。應使用camera的setBufferCapacity設定不少於所有元件佔用的camera buffer數量。

SparseSpatialMap

方法

isAvailable

檢查SparseSpatialMap是否可用。總是回傳true。

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

輸入影格輸入埠。SparseSpatialMap輸入影格必須包含camera參數、時間戳記資訊和空間資訊（cameraTransform與trackingStatus）。參考 InputFrameSink。注意：camera支援針孔與魚眼相機模型，使用魚眼相機效能會受影響。

void easyar_SparseSpatialMap_inputFrameSink(easyar_SparseSpatialMap * 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數量。

int easyar_SparseSpatialMap_bufferRequirement(easyar_SparseSpatialMap * This)

int bufferRequirement()

public int bufferRequirement()

fun bufferRequirement(): Int

- (int)bufferRequirement

public func bufferRequirement() -> Int32

public virtual int bufferRequirement()

傳回值

類型	描述
Int32

outputFrameSource

輸出影格輸出埠。參考 OutputFrameSource。

void easyar_SparseSpatialMap_outputFrameSource(easyar_SparseSpatialMap * 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

建構SparseSpatialMap。

void easyar_SparseSpatialMap_create(easyar_SparseSpatialMap * * Return)

static std::shared_ptr<SparseSpatialMap> create()

public static @Nonnull SparseSpatialMap create()

companion object fun create(): SparseSpatialMap

+ (easyar_SparseSpatialMap *)create

public static func create() -> SparseSpatialMap

public static SparseSpatialMap create()

傳回值

類型	描述
SparseSpatialMap

setResultPoseType

設定結果姿態類型。預設enableStabilization為false。僅在 InputFrame 包含空間資訊時有效。

void easyar_SparseSpatialMap_setResultPoseType(easyar_SparseSpatialMap * This, bool enableStabilization)

void setResultPoseType(bool enableStabilization)

public void setResultPoseType(boolean enableStabilization)

fun setResultPoseType(enableStabilization: Boolean): Unit

- (void)setResultPoseType:(bool)enableStabilization

public func setResultPoseType(_ enableStabilization: Bool) -> Void

public virtual void setResultPoseType(bool enableStabilization)

參數

名稱	類型	描述
enableStabilization	Boolean

傳回值

類型	描述
Void

setResultAsyncMode

設定結果非同步模式。若結果透過outputFrameSource輸出，應設為true；若透過getSyncResult獲取結果，應設為false。預設enableAsync為true。同步模式僅在輸入影格包含空間資訊且使用XR授權時生效。

bool easyar_SparseSpatialMap_setResultAsyncMode(easyar_SparseSpatialMap * This, bool enableAsync)

bool setResultAsyncMode(bool enableAsync)

public boolean setResultAsyncMode(boolean enableAsync)

fun setResultAsyncMode(enableAsync: Boolean): Boolean

- (bool)setResultAsyncMode:(bool)enableAsync

public func setResultAsyncMode(_ enableAsync: Bool) -> Bool

public virtual bool setResultAsyncMode(bool enableAsync)

參數

名稱	類型	描述
enableAsync	Boolean

傳回值

類型	描述
Boolean

start

啟動SparseSpatialMap演算法。

bool easyar_SparseSpatialMap_start(easyar_SparseSpatialMap * This)

bool start()

public boolean start()

fun start(): Boolean

- (bool)start

public func start() -> Bool

public virtual bool start()

傳回值

類型	描述
Boolean

stop

停止SparseSpatialMap演算法。呼叫start可重新執行。

void easyar_SparseSpatialMap_stop(easyar_SparseSpatialMap * This)

void stop()

public void stop()

fun stop(): Unit

- (void)stop

public func stop() -> Void

public virtual void stop()

傳回值

類型	描述
Void

close

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

void easyar_SparseSpatialMap_close(easyar_SparseSpatialMap * This)

void close()

public void close()

fun close(): Unit

- (void)close

public func close() -> Void

public virtual void close()

傳回值

類型	描述
Void

getPointCloudBuffer

取得當前點雲資料位置資訊。點雲位置為世界座標系中的位置，buffer中每個點由三個連續值表示（分別為X、Y、Z軸座標），每個值佔用4位元組。

void easyar_SparseSpatialMap_getPointCloudBuffer(easyar_SparseSpatialMap * This, easyar_Buffer * * Return)

std::shared_ptr<Buffer> getPointCloudBuffer()

public @Nonnull Buffer getPointCloudBuffer()

fun getPointCloudBuffer(): Buffer

- (easyar_Buffer *)getPointCloudBuffer

public func getPointCloudBuffer() -> Buffer

public virtual Buffer getPointCloudBuffer()

傳回值

類型	描述
Buffer

getMapPlanes

取得偵測到的平面，類型為 PlaneType。

void easyar_SparseSpatialMap_getMapPlanes(easyar_SparseSpatialMap * This, easyar_ListOfPlaneData * * Return)

std::vector<std::shared_ptr<PlaneData>> getMapPlanes()

public java.util.@Nonnull ArrayList<@Nonnull PlaneData> getMapPlanes()

fun getMapPlanes(): ArrayList<PlaneData>

- (NSArray<easyar_PlaneData *> *)getMapPlanes

public func getMapPlanes() -> [PlaneData]

public virtual List<PlaneData> getMapPlanes()

傳回值

類型	描述
List<PlaneData>

hitTestAgainstPointCloud

在當前點雲中進行Hit Test，取得距離相機由近至遠一條射線上n個(n>=0)位置座標。

void easyar_SparseSpatialMap_hitTestAgainstPointCloud(easyar_SparseSpatialMap * 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>

hitTestAgainstPlanes

在當前偵測平面上進行Hit Test，取得距離相機由近至遠一條射線上n個(n>=0)位置座標。輸入影像座標系([0,1]^2)的x朝右、y朝下，原點在左上角。可使用 imageCoordinatesFromScreenCoordinates 轉換螢幕座標至影像座標。輸出為點雲在世界座標系中的座標。

void easyar_SparseSpatialMap_hitTestAgainstPlanes(easyar_SparseSpatialMap * This, easyar_Vec2F cameraImagePoint, easyar_ListOfVec3F * * Return)

std::vector<Vec3F> hitTestAgainstPlanes(Vec2F cameraImagePoint)

public java.util.@Nonnull ArrayList<@Nonnull Vec3F> hitTestAgainstPlanes(@Nonnull Vec2F cameraImagePoint)

fun hitTestAgainstPlanes(cameraImagePoint: Vec2F): ArrayList<Vec3F>

- (NSArray<easyar_Vec3F *> *)hitTestAgainstPlanes:(easyar_Vec2F *)cameraImagePoint

public func hitTestAgainstPlanes(_ cameraImagePoint: Vec2F) -> [Vec3F]

public virtual List<Vec3F> hitTestAgainstPlanes(Vec2F cameraImagePoint)

參數

名稱	類型	描述
cameraImagePoint	Vec2F

傳回值

類型	描述
List<Vec3F>

getMapVersion

取得當前SparseSpatialMap的地圖版本。

void easyar_SparseSpatialMap_getMapVersion(easyar_String * * Return)

static std::string getMapVersion()

public static java.lang.@Nonnull String getMapVersion()

companion object fun getMapVersion(): String

+ (NSString *)getMapVersion

public static func getMapVersion() -> String

public static string getMapVersion()

傳回值

類型	描述
String

unloadMap

透過回呼卸載指定SparseSpatialMap地圖資料。可透過回傳值判斷卸載是否成功(成功回傳true，否則回傳false)。

void easyar_SparseSpatialMap_unloadMap(easyar_SparseSpatialMap * This, easyar_String * mapID, easyar_CallbackScheduler * callbackScheduler, easyar_OptionalOfFunctorOfVoidFromBool resultCallBack)

void unloadMap(std::string mapID, std::shared_ptr<CallbackScheduler> callbackScheduler, std::optional<std::function<void(bool)>> resultCallBack)

public void unloadMap(java.lang.@Nonnull String mapID, @Nonnull CallbackScheduler callbackScheduler, @Nullable FunctorOfVoidFromBool resultCallBack)

fun unloadMap(mapID: String, callbackScheduler: CallbackScheduler, resultCallBack: FunctorOfVoidFromBool?): Unit

- (void)unloadMap:(NSString *)mapID callbackScheduler:(easyar_CallbackScheduler *)callbackScheduler resultCallBack:(void (^)(bool))resultCallBack

public func unloadMap(_ mapID: String, _ callbackScheduler: CallbackScheduler, _ resultCallBack: ((Bool) -> Void)?) -> Void

public virtual void unloadMap(string mapID, CallbackScheduler callbackScheduler, Optional<Action<bool>> resultCallBack)

參數

名稱	類型	描述
mapID	String
callbackScheduler	CallbackScheduler
resultCallBack	Optional<Action<>>

傳回值

類型	描述
Void

setConfig

設定SparseSpatialMap相關組態。參考 SparseSpatialMapConfig。

void easyar_SparseSpatialMap_setConfig(easyar_SparseSpatialMap * This, easyar_SparseSpatialMapConfig * config)

void setConfig(std::shared_ptr<SparseSpatialMapConfig> config)

public void setConfig(@Nonnull SparseSpatialMapConfig config)

fun setConfig(config: SparseSpatialMapConfig): Unit

- (void)setConfig:(easyar_SparseSpatialMapConfig *)config

public func setConfig(_ config: SparseSpatialMapConfig) -> Void

public virtual void setConfig(SparseSpatialMapConfig config)

參數

名稱	類型	描述
config	SparseSpatialMapConfig

傳回值

類型	描述
Void

getConfig

取得SparseSpatialMap相關組態。參考 SparseSpatialMapConfig。

void easyar_SparseSpatialMap_getConfig(easyar_SparseSpatialMap * This, easyar_SparseSpatialMapConfig * * Return)

std::shared_ptr<SparseSpatialMapConfig> getConfig()

public @Nonnull SparseSpatialMapConfig getConfig()

fun getConfig(): SparseSpatialMapConfig

- (easyar_SparseSpatialMapConfig *)getConfig

public func getConfig() -> SparseSpatialMapConfig

public virtual SparseSpatialMapConfig getConfig()

傳回值

類型	描述
SparseSpatialMapConfig

startLocalization

開始在已載入地圖中嘗試定位。需先設定所需組態參數。參考 LocalizationMode。

bool easyar_SparseSpatialMap_startLocalization(easyar_SparseSpatialMap * This)

bool startLocalization()

public boolean startLocalization()

fun startLocalization(): Boolean

- (bool)startLocalization

public func startLocalization() -> Bool

public virtual bool startLocalization()

傳回值

類型	描述
Boolean

stopLocalization

停止當前定位程序。

void easyar_SparseSpatialMap_stopLocalization(easyar_SparseSpatialMap * This)

void stopLocalization()

public void stopLocalization()

fun stopLocalization(): Unit

- (void)stopLocalization

public func stopLocalization() -> Void

public virtual void stopLocalization()

傳回值

類型	描述
Void

getSyncResult

取得同步輸出結果。若SparseSpatialMap已暫停，或未透過setResultAsyncMode將結果模式設為false，則回傳值為空。

void easyar_SparseSpatialMap_getSyncResult(easyar_SparseSpatialMap * This, easyar_MotionInputData * motionInputData, easyar_OptionalOfSparseSpatialMapResult * Return)

std::optional<std::shared_ptr<SparseSpatialMapResult>> getSyncResult(std::shared_ptr<MotionInputData> motionInputData)

public @Nullable SparseSpatialMapResult getSyncResult(@Nonnull MotionInputData motionInputData)

fun getSyncResult(motionInputData: MotionInputData): SparseSpatialMapResult?

- (easyar_SparseSpatialMapResult *)getSyncResult:(easyar_MotionInputData *)motionInputData

public func getSyncResult(_ motionInputData: MotionInputData) -> SparseSpatialMapResult?

public virtual Optional<SparseSpatialMapResult> getSyncResult(MotionInputData motionInputData)

參數

名稱	類型	描述
motionInputData	MotionInputData

傳回值

類型	描述
Optional<SparseSpatialMapResult>

Table of Contents