Image Tracking: Conceptos

Qué es

El Image Tracking SDK de Monolook permite detectar y trackear imágenes en tiempo real usando la cámara del dispositivo. Cuando detecta una imagen conocida (marker), calcula su posición y orientación en el espacio 3D, permitiendo superponer contenido digital sobre ella.

Cómo funciona

1. Añades targets — Imágenes que el SDK debe buscar
2. Inicias el tracking — El SDK activa la cámara y empieza a buscar
3. Detección — Cuando encuentra un target, emite el evento found
4. Pose — En cada frame calcula posición y rotación del marker
5. El adapter traduce la pose al motor 3D y posiciona tu contenido

Conceptos clave

Target

Una imagen que el SDK sabe buscar. Se carga con addTarget(id, imageElement). Cada target tiene un ID único que usas para asociarle contenido 3D.

Marker

La imagen física (impresa, en pantalla, etc.) que la cámara ve. Es el target "en el mundo real".

Adapter

La capa que conecta el tracker con tu motor 3D (Three.js, Babylon.js o A-Frame). Se encarga de posicionar y mostrar/ocultar tu contenido según el tracking.

Pose

La posición y orientación del marker en el espacio 3D. Incluye:

• position — Coordenadas XYZ
• forward — Vector dirección
• up — Vector arriba
• rotationMatrix — Matriz de rotación completa

Flujo de eventos

init() → addTarget() → start()
                          ↓
                    [cámara activa]
                          ↓
                    marker detectado → evento 'found'
                          ↓
                    cada frame → evento 'pose' (posición actualizada)
                          ↓
                    marker perdido → evento 'lost'

Matchers

El SDK ofrece dos algoritmos de matching:

• BFMatcher (por defecto) — Fuerza bruta, más preciso
• FLANN — Más rápido, útil con muchos targets

Puedes cambiar en runtime con tracker.setMatcherType(useFlann).