> 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

Si vous ne parvenez à obtenir aucune information du Kinect, ou si le Kinect se déconnecte : consultez notre [guide de compatibilité matérielle](/fr/section-01-prise-en-main/pc-system-requirements.md) et [guide de dépannage de la caméra Kinect](/fr/section-01-prise-en-main/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 Kinect est stable et affiche 29 à 30 FPS), ce guide vous aidera à dépanner les problèmes liés à l’application.

## Le wireframe 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 cherchez à obtenir les meilleures conditions environnementales possibles (pour améliorer la fréquence d’images), certains points sont à vérifier.

* Si c’est la première fois que vous lancez Velogic Studio, ou si vous venez de passer à une nouvelle version, Windows peut encore être occupé à optimiser l’application pour votre ordinateur. Veuillez le laisser tourner quelques minutes, puis fermez-le et redémarrez-le.
* Des sources de lumière fortes (fenêtre, porte, ampoule) derrière le cavalier, visibles par le 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 à un éclairage uniquement zénithal. Toute situation d’éclairage qui crée un dégradé sur le cavalier (p. ex. lumineux en haut et sombre en bas) ou des points chauds (éclairage direct sur l’un des marqueurs) nuira au score d’éclairage.

Voir aussi : [Éclairage et environnement](/fr/section-01-prise-en-main/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 soit via le Gestionnaire de périphériques (développez les adaptateurs d’affichage, cliquez avec le bouton droit sur votre carte graphique et choisissez Mettre à jour le pilote), SOIT installer manuellement le [version du pilote recommandée par Intel](https://www.intel.com/content/www/us/en/download/19344/30579/intel-graphics-windows-dch-drivers.html?) pour résoudre ce problème spécifique. Si vous installez cette version du 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 l’ensemble de votre ordinateur en définissant cette valeur DWORD dans l’Éditeur du Registre : `HKCU\SOFTWARE\Microsoft\Avalon.Graphics\DisableHWAcceleration : 1`
* Velogic Studio dispose d’un réglage 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 réglage soit désactivé (car il force votre CPU à effectuer un travail qui devrait être effectué par le GPU), mais l’activer contournera le problème du pilote.

## Crashes aléatoires occasionnels

Velogic Studio est une application très stable, mais si vous rencontrez 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 présentent des bugs, 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](/files/5e7aecb0b8f691f3733f9cb9e321e507b316ec02)

### Indiquer à 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 bloque Velogic Studio sans qu’aucun rapport d’erreur ne soit envoyé.

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

* 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](/files/6d74b826afaf65f7873311116e476684ccb74deb)

* Cliquez sur « Ajouter ou supprimer des exclusions »

![Page des paramètres de protection contre les virus avec l’option Ajouter ou supprimer des exclusions](/files/562dad5b0f0068128ceb88bcca2beb0670f4bbfd)

* 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](/files/0a36609dd7f67c8b2082ea3b5944638773c96e63)

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

### Vérifier si d’autres applications utilisent 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 de ce type d’application est le logiciel de gestion EBike.

Vous pouvez vérifier la présence de LibUSB en regardant dans le Gestionnaire de pilotes.

![Gestionnaire de périphériques affichant les pilotes LibUSB dans la liste des périphériques système](/files/8340a34e079c64f8a64250c88cc1399886afcd2f)

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 »)

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

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

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

![Résultats de recherche du menu Démarrer de Windows affichant l’application Observateur d’événements](/files/c4c67b56e30a2a6e9a34954e4b6b217b457d999f)

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

![Observateur d’événements avec les sections Journaux Windows et Application mises en évidence](/files/558672d2fb2eb422dbbd8b76926f095f3f5881d5)

* 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](/files/03a0942a5b97660f20a2c0fbcb2a77844fbce0f4)

* Dans la fenêtre contextuelle de filtre, définissez les options suivantes : 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 les paramètres Erreur et .NET Runtime configurés](/files/02f5aaba5c6dbf038115a02e462a5ac5e9cf83df)

* 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é](/files/4b772e1a0ec2a2fc1e177204fc2a439297b58afe)

* 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 exemple sur le bureau

![Boîte de dialogue Enregistrer sous pour exporter le fichier journal d’événements filtré sur le bureau](/files/04a060508a0671d9087804bea0f46277f971a615)

* 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 façon inattendue (plante), il devrait écrire un fichier de vidage dans un répertoire de votre ordinateur, puis redémarrer.

Lorsqu’il redémarrera, 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](/files/ed775fd7c86afd9266b6ae5b80a02df04c13484c)

Ces fichiers de vidage sont très utiles pour nous aider à diagnostiquer, puis à corriger, le problème qui a provoqué le plantage. Si vous voyez ce message et que votre connexion Internet est correcte, veuillez cliquer sur le bouton « Téléverser ». Velogic Studio comprendra le ou les fichiers de vidage dans une archive zip et les enverra à 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 ». Vous pouvez aussi 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 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 procéder :

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

![Gestionnaire des tâches affichant le processus Velogic Studio avec vue développée des sous-processus](/files/32fa511c35e566e314068f3c16366255ffd81f88)

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

![Menu contextuel du processus affichant l’option Créer un fichier de vidage](/files/b455412529804de0cba3fceaa9c1d05594b46b31)

* 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](/files/bedeb0da2c516a26406432c2ded19513e3c022b3)

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

  ![Boîte de dialogue indiquant que la création du fichier de vidage est terminée et montrant l’emplacement du chemin du fichier](/files/66d2735c226cb62459d03cfd0ecd8786bcd341ba)
* Dans votre navigateur web, visitez <https://vlgc.io/upload> , puis 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](/files/481ff7014d04ceafe60cf41031a6463e276a7f4c)

* Accédez au chemin de l’étape précédente (par ex. c:\Users\<yourname>\AppData\Local\temp\Velogic.Studio.App.DMP). Pour faciliter la saisie, vous pouvez entrer ceci dans la zone Nom du fichier : `%localappdata%\temp\Velogic.Studio.App.DMP`
* Entrez 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](/files/645688e3dc8089e921806ff1108c426168ff1240)

* Le téléversement prendra quelques minutes selon votre connexion Internet. Le fichier de vidage fera probablement environ 1 Go ; si votre connexion Internet est coûteuse, veuillez nous contacter pour vérifier que c’est bien 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 sont saccadées

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

### Essayez de débrancher la webcam

Des utilisateurs nous ont signalé que certaines webcams consomment beaucoup de CPU elles-mêmes, laissant trop peu de ressources aux applications Velogic pour fonctionner. Essayez de déconnecter votre webcam et, si les performances sont nettement meilleures, 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 faites un clic droit et choisissez « Propriétés ». Laissez-le ouvert pendant que vous effectuez certaines actions dans Velogic Studio, puis examinez les graphiques.

![Graphiques de performances de Process Explorer montrant l’utilisation du CPU, la mémoire et les statistiques d’E/S](/files/30647534efca0f5b677fd80b895a6a93e4616172)

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 forcément mauvaise, sauf si les performances globales de l’application ne vous satisfont pas)
* « Private Bytes » - il s’agit de l’utilisation de la mémoire, qui devrait rester assez constante, autour de 500 à 700 Mo. Si elle augmente de façon continue et rapide, vous faites peut-être face à 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 \[Shift]-\[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 l’encodage des vidéos.

Nous serons heureux de vous aider à diagnostiquer tout problème de performance que vous rencontrez avec notre logiciel. Veuillez nous contacter avec autant d’informations que possible — idéalement avec une capture d’écran de Process Explorer.

### Envoyer des données de performance pour notre analyse

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-prise-en-main/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 des problèmes. Si nous vous demandons cela :

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

  ![Recherche dans le menu Démarrer de Windows montrant l’application Informations système](/files/e734584ec9819a15af8842e10bd6a8cb26583cd6)
*
* Cliquez sur Fichier -> Exporter, enregistrez le fichier quelque part (par exemple sur votre bureau), puis envoyez-nous le fichier par e-mail — <support@velogicfit.com>
