Dépannage

Cette page présente les problèmes courants rencontrés lors de l’utilisation de Gaphor ainsi que leurs solutions.

Interface utilisateur invisible sous Windows 10 (processeur Intel + carte graphique NVIDIA)

Problème :

Certains utilisateurs de Windows 10 équipés d’une carte graphique intégrée Intel (en particulier les anciens modèles tels que les séries Intel HD 4000 / 4600) — souvent sur des systèmes équipés également d’une carte graphique NVIDIA — peuvent rencontrer un problème d”interface utilisateur invisible lors du lancement de Gaphor. La fenêtre s’affiche et les éléments de l’interface (boutons, menus) sont cliquables, mais rien n’est visible.

Ce problème est suivi en amont dans GTK : 👉 GNOME/gtk#7283

Exemples :

Sur les images ci-dessous, la fenêtre Gaphor est ouverte, mais l’interface utilisateur n’est pas visible.

Exemple 1 d'interface utilisateur invisible

Exemple 2 d'interface utilisateur invisible

Solution : Définissez la variable d’environnement GSK_RENDERER=gl

Pour résoudre ce problème, vous pouvez forcer GTK à utiliser le moteur de rendu basé sur OpenGL en définissant la variable d’environnement GSK_RENDERER=gl.

Option 1️⃣ : Mettre à jour le raccourci Gaphor

  1. Cliquez avec le bouton droit de la souris sur le raccourci Gaphor (sur le Bureau ou dans le menu Démarrer) et sélectionnez Propriétés.

  2. Dans l’onglet Raccourci, repérez le champ Cible.

  3. Remplacez la cible actuelle par la commande PowerShell suivante :

    powershell -Command "$env:GSK_RENDERER='gl'; Start-Process 'C:\Program Files\Gaphor\gaphor.exe'"

    Remarque : modifiez le chemin d’accès si votre installation de Gaphor se trouve dans un autre dossier.

  4. Cliquez sur Appliquer, puis sur OK.

✅ Désormais, chaque fois que vous lancerez Gaphor via ce raccourci, la correction s’appliquera automatiquement.

Option 2️⃣ : Définir une variable d’environnement permanente

  1. Appuyez sur Win + S et recherchez Variables d’environnement.

  2. Sélectionnez « Modifier les variables d’environnement système » → Variables d’environnement.

  3. Dans la section Variables utilisateur, cliquez sur Nouveau :

    • Nom de la variable : GSK_RENDERER

    • Valeur de la variable : gl

  4. Enregistrez et redémarrez votre ordinateur.

✅ Cela permettra d’appliquer la correction à l’ensemble de Gaphor (et de toutes les autres applications basées sur GTK).

Systèmes concernés

  • Windows 10

  • Intel HD 4000 / 4600 series graphics (or similaire)

  • Souvent associé à des configurations avec des GPU NVIDIA

Merci à la communauté Gaphor et à ses contributeurs d’avoir identifié et confirmé cette solution de contournement !