Modalità Input — Seaclic

📖 Cos'è la modalità Input

La modalità Input è l'opposto della modalità Comandi: invece di mappare una parola pronunciata → azione, mappa un input fisico (tasto premuto, pulsante cliccato, pulsante gamepad) → qualsiasi azione Seaclic.

È particolarmente utile per:

Switch access: un solo tasto o pulsante esterno → navigazione completa.
Remapping tastiera: ridefinire tasti scomodi o inutilizzati.
Remapping gamepad: riassegnare pulsanti del controller fisico.
Telecomandi alternativi: un pulsante HID personalizzato → azione Seaclic.

💡 In parallelo con tutto La modalità Input gira in un thread dedicato — può operare contemporaneamente a Comandi, Trova, Mouse, Tracking e Gaze senza conflitti.

🎮 Input fisici supportati

Tipo input	Esempi	Note
Tasto tastiera	`F1`, `Ctrl`+`Alt`+`T`, `Backspace`	Qualunque tasto singolo o combinazione
Pulsante mouse	Click sinistro, destro, centrale, pulsanti laterali M4/M5	—
Pulsante gamepad fisico	A, B, X, Y, LB, RB, DPAD…	Richiede un controller XInput fisico collegato al PC
Trigger gamepad fisico	LT, RT (soglia superata)	Si attiva quando il trigger supera una soglia configurabile (default 50 %)

⚡ Modalità di trigger

Per ogni binding puoi scegliere quando l'azione viene eseguita:

⬇️

Press (pressione)

L'azione viene eseguita nel momento esatto in cui premi il tasto/pulsante. Ideale per azioni istantanee (click, salta, spara).

⬆️

Release (rilascio)

L'azione viene eseguita quando rilasci il tasto/pulsante. Utile per distinguere tap brevi da hold, o per azioni "conferma".

⏳

Hold (mantenuto)

L'azione si attiva dopo che hai tenuto premuto il tasto per un tempo configurabile (in ms). Permette di avere due azioni diverse sullo stesso tasto: tap breve e hold lungo.

✅ Doppio binding sullo stesso tasto Puoi avere due binding sullo stesso tasto con modalità diverse: ad esempio Press su F13 → pulsante A gamepad, e Hold 500ms su F13 → start Seaclic.

🚫 Soppressione input originale

Per ogni binding puoi abilitare l'opzione Sopprimi input: quando attiva, l'input fisico originale viene bloccato e non raggiunge il sistema operativo né le altre applicazioni.

Senza soppressione: il tasto fisico fa la sua cosa normale e in più scatta l'azione Seaclic.
Con soppressione: solo l'azione Seaclic viene eseguita — il tasto originale è invisibile al sistema.

⚠️ Attenzione con la soppressione sulla tastiera Se sopprimi un tasto molto usato dal sistema (es. Alt+F4), potresti non riuscire più a chiudere le finestre normalmente. Usa la soppressione solo su tasti che puoi "dedicare" completamente a Seaclic.

📁 Profili Input

Come la modalità Comandi, anche Input supporta profili multipli salvati in seaclic_input_profiles.json. Puoi creare profili diversi per contesti diversi (switch access, gaming, accessibilità) e passarci tramite le impostazioni.

Dalla scheda Input nelle impostazioni hai accesso alle stesse operazioni di Comandi:

Crea, rinomina, duplica, elimina profili
Esporta/importa in JSON
Aggiungi, modifica, rimuovi singoli binding

💡 Casi d'uso

🔘

Switch access

Un pulsante esterno USB (es. Ablenet, Specs) registrato come tasto F13 → azione Seaclic toggle_trova. Un secondo switch su F14 → click sinistro. Controllo completo con due switch.

🎮

Remapping gamepad

Pulsante Guide del controller fisico → toggle_tracking. Così puoi sospendere il face tracking durante una cutscene premendo il logo XBox.

⌨️

Tastiera alternativa

Tasto Scroll Lock (normalmente inutilizzato) → avvia Seaclic. Tasto Pausa → ferma Seaclic. Toggle rapido senza usare il mouse.

📡

Telecomando IR

Un dispositivo HID che emette tasti virtuali (es. telecomando USB) → azioni IR Broadlink. Premi il pulsante del telecomando, Seaclic invia il segnale IR al TV.