Apprenez-lui votre meuble

La calibration automatique apprend à reconnaître lockbars et rails latéraux à partir de vrais meubles : chaque bois, chaque éclairage, chaque angle de caméra. Elle en a encore vu très peu. C'est le principal goulot d'étranglement du projet, et n'importe quel possesseur de pincab peut aider, en deux minutes, sans coder.

Envoyer un relevé

Téléchargez headtracking-demo depuis la page des versions (il est dans la même archive que le plugin). Rien à installer.
Pointez votre webcam ou votre Kinect vers le plateau et sélectionnez-la dans la démo.
Cliquez sur 🎁 Contribute, lisez les conditions, cochez la case de consentement et confirmez.

Meuble vide ou en pleine partie, de jour comme de nuit, chaque variation aide. Le détecteur apprend le meuble : inutile d'être dans l'image, même si les relevés avec un joueur devant le meuble sont les plus rares. Les minicabs sont exactement le genre de meuble que le modèle n'a jamais vu.

Vue de la caméra depuis le fronton, avec quatre lignes tracées le long de la lockbar et des rails, et leurs points d'intersection — Ce qui est extrait d'un relevé : les deux bords de la lockbar, les deux rails latéraux et leurs six points d'intersection.

Ce qui est partagé

La démo affiche tout ce qui suit dans sa fenêtre de consentement, avant le moindre envoi.

Les images : une image par flux de votre capteur (couleur, plus infrarouge et profondeur sur une Kinect), avec ce que le détecteur a vu. Elles montrent votre meuble et ce qui l'entoure, éventuellement des personnes et leur visage : vérifiez l'aperçu avant d'accepter, et ne partagez que des images que vous avez le droit de diffuser.
Un journal de diagnostic : la version de l'application, votre système d'exploitation, le modèle du capteur, sa vitesse USB et le nombre d'appareils qui partagent son contrôleur, les mesures d'images par seconde, le nom de votre compte, le nom de votre ordinateur, et un identifiant aléatoire créé pour cette installation, afin de suivre un même meuble d'une version à l'autre.
Usage unique : entraîner et améliorer le modèle de suivi de tête. Les relevés ne sont jamais publiés, vendus ni partagés avec des tiers.
Stockage : les envois arrivent sur le serveur privé du mainteneur, en écriture seule, sans compte. Vous pouvez aussi garder votre propre copie dans le dossier de votre choix.
Suppression : indiquez sur Discord le nom exact du fichier affiché après l'envoi.

Si l'envoi ne passe pas

Un pare-feu, un proxy ou un antivirus qui intercepte le HTTPS peut bloquer l'envoi. La démo l'indique en rouge avant la capture, et garde le relevé dans un dossier dont elle affiche le chemin. Envoyez ce dossier sur Discord : il vaut exactement autant qu'un envoi. headtracking-demo --upload-test indique en une ligne si cet ordinateur arrive à joindre le serveur.

Autres façons d'aider

Annoter des photos : tracer 4 lignes par photo dans un outil qui s'ouvre dans le navigateur, dans tools/anchor. Plus de meubles, c'est un modèle qui marche partout.
Tester sous Windows ou macOS : des versions sont publiées pour les deux, et ce sont les retours d'utilisation réelle qui manquent.
Joueurs de VPX et de flipper : essayez le plugin sur de vraies tables, et dites-nous ce que vous pensez du point de vue et ce qu'il faut pour bien régler un meuble.
Développeurs Rust : le plugin VPX, le décodeur de calibration, le filtrage et la conversion vers la vue de VPX.
Vision par ordinateur et apprentissage automatique : les modèles de tête et d'ancre, le calcul des points de fuite et de l'homographie, la récupération de la focale des webcams.

Aucune permission à demander : ouvrez un ticket sur GitHub ou passez dire bonjour sur le Discord. CLAUDE.md fait visiter l'architecture, et les tickets marqués good first issue permettent de démarrer en douceur.