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. |