Skip to content

TrackerDefaults

Global auto-tracking settings. Static defaults - adjust these values as needed. TrackingQuality uses histogram discriminability, ShapeQuality uses variance StdDev.

Constant Value Description
QUALITY_TO_START 0.3 A minimum quality score (0-1) required to start tracking.
FRAMES_TO_START 2 Consecutive frames with good quality required before starting.
FRAMES_TO_LOSE 5 Consecutive frames with bad quality required before stopping.
STABILIZATION_FRAMES 30 Frames after tracking starts before quality-based decisions (loss/SLAM entry) are allowed.
NICE_QUALITY_THRESHOLD 0.8 Quality threshold for "nice" tracking status (vs "poor").
LOSE_TRACKING_THRESHOLD 0.4 Quality threshold below which tracking is considered lost.
SD_MIN 0.10 StdDev floor for the perfect shape fit. Correct models typically achieve ~0.10-0.16.
SD_MAX 3 StdDev ceiling for poor shape fit. Wrong models can show sd > 1.0.
HISTOGRAM_GOOD 0.7 Histogram discriminability value for good tracking (maps to quality 1.0). Also used as default/reset value for global peak.
HISTOGRAM_BAD 0.0 Histogram discriminability value for poor tracking (maps to quality 0.0).
PEAK_MIN 0.6 Minimum value for global histogram peak. Floor for quality reference.
PEAK_MAX 0.85 Maximum value for global histogram peak. Ceiling for quality reference.
PEAK_DECAY_RATE 0.9995 Peak decay rate per frame. At 60fps, 0.9995 = ~3% decay per second.
STATIONARY_FRAMES_TO_RECOVER 5 Consecutive good frames before exiting SLAM recovery.
EDGE_QUALITY_TO_START 0.65
EDGE_LOSE_TRACKING_THRESHOLD 0.5
EDGE_NICE_QUALITY_THRESHOLD 0.8
EDGE_QUALITY_COVERAGE_MAX 0.55 Edge coverage value that maps to quality 1.0 via InverseLerp(0, this, coverage).
EDGE_RESIDUAL_MAX 15 Edge median residual (pixels) fallback when no valid edge points.
EDGE_PROJECTION_ERROR_BAD 30 Projection error (degrees) fallback when no valid edge points.
DEFAULT_SMOOTH_TIME 0.1 Default smooth time in seconds for stationary pose corrections. 0 = instant.