Wikitude ARchitect v3.2 API Documentation

A Trackable2DObject represents a virtual object bound to a specific target in a target collection. The target will be tracked in the camera scene, and Drawables will be projected onto the target as soon as it becomes visible and is detected in the scene. Any Trackable2DObject is linked to one target in a specific target collection.

A Trackable2DObject

• is associated with one Tracker and a specific target inside the Tracker.
• can have Drawables associated with it. These Drawables will represent the Trackable2DObject in the camera view.
• can have triggers associated with it. Triggers fire on certain events and execute functions to react on these actions.

On creation, a reference to the Tracker, as well as the name of the target in the Tracker must be passed.

A Trackable2DObject can either be enabled or disabled (see ARObject.enabled). Enabled means that the Trackable2DObject will be considered in the tracking of objects in the camera, and its triggers will fire on the appropriate events. In case the Trackable2DObject is disabled, it will not be considered in the tracking process, and it will not fire any triggers. Note that the associated Tracker must also be enabled for the Trackable2DObject to be considered for tracking.

On creation, setup parameters can be passed to customize the properties of the Trackable2DObject.

// a circle used for representation
var circle = new AR.Circle(5);
// the referenced tracker
var tracker = new AR.Tracker("http://myserver.com/targetCollection1.wtc");
// a Trackable2DObject using the "car" target in the tracker, using the circle as the digital representation.
var trackable2DObject = new AR.Trackable2DObject(tracker, "car", {
drawables : {
cam : circle
}
});

For the render size of attached Drawables, see the chapter on SDUs.