WTInstantTrackerDelegate Protocol Reference

Conforms to NSObject
Declared in WTInstantTrackerDelegate.h

Overview

Matrix pointer that are provided inside the WTInstantTarget objects are only valid in the current method scope. If they are needed at a later point in time, they have to be copied into different memory that is controlled by the Wikitude Native SDK hosting application.

– instantTracker:didChangeInitializationPose: required method

Called whenever an initialization update is being sent by the instant tracker. The tracking data can be used to draw gravity a aligned plane or other augmentations while the tracker is in the initialization state.

- (void)instantTracker:(WTInstantTracker *)instantTracker didChangeInitializationPose:(WTInitializationPose *)pose

Parameters

instantTracker

The tracker object that sent the initialization update.
pose

Information about the gravity aligned plane

Declared In

WTInstantTrackerDelegate.h

– instantTracker:didTrack: required method

Called whenever the current scene is being tracked again.

- (void)instantTracker:(WTInstantTracker *)instantTracker didTrack:(WTInstantTarget *)instantTarget

Parameters

instantTracker

The tracker object that tracked scene
instantTarget

Information about the scene being tracked

Declared In

WTInstantTrackerDelegate.h

– instantTrackerDidStopTracking: required method

Called whenever the current scene is lost

- (void)instantTrackerDidStopTracking:(WTInstantTracker *)instantTracker

Parameters

instantTracker

The tracker object that lost the scene.

Discussion

All WTInstantTarget matrix pointer are set to nullptr and should not be used.

Declared In

WTInstantTrackerDelegate.h

– instantTracker:didStartTracking:

Called whenever a tracker starts tracking the scene for the first time or after it was lost.

- (void)instantTracker:(WTInstantTracker *)instantTracker didStartTracking:(WTInstantTarget *)instantTarget

Parameters

instantTracker

The tracker object that recognized the scene
instantTarget

Information about the scene being tracked

Declared In

WTInstantTrackerDelegate.h

– instantTrackerDidStartTracking:

Called whenever a tracker starts tracking the scene for the first time or after it was lost.

- (void)instantTrackerDidStartTracking:(WTInstantTracker *)instantTracker

Parameters

instantTracker

The tracker object that recognized the scene

Declared In

WTInstantTrackerDelegate.h

– instantTracker:didChangeState:

Called whenever a tracker changes its state internally as a result of calling setActiveInstantTrackingState: on it.

- (void)instantTracker:(WTInstantTracker *)instantTracker didChangeState:(WTInstantTrackingState)newState

Parameters

instantTracker

The tracker object whose state changed
newState

The new state of the tracker

Declared In

WTInstantTrackerDelegate.h

– instantTracker:didFailStateChange:withError:

Called whenever a state change operation of the instant tracker fails.

- (void)instantTracker:(WTInstantTracker *)instantTracker didFailStateChange:(WTInstantTrackingState)failedState withError:(NSError *)error

Parameters

instantTracker

The tracker object that failed to perform the state change.
failedState

The state that could not be changed to.
error

The error object corresponding to the failure reason.

Declared In

WTInstantTrackerDelegate.h

– instantTracker:didFailStateChange:

Called whenever a state change operation of the instant tracker fails.

- (void)instantTracker:(WTInstantTracker *)instantTracker didFailStateChange:(WTInstantTrackingState)failedState

Parameters

instantTracker

The tracker object that failed to perform the state change.
failedState

The state that could not be changed to.

Declared In

WTInstantTrackerDelegate.h

– instantTracker:didRecognizePlane:

Called whenever a plane is recognized.

- (void)instantTracker:(WTInstantTracker *)instantTracker didRecognizePlane:(WTPlane *)plane

Parameters

instantTracker

The tracker object that recognized the plane.
plane

The plane object recognized.

Declared In

WTInstantTrackerDelegate.h

– instantTracker:didTrackPlane:

Called whenever a plane is tracked.

- (void)instantTracker:(WTInstantTracker *)instantTracker didTrackPlane:(WTPlane *)plane

Parameters

instantTracker

The tracker object that tracked the plane.
plane

The plane object tracked.

Declared In

WTInstantTrackerDelegate.h

– instantTracker:didLosePlane:

Called whenever a plane is lost.

- (void)instantTracker:(WTInstantTracker *)instantTracker didLosePlane:(WTPlane *)plane

Parameters

instantTracker

The tracker object that lost the plane.
plane

The plane object lost.

Declared In

WTInstantTrackerDelegate.h

– instantTracker:didFailWithError:

Called whenever an operation of the instant tracker fails. An error code as well as a message that indicate the failure reason are supplied.

- (void)instantTracker:(WTInstantTracker *)instantTracker didFailWithError:(NSError *)error

Parameters

instantTracker

The tracker object that failed to perform the operation.
error

The error object corresponding to the failure reason.

Declared In

WTInstantTrackerDelegate.h