WTObjectTrackerDelegate Protocol Reference
Conforms to | NSObject |
---|---|
Declared in | WTObjectTrackerDelegate.h |
Overview
@Brief WTOjectTrackerDelegate provides methods that propagate information about tracker state changes.
Tracker objects are not created by calling their init method, but through the provided factory methods of WTTrackerManager.
Matrix pointer that are provided inside the WTObjectTarget 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.
– objectTracker:didRecognizeObject:
required method
@Brief Called whenever a tracker recognizes a new object target that was previously unknown.
- (void)objectTracker:(WTObjectTracker *)objectTracker didRecognizeObject:(WTObjectTarget *)recognizedObject
Parameters
objectTracker |
The tracker object that recognized the new object target |
---|---|
recognizedObject |
The object target that was recognised. |
Discussion
@Brief Called whenever a tracker recognizes a new object target that was previously unknown.
All WTObjectTarget matrix pointer are set to nullptr and should not be used.
Declared In
WTObjectTrackerDelegate.h
– objectTracker:didTrackObject:
required method
Called whenever a previously known object target was tracked again.
- (void)objectTracker:(WTObjectTracker *)objectTracker didTrackObject:(WTObjectTarget *)trackedObject
Parameters
objectTracker |
The tracker object that tracked the object target |
---|---|
trackedObject |
The object target tat was tracked again |
Declared In
WTObjectTrackerDelegate.h
– objectTracker:didLoseObject:
required method
Called whenever a previously know object target is not found anymore in the current camera frame.
- (void)objectTracker:(WTObjectTracker *)objectTracker didLoseObject:(WTObjectTarget *)lostObject
Parameters
objectTracker |
The tracker object that lost the object target. |
---|---|
lostObject |
The object target that was lost |
Discussion
All WTObjectTarget matrix pointer are set to nullptr and should not be used.
Declared In
WTObjectTrackerDelegate.h
– objectTrackerDidLoadTargets:
Called when an object tracker was successfully initialized.
- (void)objectTrackerDidLoadTargets:(WTObjectTracker *)objectTracker
Parameters
objectTracker |
The object tracker that was initialized |
---|
Declared In
WTObjectTrackerDelegate.h
– objectTracker:didFailToLoadTargets:
Called whenever an object tracker could not be initialized.
- (void)objectTracker:(WTObjectTracker *)objectTracker didFailToLoadTargets:(NSError *)error
Parameters
objectTracker |
The object tracker that could not be initialized |
---|---|
error |
A NSError object that contains more information about why the object tracker could not be initialized |
Declared In
WTObjectTrackerDelegate.h
– objectTracker: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)objectTracker:(WTObjectTracker *)objectTracker didUpdateExtendedTrackingQualityForTarget:(NSString *)extendedTarget fromQuality:(WTExtendedTrackingQuality)oldTrackingQuality toQuality:(WTExtendedTrackingQuality)newTrackingQuality
Parameters
objectTracker |
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
WTObjectTrackerDelegate.h