> For the complete documentation index, see [llms.txt](https://docs.velogicfit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.velogicfit.com/fr/section-02-utiliser-velogic-studio/troubleshooting.md).

# Dépannage de Velogic Studio

Guide complet de dépannage des problèmes courants de Velogic Studio, notamment les performances, les plantages et les problèmes vidéo

Si vous n’obtenez absolument aucune information du Kinect, ou si le Kinect se déconnecte : consultez notre [guide de compatibilité matérielle](/fr/section-01-pour-commencer/pc-system-requirements.md) et [guide de dépannage de la caméra Kinect](/fr/section-01-pour-commencer/kinect-troubleshooting.md) d'abord.

Une fois que vous êtes sûr que le Kinect fonctionne correctement (c.-à-d. que le vérificateur de configuration du Kinect est stable et fournit 29 à 30 FPS), ce guide vous aidera à résoudre les problèmes de l’application.

## L’image filaire n’apparaît pas automatiquement

Voir : [Dépannage de la détection des marqueurs](/fr/section-02-utiliser-velogic-studio/troubleshooting-marker-detection.md)

## La fréquence d’images est faible

Si vous essayez d’obtenir les meilleures conditions environnementales (pour améliorer la fréquence d’images), certains points sont à vérifier.

* Si c’est la première fois que vous exécutez Velogic Studio, ou si vous venez de passer à une nouvelle version, Windows est peut-être encore en train d’optimiser l’application pour votre ordinateur. Laissez-le fonctionner quelques minutes, puis fermez-le et redémarrez-le.
* De fortes sources lumineuses (fenêtre, porte, ampoule) derrière le cavalier, dans le champ de vision du Kinect, entraîneront une baisse de la fréquence d’images et une image floue (bien que cela n’affecte pas la mesure, seulement l’image couleur).
* De mauvaises conditions d’éclairage peuvent correspondre à une zone faiblement éclairée, ou uniquement éclairée par le plafond. Toute situation d’éclairage créant un dégradé sur le cavalier (par ex. plus clair en haut et plus sombre en bas) ou des points chauds (lumière dirigée directement sur l’un des marqueurs) nuira au score d’éclairage.

Voir aussi : [Éclairage et environnement](/fr/section-01-pour-commencer/lighting-environment.md)

## La vue en direct n’est pas en direct (se fige après une image)

Il s’agit d’un problème connu avec les pilotes graphiques Intel Iris Xe. Il existe plusieurs solutions :

* Vous pouvez mettre à jour vos pilotes vers la dernière version et voir si le problème est résolu. Vous devriez pouvoir le faire via le Gestionnaire de périphériques (développez « Adaptateurs d’affichage », cliquez avec le bouton droit sur votre carte graphique et choisissez « Mettre à jour le pilote »), OU installez manuellement la [version de pilote recommandée par Intel](https://www.intel.com/content/www/us/en/download/19344/30579/intel-graphics-windows-dch-drivers.html?) pour corriger ce problème spécifique. Si vous installez cette version de pilote et que le gel persiste, essayez d’utiliser [le logiciel de gestion d’Intel](https://www.intel.com/content/www/us/en/support/detect.html) pour mettre à jour vers une version plus récente des pilotes graphiques.
* Vous pouvez désactiver le code problématique pour tout votre ordinateur en définissant ce drapeau DWORD dans l’Éditeur du Registre : `HKCU\SOFTWARE\Microsoft\Avalon.Graphics\DisableHWAcceleration : 1`
* Velogic Studio dispose d’un paramètre spécial pour désactiver l’accélération matérielle afin de contourner ce problème : Paramètres -> Assistance -> Forcer le mode de rendu logiciel. Il est généralement préférable que ce paramètre soit désactivé (car il oblige votre processeur à effectuer un travail qui devrait être fait par le GPU), mais l’activer contournera le problème de pilote.

## Plantages aléatoires occasionnels

Velogic Studio est une application très stable, mais si vous constatez des plantages occasionnels, lisez ce qui suit pour connaître les solutions possibles.

### Mettre à jour les pilotes d’affichage

Velogic Studio utilise des fonctionnalités de vos pilotes vidéo. Si les pilotes vidéo sont bogués, cela peut provoquer de l’instabilité dans Velogic Studio.

Suivez [ce guide de Microsoft](https://support.microsoft.com/en-us/windows/update-drivers-in-windows-10-ec62f46c-ff14-c91d-eead-d7126dc1f7b6), mais dans le Gestionnaire de périphériques, choisissez « Adaptateur d’affichage » au lieu de l’exemple donné dans l’article : ![Device Manager window showing Display Adapters section for updating video drivers](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-78e146ad5890a5387a593d3c40fc9d49021e8839%2Ftroubleshooting.png?alt=media)

### Demander à l’antivirus de ne pas vérifier les fichiers enregistrés par Velogic Studio

Si Velogic Studio « se fige » lorsque vous enregistrez une capture, cela peut aider. Windows dispose d’un antivirus intégré qui analyse chaque fichier enregistré sur le disque. Parfois, nous pensons qu’il identifie à tort une vidéo en cours d’enregistrement comme un virus, et qu’il bloque Velogic Studio sans qu’aucun rapport d’erreur ne soit envoyé.

Vous pouvez éviter ces faux positifs, et aussi réduire le temps nécessaire pour enregistrer les résultats de chaque capture, en demandant à Windows d’ignorer le répertoire où sont enregistrées les données d’ajustement de Velogic Studio :

* Cliquez sur « Démarrer » et tapez « Virus », puis cliquez sur « Protection contre les virus et menaces »
* Cliquez sur « Gérer les paramètres » dans « Paramètres de protection contre les virus et menaces »

![Paramètres de Protection contre les virus et menaces de Windows Defender avec le bouton Gérer les paramètres](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-5eed58b05bb9fbe0b708891f47118cbf07997a55%2Ftroubleshooting-1.png?alt=media)

* Cliquez sur « Ajouter ou supprimer des exclusions »

![Page des paramètres de protection antivirus avec l’option Ajouter ou supprimer des exclusions](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-e622bccfce29fe80e578a4c77b31906f5b9fec54%2Ftroubleshooting-2.png?alt=media)

* Cliquez sur « Ajouter une exclusion » puis sur « Dossier »

![Boîte de dialogue Ajouter une exclusion avec l’option Dossier sélectionnée pour exclure le répertoire des données d’ajustement](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-a1554c9b0cfb1e1b034b6c180158e4681cb3e49e%2Ftroubleshooting-3.png?alt=media)

* Choisissez le dossier où Velogic Studio enregistre les données d’ajustement (en général, il s’agit de « Documents\Velogic Studio fits », mais vous avez peut-être modifié cela dans les paramètres de Velogic Studio)
* Redémarrez Velogic Studio

### Rechercher d’autres applications utilisant LibUSB

Certains clients ont signalé des problèmes de blocage de Velogic Studio lorsque d’autres applications utilisant LibUSB sont installées sur le même ordinateur. Un exemple d’une telle application est le logiciel de gestion EBike.

Vous pouvez vérifier la présence de LibUSB dans le Gestionnaire de périphériques.

![Gestionnaire de périphériques affichant les pilotes LibUSB dans la liste des périphériques système](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-1949740b9d24d140f8b2e2c78090a2920de2b875%2Ftroubleshooting-4.png?alt=media)

Si vous constatez que LibUSB est présent sur l’ordinateur, essayez de retirer toute autre clé USB de l’ordinateur. Si Velogic Studio reste instable, essayez de supprimer libUSB de l’ordinateur (cliquez avec le bouton droit sur l’entrée dans le Gestionnaire de périphériques et choisissez « Désinstaller le périphérique »)

### Rechercher les messages d’erreur de Velogic Studio dans l’Observateur d’événements

Visual Studio écrit des informations d’erreur dans le journal des événements Windows. Nous pourrions vous demander de consulter les journaux et de nous envoyer un fichier contenant les informations pertinentes. Voici comment faire :

* Appuyez sur la touche Windows et recherchez « Observateur d’événements », puis cliquez pour l’ouvrir

![Résultats de recherche du menu Démarrer de Windows montrant l’application Observateur d’événements](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-0020cf6f004c6bba0ac6552c9a5289f1cb9b658f%2Ftroubleshooting-5.png?alt=media)

* Cliquez sur « Journaux Windows » puis sur « Application »

![Observateur d’événements avec les sections Journaux Windows et Application mises en évidence](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-66fb067705fb03676854ee610b0534563f9ca44a%2Ftroubleshooting-6.png?alt=media)

* Dans la zone Actions à droite de la fenêtre, cliquez sur « Filtrer le journal actuel »

![Volet Actions de l’Observateur d’événements avec l’option Filtrer le journal actuel sélectionnée](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-16848a6983b9c3a4a260d4c79b9e658824c0b2b8%2Ftroubleshooting-7.png?alt=media)

* Dans la fenêtre contextuelle de filtre, définissez les options : niveau d’événement = Erreur, sources d’événements = .NET Runtime, ID d’événement = 1011, puis cliquez sur OK

![Boîte de dialogue Filtrer le journal actuel avec le niveau Erreur et les paramètres .NET Runtime configurés](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-53e1f68e8d8cde5680481b65981a26099c9a9e02%2Ftroubleshooting-8.png?alt=media)

* Dans la zone Actions à droite de la fenêtre, cliquez sur « Enregistrer le fichier journal filtré sous… »

![Volet Actions de l’Observateur d’événements montrant l’option Enregistrer le fichier journal filtré](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-75aa2f2d6a1cd4dc0daa3f572d1c07b1a3c6fae0%2Ftroubleshooting-9.png?alt=media)

* Dans la boîte de dialogue Enregistrer, donnez un nom au fichier (par ex. votre nom) et enregistrez-le à un endroit où vous pourrez le retrouver, par ex. sur le bureau

![Boîte de dialogue Enregistrer sous pour exporter le fichier journal d’événements filtré vers le bureau](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-74dc2128b1d90e07023a1b40a284514564a14d75%2Ftroubleshooting-10.png?alt=media)

* Envoyez un e-mail avec ce fichier en pièce jointe à <support@velogicfit.com>

### Téléverser des fichiers de vidage

Si Velogic Studio se ferme de manière inattendue (plante), il devrait écrire un fichier de vidage dans un répertoire de votre ordinateur puis redémarrer.

Lorsqu’il redémarre, il remarquera que le fichier de vidage existe et affichera une invite en bas de la fenêtre principale de Velogic Studio.

![Invite de téléversement du fichier de vidage de plantage de Velogic Studio avec le bouton Téléverser en bas de la fenêtre](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-b07da01dd3e5207065367f1fbca048ec0543b210%2Ftroubleshooting-11.png?alt=media)

Ces fichiers de vidage sont très utiles pour nous aider à diagnostiquer, puis éventuellement corriger, le problème à l’origine du plantage. Si vous voyez ce message et que vous disposez d’une connexion Internet raisonnable, veuillez cliquer sur le bouton « Téléverser ». Velogic Studio compressera les fichiers de vidage et les téléversera à notre équipe d’assistance.

Le téléversement peut prendre plusieurs minutes, mais vous pouvez utiliser l’application normalement pendant le téléversement, et vous pouvez l’annuler à tout moment.

Si vous ne souhaitez pas téléverser les fichiers au support, vous pouvez cliquer sur « Supprimer ». Ou vous pouvez cliquer sur le bouton X pour masquer le message sans effectuer d’action.

### Nous envoyer un fichier de vidage manuel

Si Visual Studio devient ne répond plus, mais qu’il ne crée pas automatiquement de fichier de vidage (voir ci-dessus), nous pourrions vous demander de créer manuellement un fichier de vidage. Voici comment faire :

* Lancez le Gestionnaire des tâches (en appuyant simultanément sur les touches ctrl+shift+esc)
* Repérez Velogic Studio et cliquez sur l’icône d’extension à côté

![Gestionnaire des tâches montrant le processus Velogic Studio avec vue développée des sous-processus](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-9ed9554ad89842648da249e060da5fcf4eb24bff%2Ftroubleshooting-12.png?alt=media)

* Cliquez avec le bouton droit sur le processus et choisissez « Créer un fichier de vidage »

![Menu contextuel du clic droit sur le processus montrant l’option Créer un fichier de vidage](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-a055a3ac74dfdabf9c0055385e8fc73287357ef3%2Ftroubleshooting-13.png?alt=media)

* Vous verrez un message comme celui-ci :

  ![Boîte de dialogue de progression de la création du fichier de vidage montrant la génération du fichier en cours](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-5efe042bba4a54dc8ba954ae605335cc39a8779b%2Ftroubleshooting-14.png?alt=media)

  ... puis, après quelques secondes, vous verrez :

  ![Boîte de dialogue de création du fichier de vidage terminée montrant l’emplacement du chemin du fichier](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-29c458bdaabcb998fbf5e7d65565dfa073a49412%2Ftroubleshooting-15.png?alt=media)
* Dans votre navigateur web, visitez <https://vlgc.io/upload>, et cliquez sur le bouton « Sélectionner des fichiers »

![Interface de téléversement web sur vlgc.io/upload avec le bouton Sélectionner des fichiers](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-44ad9584d63e9094155da844db9575bceb60b279%2Ftroubleshooting-16.png?alt=media)

* Accédez au chemin de l’étape précédente (par ex. c:\Users\<yourname>\AppData\Local\temp\Velogic.Studio.App.DMP). Pour faciliter les choses, vous pouvez le saisir dans la zone Nom de fichier : `%localappdata%\temp\Velogic.Studio.App.DMP`
* Saisissez votre prénom et votre nom, puis cliquez sur « Téléverser »

![Formulaire de téléversement de fichier avec champs de nom et bouton Téléverser pour envoyer le fichier de vidage](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-c980fa2f2fce73b68f324afdf74f84c46950469f%2Ftroubleshooting-17.png?alt=media)

* Le téléversement prendra quelques minutes, selon votre connexion Internet. Le fichier de vidage fera probablement environ 1 Go, donc si votre connexion Internet est coûteuse, veuillez nous contacter pour vous assurer que c’est la meilleure procédure pour vous.
* Veuillez également envoyer un e-mail à <support@velogicfit.com>, en expliquant pourquoi vous avez envoyé le fichier .dmp. Idéalement, votre e-mail contiendra :
  * Ce que vous faisiez
  * Ce à quoi vous vous attendiez
  * Ce qui s’est réellement passé

## L’application semble généralement lente, les vidéos ont du retard

Les applications Velogic devraient toujours être réactives et offrir de bonnes performances sur un matériel raisonnable. Si vous disposez d’un matériel dépassant nos spécifications minimales et que vous n’obtenez pas les performances attendues, voici quelques points à vérifier.

### Essayez de débrancher la webcam

Nous avons reçu des signalements d’utilisateurs selon lesquels certaines webcams consomment elles-mêmes beaucoup de CPU, laissant trop peu de ressources aux applications Velogic pour fonctionner. Essayez de déconnecter votre webcam et, si les performances s’améliorent nettement, utilisez une autre webcam.

### Utilisez Process Explorer pour trouver le goulot d’étranglement

Process Explorer est un utilitaire gratuit de Microsoft (faisant partie de la suite gratuite Sysinternals).

Vous pouvez le télécharger ou l’exécuter directement depuis la [page web de Process Explorer](https://docs.microsoft.com/en-us/sysinternals/downloads/process-explorer). Repérez simplement le processus Velogic dans la liste des processus, puis cliquez avec le bouton droit et choisissez « Propriétés ». Laissez-le en cours d’exécution pendant que vous effectuez certaines activités dans Velogic Studio, puis examinez les graphiques.

![Graphiques de performance de Process Explorer montrant l’utilisation du CPU, la mémoire et les statistiques d’E/S](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-695dd3522704a4b50c5d68b8a15716dfbcaac5bd%2Ftroubleshooting-18.png?alt=media)

Vous pouvez examiner :

* Utilisation du CPU - l’utilisation du CPU est faible, ce qui est bon. (Une utilisation élevée du CPU n’est pas nécessairement mauvaise, sauf si les performances globales de l’application ne vous conviennent pas)
* « Octets privés » - il s’agit de l’utilisation mémoire, et elle devrait rester assez constante, autour de 500 à 700 Mo. Si elle augmente continuellement et rapidement, il se peut que vous soyez confronté à une fuite mémoire - veuillez nous contacter et nous envoyer une copie de votre graphique (vous pouvez en faire une capture d’écran avec la combinaison de touches \[Maj]-\[Windows]-\[s])
* E/S - les pics d’E/S se produisent pendant la période de capture, lorsque l’application écrit la vidéo sur le disque. En dehors de cela, les E/S sont faibles. Le pic de CPU pendant la période de capture est assez faible, donc le CPU ne travaille pas trop pour encoder les vidéos.

Nous sommes heureux de vous aider à diagnostiquer tout problème de performance que vous rencontrez avec notre logiciel. Veuillez nous contacter en nous donnant le plus d’informations possible - idéalement avec une capture d’écran de Process Explorer.

### Envoyer des données de performance pour que nous les analysions

Nous avons intégré dans Velogic Studio un outil que vous pouvez utiliser pour envoyer des données de performance détaillées. Voir [cet article](/fr/section-01-pour-commencer/submitting-performance-data.md) pour plus de détails.

### Nous envoyer des informations système

Windows dispose d’un outil intégré pour recueillir des informations détaillées sur le matériel et le système d’exploitation de votre ordinateur. Cela peut parfois être utile pour nous aider à diagnostiquer les problèmes. Si nous vous le demandons :

* Cliquez sur le menu Windows et tapez « Informations système », puis lancez l’application :

  ![Recherche du menu Démarrer de Windows montrant l’application Informations système](https://2689818724-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-3357cd97f790a4ab99602800af6415263a9d6633%2Ftroubleshooting-19.png?alt=media)
*
* Cliquez sur Fichier -> Exporter, enregistrez le fichier quelque part (par ex. sur votre bureau), puis envoyez-nous le fichier par e-mail - <support@velogicfit.com>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.velogicfit.com/fr/section-02-utiliser-velogic-studio/troubleshooting.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.