ImageTarget Class

这个类型是C#语言的 EasyAR Sense API: ImageTarget 。页面中部分描述可能与Unity环境无关。

这个类型已经部分封装进Unity组件: ImageTargetController 。在大部分情况下不需要直接使用这个类型的成员和实例。如果要使用一些没有被封装的接口,需要使用 ImageTargetController.Target ,而非创建新的实例。

Description

ImageTarget表示平面图像的target,它可以被 ImageTracker 所跟踪。

ImageTarget内的数值在可以被读取之前需要首先通过create...等方法填入。然后再通过 ImageTracker.loadTarget 成功载入 ImageTracker 之后可以被 ImageTracker 检测和跟踪。


Methods

createFromParameters

C#

public static Optional<ImageTarget> createFromParameters( ImageTargetParameters parameters)

从参数创建。

createFromTargetFile

C#

public static Optional<ImageTarget> createFromTargetFile(string path, StorageType storageType)

从etd文件创建。

createFromTargetData

C#

public static Optional<ImageTarget> createFromTargetData( Buffer buffer)

从etd数据缓存创建。

save

C#

public virtual bool save(string path)

保存为etd文件。

createFromImageFile

C#

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

从图像创建。如果不需要,name、uid、meta可以传空字符串,scale可以传默认值1。支持jpeg或png文件。

scale

C#

public virtual float scale()

图像的缩放比例。其值为图像宽度的物理大小与1米的比值,默认值为1。

aspectRatio

C#

public virtual float aspectRatio()

图像的宽高比。

setScale

C#

public virtual bool setScale(float scale)

设置图像的缩放比例,设置之后会覆盖默认值以及在json文件中设的数值。其值为图像宽度的物理大小与1米的比值,默认值为1。

还需要在渲染引擎中单独设置此模型缩放。

images

C#

public virtual List< Image > images()

获取target中存储的图像列表。通常这个方法用来获取云端返回的target的识别图数据。

runtimeID

C#

public override int runtimeID()

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

uid

C#

public override string uid()

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

name

C#

public override string name()

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

setName

C#

public override void setName(string name)

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

meta

C#

public override string meta()

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

setMeta

C#

public override void setMeta(string data)

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