WTBaseTrackerDelegate Protocol Reference

Conforms to NSObject
Declared in WTBaseTracker.h

Overview

@Brief WTBaseTrackerDelegate provides methods that propagate information about tracker state changes.

Tracker objects are not created by calling there init method, but through the provided factory methods of WTTrackerManager.

Matrix pointer that are provided inside the WTImageTarget 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.

– baseTracker:didRecognizedTarget:NS_SWIFT_NAME: required method

@Brief Called whenever a tracker recognizes a new image target that was previously unknown.

- (void)baseTracker:(nonnull WTBaseTracker *)baseTracker didRecognizedTarget:(nonnull WTImageTarget *)recognizedTarget NS_SWIFT_NAME

Parameters

baseTracker

The tracker object that recognized the new image target

recognizedTarget

The image target that was recognised.

Discussion

@Brief Called whenever a tracker recognizes a new image target that was previously unknown.

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

Declared In

WTBaseTracker.h

– baseTracker:didTrackTarget: required method

Called whenever a previously known image target was tracked again.

- (void)baseTracker:(nonnull WTBaseTracker *)baseTracker didTrackTarget:(nonnull WTImageTarget *)trackedTarget

Parameters

baseTracker

The tracker object that tracked the image target

trackedTarget

The image target tat was tracked again

Declared In

WTBaseTracker.h

– baseTracker:didLostTarget:NS_SWIFT_NAME: required method

Called whenever a previously know image target is not found anymore in the current camera frame.

- (void)baseTracker:(nonnull WTBaseTracker *)baseTracker didLostTarget:(nonnull WTImageTarget *)lostTarget NS_SWIFT_NAME

Parameters

baseTracker

The tracker object that lost the image target.

lostTarget

The image target that was lost

Discussion

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

Declared In

WTBaseTracker.h

– baseTracker:didUpdateExtendedTrackingQualityForTarget:fromQuality:toQuality:

Called whenever a tracker is marked to be extended and the extended tracking quality changes.

During a tracking session, the extended tracking quality might get better or worse, depending on the scene that is captured.

- (void)baseTracker:(nonnull WTBaseTracker *)baseTracker didUpdateExtendedTrackingQualityForTarget:(NSString *)extendedTarget fromQuality:(WTExtendedTrackingQuality)oldTrackingQuality toQuality:(WTExtendedTrackingQuality)newTrackingQuality

Parameters

baseTracker

The tracker object that changed the extended tracking quality

extendedTarget

The name of the image target that changed the extended tracking quality

oldTrackingQuality

The previously extended tracking quality

newTrackingQuality

The extended tracking quality that is now reached

Discussion

This method is also called when extended tracking processed the first frame, meaning that oldTrackingQuality is then set to a non WTExtendedTrackingQuality value.

Declared In

WTBaseTracker.h