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