ImageTarget Class

Inherits: Base

Description

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

ImageTarget的大小可以在json文件里设置或通过SetupWithImage/SetupWithJsonFile/SetupWithJsonString/SetupWithTarget方法的参数设置,或者如果没有在接口中提供,将会从图像分辨率计算。

ImageTarget 可以通过显式调用 ImageTrackerBaseBehaviour.LoadImageTargetBehaviour 或 通过 ImageTargetBaseBehaviour.Bind 隐式加载到 ImageTrackerBaseBehaviour 中。在成功加载后可以被 ImageTrackerBaseBehaviour 跟踪。在加载之后, ImageTrackerBaseBehaviour.TargetLoadImageTargetBaseBehaviour.TargetLoad 事件将会被触发。

Public Properties

int Id
string MetaData
string Name
string Uid
List<Image> Images
Vector2 Size
Target Target

Public Functions

static ImageTarget FromTarget(Target target)

int Id

返回target id。target id是运行时创建的整形数据,只有在成功的加载之后才是有效(非0)的。

string Uid

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

string Name

返回target名字。名字用来在json文件中区分target。

string MetaData

meta data。在云识别返回的target里面,返回云端服务器所设置的meta data。

set操作将会按字符串的形式复制数据。这个操作会覆盖上一次的设置或是云端返回的数据。

List<Image> Images

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

Vector2 Size

ImageTarget的大小。这个大小只有在显式调用 ImageTrackerBaseBehaviour.LoadImageTargetBehaviour 或 通过 ImageTargetBaseBehaviour.Bind 隐式加载到 ImageTrackerBaseBehaviour 中,或是通过这个属性手动设置之后才是有效(非0)的。在加载之后, ImageTrackerBaseBehaviour.TargetLoadImageTargetBaseBehaviour.TargetLoad 事件将会被触发。

如果size没有set过,将会返回通过图像分辨率进行计算得出的默认大小。

设置size之后会覆盖默认值以及在json文件中设的数值。

size将会在成功加载之后通过图像分辨率重新计算。在计算之后,size的最大值将被保持不变,仍为最大值,另一个维度则通过分辨率计算更新。需要在target成功加载之 后获取实际使用的size数值。可以在 ImageTrackerBaseBehaviour.TargetLoadImageTargetBaseBehaviour.TargetLoad 的事件处理器中获取数值。

如果size长宽比例在设置的时候就保证和图像分辨率一致,则在计算之后size不会发生变化。

Target Target

转换成Target。

static ImageTarget FromTarget(Target target)

从Target转换到ImageTarget.