@srsergio/taptapp-ar 1.0.33 โ 1.0.34
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +16 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
- ๐ผ๏ธ **Hyper-Fast Compiler**: Pure JavaScript compiler that generates `.mind` files in **< 0.9s per image**.
|
|
12
12
|
- โก **No TensorFlow Dependency**: No TFJS at all. Works natively in any JS environment (Node, Browser, Workers).
|
|
13
13
|
- ๐ **Protocol V5.1 (Moonshot LSH)**: 128-bit Locality Sensitive Hashing (LSH) for descriptors, resulting in **5-10x smaller metadata** and ultra-fast binary matching.
|
|
14
|
-
- ๐งต **
|
|
14
|
+
- ๐งต **High-Precision Tracking**: Now using **Float32** coordinate precision for rock-solid tracking stability, even in low-light or extreme angles.
|
|
15
15
|
- ๐ฆ **Framework Agnostic**: Includes wrappers for **A-Frame**, **Three.js**, and a raw **Controller** for custom engines.
|
|
16
16
|
|
|
17
17
|
---
|
|
@@ -36,6 +36,20 @@ npm install @srsergio/taptapp-ar
|
|
|
36
36
|
|
|
37
37
|
---
|
|
38
38
|
|
|
39
|
+
## ๐ก๏ธ Robustness & Stability (Stress Tested)
|
|
40
|
+
|
|
41
|
+
The latest version has been rigorously tested with an adaptive stress test (`robustness-check.js`) covering diverse resolutions (VGA to FHD), rotations (X/Y/Z), and scales.
|
|
42
|
+
|
|
43
|
+
| Metric | Result | Description |
|
|
44
|
+
| :--- | :--- | :--- |
|
|
45
|
+
| **Pass Rate** | **96.3%** | 208/216 Tests passed across all conditions. |
|
|
46
|
+
| **Drift Tolerance** | **< 15%** | Validated geometrically against ground truth metadata. |
|
|
47
|
+
| **Tracking Precision** | **Float32** | Full 32-bit precision for optical flow tracking (no compression artifacts). |
|
|
48
|
+
| **Detection Time** | **~21ms** | Ultra-fast initial detection on standard CPU. |
|
|
49
|
+
| **Total Pipeline** | **~64ms** | Complete loop (Detect + Match + Track + Validate) on single core. |
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
39
53
|
## ๐ผ๏ธ Compiler Usage (Node.js & Web)
|
|
40
54
|
|
|
41
55
|
The compiler is designed to run in workers (Node.js or Browser) for maximum performance.
|
|
@@ -232,7 +246,7 @@ TapTapp AR uses a proprietary **Moonshot Vision Codec** that is significantly mo
|
|
|
232
246
|
|
|
233
247
|
- **128-bit LSH Fingerprinting**: Each feature point is compressed from 84 bytes to 16 bytes using Locality Sensitive Hashing.
|
|
234
248
|
- **Binary Matching Engine**: Uses hardware-accelerated population count (`popcount`) and `XOR` for near-instant point matching.
|
|
235
|
-
- **Zero-Copy Restoration**: Binary buffers are mapped directly to TypedArrays (Uint32 for descriptors,
|
|
249
|
+
- **Zero-Copy Restoration**: Binary buffers are mapped directly to TypedArrays (Uint32 for descriptors, Float32 for tracking coordinates).
|
|
236
250
|
- **Cache Locality**: Performance is optimized for modern CPUs by keeping coordinates and descriptors adjacent in memory.
|
|
237
251
|
|
|
238
252
|
---
|