📷 Modalità Tracking
Controlla il computer muovendo la testa, tramite webcam e intelligenza artificiale.
🔧 Prerequisiti
Qualunque webcam USB o integrata. Risoluzione minima 480p. Posizionala in modo che il tuo viso sia ben visibile, ben illuminato, e centrato.
Seaclic usa MediaPipe Face Landmarker (face_landmarker.task, ~4 MB).
Il download avviene automaticamente al primo avvio del tracking.
🎯 Calibrazione
La calibrazione misura la posizione neutra della tua testa e il range naturale di movimento nelle 4 direzioni. Va eseguita una volta sola (o quando cambi postura/seduta).
1. Posizione neutra
Siediti nella tua posizione normale. Guarda dritto davanti a te. Premi Acquisisci.
2. Sinistra
Gira la testa verso sinistra fino al tuo limite confortevole. Premi Acquisisci.
3. Destra
Gira la testa verso destra. Premi Acquisisci.
4. Su
Inclina la testa all'indietro (verso l'alto). Premi Acquisisci.
5. Giù
Abbassa la testa (verso il basso). Premi Acquisisci. La calibrazione è completata.
↕️ Direzioni e tipi di azione
Ogni delle 4 direzioni (sinistra, destra, su, giù) può essere mappata a uno dei seguenti tipi di azione:
| Tipo azione | Descrizione | Esempio |
|---|---|---|
| Tastiera | Preme un tasto mentre la testa è inclinata in quella direzione | Sinistra → A; Destra → D per WASD |
| Mouse | Muove il cursore proporzionalmente all'inclinazione | Navigazione web e desktop |
| Pulsante gamepad | Preme un pulsante digitale del controller | D-Pad, A/B/X/Y |
| Trigger analogico | Valore LT o RT proporzionale all'inclinazione (0–100 %) | Acceleratore/freno nei giochi di corsa |
| Joystick analogico | Muove un semi-asse del joystick (LS/RS) proporzionalmente | Locomozione 3D / mira nei giochi |
↔️ Semi-assi joystick
Per il joystick analogico, ogni direzione della testa controlla un semi-asse dello stick (metà dell'escursione sull'asse X o Y). Usando tutte e 4 le direzioni puoi così controllare i 4 semi-assi di uno stick, o i 2 semi-assi di due stick diversi:
| Direzione testa | Semi-asse | Esempio |
|---|---|---|
| Sinistra | LS X− (sinistra) | Muove personaggio a sinistra |
| Destra | LS X+ (destra) | Muove personaggio a destra |
| Su | LS Y− (su) | Muove personaggio in avanti |
| Giù | LS Y+ (giù) | Muove personaggio indietro |
Se vuoi controllare il Right Stick per la visuale, combina il tracking con la modalità Gaze (che usa RS) — vedi la sezione Voice Joystick Overlay.
⚙️ Parametri di ogni direzione
| Parametro | Range | Default | Descrizione |
|---|---|---|---|
| Sensibilità | 1–100 | 50 | Quanto poco bisogna muovere la testa per attivare la direzione |
| Deadzone | 0–50 % | 10 % | Zona morta intorno alla posizione neutra: piccoli movimenti involontari vengono ignorati |
| Smoothing | 1–10 frame | 3 | Media mobile degli ultimi N frame di posizione: riduce il tremolio |
🔄 Auto-drift
L'auto-drift aggiusta automaticamente la posizione neutra se Seaclic rileva che la testa è rimasta in una posizione leggermente spostata per un lungo periodo. Questo compensa la deriva posturale: ci si sposta impercettibilmente durante una sessione lunga e la posizione neutra non corrisponde più a quella calibrata.
📁 Profili di tracking
I profili vengono salvati in seaclic_tracking_profiles.json.
Seaclic include quattro profili predefiniti:
Testa → tasti W/A/S/D. Uso classico per giochi che usano la tastiera.
Testa → puntatore del mouse. Per navigare il desktop o il web.
Su → RT (acceleratore), giù → LT (freno), sinistra/destra → D-Pad. Per racing games.
Testa → Left Stick LS analogico. Per giochi con locomozione 3D (FPS, open world).
Puoi duplicare un profilo predefinito, modificarlo e salvarlo con un nuovo nome. I profili sono esportabili/importabili in JSON.
👁 Overlay webcam
Quando il tracking è attivo, puoi aprire l'overlay webcam (pulsante Mostra webcam nella finestra principale): una finestra sempre in primo piano mostra il feed della webcam con i 468 landmark facciali sovrapposti in tempo reale.
L'overlay è utile per:
- Verificare che la webcam stia rilevando correttamente il viso.
- Controllare la risposta dei landmark durante la calibrazione.
- Debug di problemi di tracking (illuminazione insufficiente, occlusione).
🎙️ Voice Joystick Overlay
Quando sia il tracking che i comandi vocali vogliono controllare lo stesso joystick analogico del gamepad, Seaclic non li sovrascrive — li somma, frame per frame (~30 Hz).
Esempio: il tracking imposta LS X = +60 (testa a destra), e un comando vocale imposta LS X = −100 (strafe a sinistra). Il valore finale trasmesso al controller è la somma delle due contribute (clampata tra −100 e +100).