Class ObjectTarget

命名空间

easyar

ObjectTarget表示3D object target，它可以被 ObjectTracker 所跟踪。 ObjectTarget的大小由 obj 文件决定。可以通过修改 scale 达到修改size的目的。 scale 默认为1。 ObjectTarget通过 loadTarget 成功载入 ObjectTracker 之后可以被 ObjectTracker 检测和跟踪。

继承

Target

ObjectTarget

构造函数

ObjectTarget

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

void easyar_ObjectTarget__ctor(easyar_ObjectTarget * * Return)

ObjectTarget()

public ObjectTarget()

constructor()

+ (easyar_ObjectTarget *) create

public convenience init()

public ObjectTarget()

方法

createFromParameters

从参数创建。

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

void easyar_ObjectTarget_createFromParameters(easyar_ObjectTargetParameters * parameters, easyar_OptionalOfObjectTarget * Return)

static std::optional<std::shared_ptr<ObjectTarget>> createFromParameters(std::shared_ptr<ObjectTargetParameters> parameters)

public static @Nullable ObjectTarget createFromParameters(@Nonnull ObjectTargetParameters parameters)

companion object fun createFromParameters(parameters: ObjectTargetParameters): ObjectTarget?

+ (easyar_ObjectTarget *)createFromParameters:(easyar_ObjectTargetParameters *)parameters

public static func createFromParameters(_ parameters: ObjectTargetParameters) -> ObjectTarget?

public static Optional<ObjectTarget> createFromParameters(ObjectTargetParameters parameters)

参数

名称	类型	描述
parameters	ObjectTargetParameters

返回

类型	描述
Optional<ObjectTarget>

createFromObjectFile

从obj, mtl和jpg/png文件创建。

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

void easyar_ObjectTarget_createFromObjectFile(easyar_String * path, easyar_StorageType storageType, easyar_String * name, easyar_String * uid, easyar_String * meta, float scale, easyar_OptionalOfObjectTarget * Return)

static std::optional<std::shared_ptr<ObjectTarget>> createFromObjectFile(std::string path, StorageType storageType, std::string name, std::string uid, std::string meta, float scale)

public static @Nullable ObjectTarget createFromObjectFile(java.lang.@Nonnull String path, int storageType, java.lang.@Nonnull String name, java.lang.@Nonnull String uid, java.lang.@Nonnull String meta, float scale)

companion object fun createFromObjectFile(path: String, storageType: Int, name: String, uid: String, meta: String, scale: Float): ObjectTarget?

+ (easyar_ObjectTarget *)createFromObjectFile:(NSString *)path storageType:(easyar_StorageType)storageType name:(NSString *)name uid:(NSString *)uid meta:(NSString *)meta scale:(float)scale

public static func createFromObjectFile(_ path: String, _ storageType: StorageType, _ name: String, _ uid: String, _ meta: String, _ scale: Float) -> ObjectTarget?

public static Optional<ObjectTarget> createFromObjectFile(string path, StorageType storageType, string name, string uid, string meta, float scale)

参数

名称	类型	描述
path	String
storageType	StorageType
name	String
uid	String
meta	String
scale	Single

返回

类型	描述
Optional<ObjectTarget>

scale

模型的缩放比例。其值为模型在空间中的物理大小与在模型坐标系中的大小的比值，默认值为1。（假设模型坐标系中的标尺单位为米）

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

float easyar_ObjectTarget_scale(const easyar_ObjectTarget * This)

float scale()

public float scale()

fun scale(): Float

- (float)scale

public func scale() -> Float

public virtual float scale()

返回

类型	描述
Single

boundingBox

物体的包围盒，包括盒子的8个顶点。 顶点索引定义如下：

  4-----7
 /|    /|
5-----6 |    z
| |   | |    |
| 0---|-3    o---y
|/    |/    /
1-----2    x

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

void easyar_ObjectTarget_boundingBox(easyar_ObjectTarget * This, easyar_ListOfVec3F * * Return)

std::vector<Vec3F> boundingBox()

public java.util.@Nonnull ArrayList<@Nonnull Vec3F> boundingBox()

fun boundingBox(): ArrayList<Vec3F>

- (NSArray<easyar_Vec3F *> *)boundingBox

public func boundingBox() -> [Vec3F]

public virtual List<Vec3F> boundingBox()

返回

类型	描述
List<Vec3F>

setScale

设置模型的缩放比例。设置之后会覆盖默认值以及在json文件中设的数值。其值为模型在空间中的物理大小与在模型坐标系中的大小的比值，默认值为1。（假设模型坐标系中的标尺单位为米） 还需要在渲染引擎中单独设置此模型缩放。 注意该设置需要在通过 loadTarget 载入 ObjectTracker 之前进行。

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

bool easyar_ObjectTarget_setScale(easyar_ObjectTarget * This, float scale)

bool setScale(float scale)

public boolean setScale(float scale)

fun setScale(scale: Float): Boolean

- (bool)setScale:(float)scale

public func setScale(_ scale: Float) -> Bool

public virtual bool setScale(float scale)

参数

名称	类型	描述
scale	Single

返回

类型	描述
Boolean

runtimeID

获取target id。target id是运行时创建的整型数据，只有在成功的配置之后才是有效（非0）的。这个id是非0且全局递增的。

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

int easyar_ObjectTarget_runtimeID(const easyar_ObjectTarget * This)

int runtimeID()

public int runtimeID()

fun runtimeID(): Int

- (int)runtimeID

public override func runtimeID() -> Int32

public override int runtimeID()

返回

类型	描述
Int32

uid

获取target uid。ImageTarget的uid在云识别算法中使用。在没有接入云识别的时候，你可以在json配置中设置这个uid，在自己的代码中作为另一种区分target的方法。

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

void easyar_ObjectTarget_uid(const easyar_ObjectTarget * This, easyar_String * * Return)

std::string uid()

public java.lang.@Nonnull String uid()

fun uid(): String

- (NSString *)uid

public override func uid() -> String

public override string uid()

返回

类型	描述
String

name

获取target名字。名字用来在json文件中区分target。

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

void easyar_ObjectTarget_name(const easyar_ObjectTarget * This, easyar_String * * Return)

std::string name()

public java.lang.@Nonnull String name()

fun name(): String

- (NSString *)name

public override func name() -> String

public override string name()

返回

类型	描述
String

setName

设置target名字。这个操作会覆盖上一次的设置或是服务器返回的数据。

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

void easyar_ObjectTarget_setName(easyar_ObjectTarget * This, easyar_String * name)

void setName(std::string name)

public void setName(java.lang.@Nonnull String name)

fun setName(name: String): Unit

- (void)setName:(NSString *)name

public override func setName(_ name: String) -> Void

public override void setName(string name)

参数

名称	类型	描述
name	String

返回

类型	描述
Void

meta

获取setMetaData所设置的meta data。或者在云识别返回的target中，获得服务器所设置的meta data。

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

void easyar_ObjectTarget_meta(const easyar_ObjectTarget * This, easyar_String * * Return)

std::string meta()

public java.lang.@Nonnull String meta()

fun meta(): String

- (NSString *)meta

public override func meta() -> String

public override string meta()

返回

类型	描述
String

setMeta

设置meta data。这个操作会覆盖上一次的设置或是服务器返回的数据。

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

void easyar_ObjectTarget_setMeta(easyar_ObjectTarget * This, easyar_String * data)

void setMeta(std::string data)

public void setMeta(java.lang.@Nonnull String data)

fun setMeta(data: String): Unit

- (void)setMeta:(NSString *)data

public override func setMeta(_ data: String) -> Void

public override void setMeta(string data)

参数

名称	类型	描述
data	String

返回

类型	描述
Void