Détection d'Objets — Suivi du Club de Golf et de la Balle
Qu’est-ce que la Détection d’Objets ?
Lorsque la détection d’objets est activée, Swing Catalyst détecte le club de golf et la balle dans chaque image vidéo et dessine des superpositions 3D par-dessus la visualisation du squelette. Vous voyez :
- Superposition du club — cinq points clés le long du manche (haut de la tête, bas de la tête, bas du manche, milieu et bout du grip) reliés par des lignes à code couleur. Les couleurs passent du jaune à la tête du club au cyan au niveau du grip, pour que l’orientation soit immédiatement claire.
- Superposition de la balle — une seule sphère blanche à la position détectée de la balle.
Les superpositions apparaissent aussi bien en vue caméra en direct que pendant la lecture des prises enregistrées. Les prises enregistrées sans détection d’objets se lisent normalement, avec une visualisation du corps uniquement.
Pourquoi la Détection d’Objets Est Réservée au Golf
La détection d’objets ne prend actuellement en charge que le golf. Les modèles sous-jacents (RTMDet-M pour la détection d’objets et RTMPose-M pour l’estimation de la posture du club) sont entraînés spécifiquement sur du matériel de golf. Étendre la fonctionnalité à d’autres sports (baseball, tennis) nécessite des modèles entraînés supplémentaires, qui ne sont pas encore disponibles. L’architecture est conçue pour prendre en charge d’autres sports à l’avenir ; aucune modification du code du pipeline ne sera nécessaire lorsque de nouveaux modèles seront publiés.
Comment Activer ou Désactiver la Détection d’Objets
Mode de détection (paramètre global)
- Ouvrez Paramètres → Vidéo et Capture.
- Faites défiler jusqu’à la section Paramètres avancés.
- Repérez le menu déroulant Mode de détection.
- MultiClass — exécute à la fois la détection de personne ET la détection d’objets. C’est le mode par défaut.
- HumanOnly — exécute uniquement la détection de personne. Utilisez ce mode si vous n’avez pas besoin du suivi du club et de la balle, ou si vous rencontrez des problèmes de performance.
- Le changement de mode redémarre automatiquement les services de détection. Aucun redémarrage de l’application n’est nécessaire.
Bascule Activer la détection d’objets (par session)
Lorsque le Mode de détection est réglé sur MultiClass, une bascule distincte Activer la détection d’objets est disponible. Désactivez-la pour ignorer temporairement la détection d’objets pour la session en cours, sans modifier le Mode de détection global. Cette bascule est grisée lorsque le Mode de détection est HumanOnly.
Afficher / Masquer les superpositions dans la fenêtre d’affichage
Utilisez la barre d’outils au-dessus de la fenêtre d’affichage pour afficher ou masquer indépendamment les superpositions du club et de la balle :
- Afficher le club — active ou désactive la superposition des points clés et des os du club.
- Afficher la balle — active ou désactive la superposition de la sphère de la balle.
Ces bascules prennent effet immédiatement sans redémarrer la détection et sont conservées d’une session à l’autre.
Configuration Matérielle Requise
La détection d’objets nécessite plus de mémoire GPU que la capture de mouvement du corps seul.
| Mode | VRAM minimum | VRAM recommandée |
|---|---|---|
| HumanOnly (corps uniquement) | 6 Go | 8 Go |
| MultiClass (corps + matériel de golf) | 8 Go | 10 Go+ |
Pour tous les détails et la liste complète des cartes graphiques compatibles, consultez Configuration d’ordinateur recommandée .
Sur les systèmes avec moins de 8 Go de VRAM, l’application peut automatiquement revenir à la détection de personne uniquement. Une bannière de notification apparaîtra dans Paramètres → Vidéo et Capture si cela se produit.
Graphiques intégrés Intel (UHD 620/770) : la détection d’objets est automatiquement désactivée sur les configurations avec GPU intégré Intel, car le budget VRAM attribué par le système d’exploitation (généralement 400 à 800 Mo) est insuffisant. La capture de mouvement de la personne seule continue de fonctionner normalement.
Ce Que Vous Voyez en Lecture
Lorsque vous ouvrez une prise enregistrée avec la détection d’objets activée :
- Les superpositions du club et de la balle apparaissent sur la chronologie, aux côtés du squelette corporel.
- Les superpositions restent synchronisées avec l’image vidéo lorsque vous parcourez la chronologie.
- Les détections à faible confiance s’estompent progressivement plutôt que de sauter vers des positions incorrectes.
- Vous pouvez basculer indépendamment la visibilité du club et de la balle à l’aide des commandes de la barre d’outils décrites ci-dessus.
Les prises enregistrées avant la disponibilité de la détection d’objets, ou avec le Mode de détection réglé sur HumanOnly, n’affichent que le squelette corporel. Aucun retraitement n’est nécessaire pour les visualiser : elles s’ouvrent normalement.
Pour ajouter des données de détection d’objets à une prise existante, ouvrez l’enregistrement en mode analyse, cliquez sur le bouton Capture de Mouvement dans la barre d’outils, puis choisissez Retraiter la MoCap. Cela relance à la fois la détection du corps et celle des objets sur les images enregistrées.
Dépannage
Les superpositions du club et de la balle n’apparaissent pas
- Vérifiez que Paramètres → Vidéo et Capture → Mode de détection est réglé sur MultiClass.
- Vérifiez que la bascule Activer la détection d’objets est activée.
- Vérifiez si la bannière de notification « Les modèles de suivi du club et de la balle ne sont pas encore disponibles » s’affiche dans les paramètres. Si c’est le cas, les fichiers de modèle requis sont absents du répertoire des composants. Réinstallez les composants de capture de mouvement en suivant le Guide d’installation des composants .
Avertissement VRAM / retour automatique à la détection de personne uniquement
L’application consigne un avertissement et revient à la détection de personne uniquement lorsque :
- DirectML signale moins de 600 Mo de VRAM libre au démarrage du service, ou
- Le système possède un GPU intégré Intel.
Pour résoudre ce problème : assurez-vous qu’aucune autre application gourmande en GPU n’est en cours d’exécution, et vérifiez que votre carte graphique répond à la configuration recommandée pour la détection MultiClass (8 Go de VRAM minimum).
Les superpositions apparaissent pour la mauvaise activité
La détection d’objets n’est active que pour les activités de golf. Si vous enregistrez un sport autre que le golf et ne voyez aucune superposition de club ou de balle, il s’agit d’un comportement normal. Le paramètre Mode de détection ne s’affiche pas dans les Paramètres pour les activités autres que le golf.
Précision de détection faible ou superpositions instables
- Assurez-vous que le club et la balle sont bien éclairés et ne sont pas masqués pendant une part importante du swing.
- Essayez de réduire la fréquence d’images de la caméra pour diminuer la charge système (voir Paramètres de Capture de Mouvement ).
- Augmentez le seuil de confiance de détection dans Paramètres → Vidéo et Capture → Paramètres avancés si vous constatez de fausses détections provenant d’objets d’arrière-plan.
- En cas de détection constamment médiocre, essayez de basculer le Fournisseur d’exécution sur DirectML, car il offre la plus large compatibilité matérielle.
Fichiers de modèle manquants après une mise à jour
Si une mise à jour de l’application modifie les versions de modèle requises, la bannière de notification réapparaîtra dans les paramètres. Suivez le Guide d’installation des composants pour réinstaller les composants.
Voir aussi : Guide de la Capture de Mouvement · Paramètres de Capture de Mouvement · Configuration Requise