Dépannage

Si vous rencontrez un problème avec OpenShot, comme un gel, un plantage ou un message d’erreur, plusieurs techniques peuvent être utiles pour résoudre le problème.

Windows 11 ne répond pas

Si vous subissez un gel sous Windows 11, c’est un problème connu lié à PyQt5 et Windows 11, concernant les fonctionnalités d’accessibilité de Qt. Cela se produit en appuyant sur Ctrl+C dans OpenShot (uniquement sous Windows 11). OpenShot devient alors non réactif et une fuite mémoire est également présente (c’est-à-dire que plus OpenShot reste non réactif, plus la fuite mémoire s’aggrave jusqu’à ce qu’OpenShot plante ou que l’utilisateur termine le processus).

Une solution simple consiste à éviter Ctrl+C sous Windows 11, et à utiliser à la place les menus Copier/Coller du clic droit. Une autre solution est de remapper la commande « Copier » de Ctrl+C vers une autre combinaison, par exemple Alt+C. Vous pouvez modifier vos raccourcis clavier dans les Préférences d’OpenShot. Voir Clavier.

Débogage sous Windows avec GDB

Si vous rencontrez un plantage ou un gel avec OpenShot sous Windows 10/11, les instructions suivantes étape par étape vous aideront à déterminer la cause du plantage. Ces instructions afficheront une trace de la pile du code source d’OpenShot, à l’endroit du plantage. Ces informations sont extrêmement utiles pour notre équipe de développement, et très utiles à joindre aux rapports de bugs (pour une résolution plus rapide).

Installer la dernière version quotidienne

Avant d’attacher un débogueur, veuillez télécharger la dernière version d’OpenShot : https://www.openshot.org/download#daily. Installez cette version d’OpenShot à l’emplacement par défaut : C:\Program Files\OpenShot Video Editor\. Pour des instructions détaillées sur le débogage d’OpenShot sous Windows, veuillez consulter ce wiki.

Installer MSYS2

La version Windows d’OpenShot est compilée avec un environnement appelé MSYS2. Pour attacher le débogueur GDB à notre exécutable, openshot-qt.exe, vous devez d’abord installer MSYS2. Cette étape n’est requise qu’une seule fois.

Téléchargez et installez MSYS2 : http://www.msys2.org/
Lancez l’invite de commandes MSYS2 MinGW x64 (par exemple : C:\msys64\msys2_shell.cmd -mingw64)
Mettez à jour tous les paquets (Copiez/Collez la commande suivante):
```
pacman -Syu
```

Installez le débogueur GDB (Copiez/Collez la commande suivante):

pacman -S --needed --disable-download-timeout mingw-w64-x86_64-toolchain

Lancez OpenShot avec le débogueur GDB

Lancez l’invite de commandes MSYS2 MinGW x64 (par exemple : C:\msys64\msys2_shell.cmd -mingw64)

Mettez à jour le PATH (Copiez/Collez les commandes suivantes):

export PATH="/c/Program Files/OpenShot Video Editor/lib:$PATH"
export PATH="/c/Program Files/OpenShot Video Editor/lib/PyQt5:$PATH"

Chargez OpenShot dans le débogueur GDB (Copiez/Collez les commandes suivantes):

cd "/c/Program Files/OpenShot Video Editor"/
gdb openshot-qt.exe

Lancez OpenShot depuis l’invite GDB (Copiez/Collez la commande suivante):

run --debug

Afficher les informations de débogage

Une fois qu’OpenShot est lancé avec GDB attaché, il vous suffit de provoquer un plantage ou un gel dans OpenShot. Lorsqu’un plantage survient, revenez au terminal MSYS2 MinGW64 et exécutez l’une des commandes suivantes (en la tapant puis en appuyant sur ENTRÉE). En général, la première commande à saisir est bt, qui signifie backtrace. D’autres commandes sont listées ci-dessous.

(gdb) run            (launch openshot-qt.exe)
(gdb) CTRL + C       (to manually break out   OR   wait for a crash / segmentation fault)
(gdb) bt             (Print stack trace for the current thread #)
(gdb) info threads   (to view all threads, and what they are doing. Look for `__lll_lock_wait` for Mutex/deadlocks)
(gdb) thread 35      (Switch to thread number, for example thread 35)

Moniteurs Haute DPI / 4K

OpenShot Video Editor offre un support robuste pour les moniteurs Haute DPI (points par pouce), garantissant que l’interface est nette et facilement lisible sur des écrans avec différents réglages DPI. Ce support est particulièrement utile sur les moniteurs 4K et autres écrans à haute résolution.

Sensibilité DPI par moniteur

OpenShot est conscient du DPI pour chaque moniteur, ce qui signifie qu’il peut ajuster son échelle dynamiquement en fonction des réglages DPI de chaque moniteur connecté. Cela permet d’offrir une expérience cohérente sur différents écrans.

Mise à l’échelle DPI sous Windows

Sous Windows, OpenShot arrondit le facteur d’échelle à la valeur entière la plus proche pour préserver l’intégrité visuelle. Cela aide à éviter les artefacts visuels dans l’interface et maintient les éléments nets et bien alignés. En raison de cet arrondi, certaines options d’échelle peuvent entraîner des polices et éléments d’interface plus grands que prévu.

L’échelle à 125% est arrondie à 100%
L’échelle à 150% est arrondie à 200%

Solutions de contournement pour un réglage précis

Bien que l’arrondi aide à maintenir une interface propre, il existe des solutions de contournement pour les utilisateurs qui nécessitent un contrôle plus précis de l’échelle. Ces méthodes ne sont pas recommandées en raison des artefacts visuels potentiels :

QT_SCALE_FACTOR_ROUNDING_POLICY=PassThrough
- Définir cette variable d’environnement peut désactiver l’arrondi et permettre une mise à l’échelle plus précise.
- Note : Cela peut provoquer des artefacts visuels, notamment dans la timeline, et n’est pas recommandé.
QT_SCALE_FACTOR=1.25 (ou une valeur similaire)
- Définir manuellement le facteur d’échelle peut offrir des ajustements plus fins de la taille des polices et de l’interface.
- Cela peut également être configuré via les Préférences (Échelle de l’interface utilisateur), mais attendez-vous à des problèmes de bordures/lignes sous Windows avec des échelles fractionnaires.
- Note : Cette méthode peut aussi entraîner des artefacts visuels et rendre OpenShot plus difficile à utiliser.

Pour plus d’informations sur l’ajustement de ces variables d’environnement, veuillez visiter https://github.com/OpenShot/openshot-qt/wiki/OpenShot-UI-too-large.