gestes_main
diapason.desktop.gestes_main
¶
Le moteur de gestes : des points articulaires à une intention.
Spatial Mesh, gestes — 25 août 2026. Ce module ne voit pas, ne capture rien et ne parle à personne : il reçoit vingt-et-un points par main et rend un état. C'est délibéré — la fiabilité d'un geste se joue ici, pas dans la caméra, et elle doit se tester sans matériel.
Le §11 du cahier des charges est la règle qui structure tout : ne jamais déclencher une action depuis une seule image. Une main qui passe devant l'objectif produit, pendant deux ou trois images, quelque chose qui ressemble à un poing. C'est ainsi qu'un document part tout seul.
D'où la chaîne : points bruts → normalisation → lissage → mesures → pose → état temporel. Et deux protections que l'expérience impose :
L'hystérésis. Le seuil pour ENTRER dans un état est plus exigeant que celui pour en SORTIR. Sans cela, une main qui hésite à la frontière fait osciller l'état dix fois par seconde.
Le temps de repos. Après un geste reconnu, un délai pendant lequel rien n'est reconnu. Sans lui, ouvrir la main après un « attraper » déclenche immédiatement un « relâcher », puis l'inverse.
Les seuils ne sont pas dispersés dans le code : ils vivent dans un objet, et ils se règlent (§13).
Etat
¶
Bases: str, Enum
Ce que l'utilisateur est en train de faire — avec mémoire (§12).
Mesures
dataclass
¶
Ce qu'on lit d'une main, indépendamment de sa taille et sa distance.
MoteurDeGestes
¶
La machine à états (§12), avec hystérésis et temps de repos.
Une instance suit UNE main. Elle ne connaît ni caméra, ni fichier, ni appareil : elle rend un état, et c'est à l'appelant d'en faire quelque chose — ou rien, ce qui est le cas le plus fréquent et le plus sain.
observer(points, *, maintenant=None)
¶
Une image de plus. Rend l'état APRÈS cette image.
points vaut None quand aucune main n'est vue — et c'est une
information, pas une absence d'information : une main qui disparaît
au milieu d'un geste doit l'annuler, jamais le figer.
Pose
¶
Bases: str, Enum
Ce qu'une main FAIT sur une image donnée — sans mémoire.
Seuils
dataclass
¶
Tous les nombres qui décident, en un seul endroit (§13).
Aucun de ces nombres n'est magique : ce sont des points de départ raisonnables, à régler sur des vraies mains — et le §141 exige que les faux positifs soient MESURÉS avant de dire que les gestes sont finis.
charger_seuils()
¶
Les seuils de CETTE machine — ceux d'usine si rien n'est calibré.
mesurer(points)
¶
Les mesures d'une main, ou None si elle est trop incomplète.
Tout est rapporté à la largeur de la paume : une main près de l'objectif et une main au fond de la pièce donnent les mêmes nombres. C'est ce qui rend les seuils tenables sans calibration par utilisateur.
seuils_calibres(repliement_ouvert, repliement_ferme, *, base=None)
¶
Des seuils dérivés de DEUX mesures réelles, pas d'une supposition.
L'hystérésis occupe le tiers central de l'écart mesuré : assez large pour qu'une main qui hésite ne fasse pas osciller l'état, assez étroite pour que le geste reste franc.