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。这个操作会覆盖上一次的设置或是服务器返回的数据。