public final class ImageTrackerConfiguration extends Object
Modifier and Type | Class and Description |
---|---|
static class |
ImageTrackerConfiguration.ImageRecognitionRangeExtension
ImageRecognitionRangeExtension defines if ImageTracker should use an optimized algorithm to detect target images in greater distance to the camera.
Extending the recognition range requires HD camera frames processing and therefore needs more CPU power than the default recognition range. Extending the recognition distance requires more computational power of the CPU. |
Constructor and Description |
---|
ImageTrackerConfiguration() |
Modifier and Type | Method and Description |
---|---|
int |
getDistanceChangedThreshold()
Returns the threshold the distance between targets has to exceed in order for
ImageTarget.OnDistanceBetweenTargetsListener.onDistanceBetweenTargetsChanged(int, com.wikitude.tracker.ImageTarget, com.wikitude.tracker.ImageTarget) to be triggered. |
String[] |
getExtendedTargets() |
ImageTrackerConfiguration.ImageRecognitionRangeExtension |
getImageRecognitionRangeExtension()
Returns the
ImageTrackerConfiguration.ImageRecognitionRangeExtension that should be used when target image recognition is active. |
int |
getMaximumNumberOfConcurrentlyTrackableTargets()
Returns the maximum number of targets that can be tracked concurrently.
|
HashMap<String,Integer> |
getPhysicalTargetImageHeights()
Returns a map of target names and their physical image height in mm.
|
TrackerEfficiencyMode |
getTrackerEfficiencyMode()
Returns the efficiency mode of the tracker.
|
void |
setDistanceChangedThreshold(int distanceChangedThreshold)
Sets the threshold the distance between targets has to exceed in order for
ImageTarget.OnDistanceBetweenTargetsListener.onDistanceBetweenTargetsChanged(int, com.wikitude.tracker.ImageTarget, com.wikitude.tracker.ImageTarget) to be triggered. |
void |
setExtendedTargets(String[] extendedTargets) |
void |
setImageRecognitionRangeExtension(ImageTrackerConfiguration.ImageRecognitionRangeExtension imageRecognitionRangeExtension)
Sets the
ImageTrackerConfiguration.ImageRecognitionRangeExtension that should be used when target image recognition is active. |
void |
setMaximumNumberOfConcurrentlyTrackableTargets(int maximumNumberOfConcurrentlyTrackableTargets)
Sets the maximum number of targets that can be tracked concurrently.
|
void |
setPhysicalTargetImageHeights(HashMap<String,Integer> physicalTargetImageHeights)
Sets a map of target names and their physical image height in mm.
|
void |
setTrackerEfficiencyMode(TrackerEfficiencyMode trackerEfficiencyMode)
Use this to specify the efficiency mode of the tracker.
|
public String[] getExtendedTargets()
public void setExtendedTargets(String[] extendedTargets)
extendedTargets
- The targets that should run in extended tracking modepublic ImageTrackerConfiguration.ImageRecognitionRangeExtension getImageRecognitionRangeExtension()
ImageTrackerConfiguration.ImageRecognitionRangeExtension
that should be used when target image recognition is active.ImageTrackerConfiguration.ImageRecognitionRangeExtension
used for image recognition.public void setImageRecognitionRangeExtension(ImageTrackerConfiguration.ImageRecognitionRangeExtension imageRecognitionRangeExtension)
ImageTrackerConfiguration.ImageRecognitionRangeExtension
that should be used when target image recognition is active.
Setting this property to ImageTrackerConfiguration.ImageRecognitionRangeExtension.ON
on 32 bit devices will work but slow down computer vision algorithms performance noticeably.
This is ImageTrackerConfiguration.ImageRecognitionRangeExtension.AUTO
by default.imageRecognitionRangeExtension
- ImageTrackerConfiguration.ImageRecognitionRangeExtension
used for image recognition.IllegalArgumentException
- If imageRecognitionRangeExtension is null.public HashMap<String,Integer> getPhysicalTargetImageHeights()
public void setPhysicalTargetImageHeights(HashMap<String,Integer> physicalTargetImageHeights)
physicalTargetImageHeights
- Map of target names and physical image heights in mm.IllegalArgumentException
- If physicalTargetImageHeights is null.public int getMaximumNumberOfConcurrentlyTrackableTargets()
public void setMaximumNumberOfConcurrentlyTrackableTargets(int maximumNumberOfConcurrentlyTrackableTargets)
maximumNumberOfConcurrentlyTrackableTargets
- The maximum number of targets that can be tracked concurrently.IllegalArgumentException
- If the maximumNumberOfConcurrentlyTrackableTargets is less than 1.public int getDistanceChangedThreshold()
ImageTarget.OnDistanceBetweenTargetsListener.onDistanceBetweenTargetsChanged(int, com.wikitude.tracker.ImageTarget, com.wikitude.tracker.ImageTarget)
to be triggered.ImageTarget.OnDistanceBetweenTargetsListener.onDistanceBetweenTargetsChanged(int, com.wikitude.tracker.ImageTarget, com.wikitude.tracker.ImageTarget)
.ImageTarget.OnDistanceBetweenTargetsListener
,
ImageTarget.setOnDistanceBetweenTargetsListener(com.wikitude.tracker.ImageTarget.OnDistanceBetweenTargetsListener)
public void setDistanceChangedThreshold(int distanceChangedThreshold)
ImageTarget.OnDistanceBetweenTargetsListener.onDistanceBetweenTargetsChanged(int, com.wikitude.tracker.ImageTarget, com.wikitude.tracker.ImageTarget)
to be triggered.distanceChangedThreshold
- Threshold to trigger ImageTarget.OnDistanceBetweenTargetsListener.onDistanceBetweenTargetsChanged(int, com.wikitude.tracker.ImageTarget, com.wikitude.tracker.ImageTarget)
.IllegalArgumentException
- If the distanceChangedThreshold is negative.ImageTarget.OnDistanceBetweenTargetsListener
,
ImageTarget.setOnDistanceBetweenTargetsListener(com.wikitude.tracker.ImageTarget.OnDistanceBetweenTargetsListener)
public TrackerEfficiencyMode getTrackerEfficiencyMode()
TrackerEfficiencyMode
documentation for more details.public void setTrackerEfficiencyMode(TrackerEfficiencyMode trackerEfficiencyMode)
TrackerEfficiencyMode
documentation for more details.trackerEfficiencyMode
- the tracker efficiency mode that should be used