Documentation produit
Agent de livraison virtuel Linux 2411
Current Release 2402 LTSR 2311 2308 2305 2303 2301 2212 2210 2209 2207 2206 2204 2203 LTSR 1912 LTSR 7.15 LTSR
Voir PDF

Configuration et réglage précis des graphiques

April 10, 2026
Contributeur: 
C C

Cet article décrit la configuration et le réglage précis des graphiques du VDA Linux.

Pour plus d’informations, consultez les sections Configuration système requise et Présentation de l’installation.

Configuration

Optimiser pour les charges de travail graphiques 3D

  • Ce paramètre configure les valeurs par défaut appropriées qui conviennent le mieux aux charges de travail gourmandes en ressources graphiques. Activez ce paramètre pour les utilisateurs dont la charge de travail est axée sur les applications gourmandes en ressources graphiques. Appliquez cette stratégie uniquement dans les cas où un GPU est disponible pour la session. Tout autre paramètre qui remplace explicitement les paramètres par défaut définis par cette stratégie a la priorité.

  • Par défaut, l’option Optimiser pour les charges de travail graphiques 3D est désactivée.

Codec vidéo pour la compression

  • Thinwire est la technologie d’affichage à distance utilisée dans le VDA Linux. Cette technologie permet de transmettre les graphiques générés sur une machine, généralement via un réseau, à une autre machine pour affichage.

La stratégie graphique Utiliser le codec vidéo pour la compression définit le mode graphique par défaut et offre les options suivantes pour différents cas d’utilisation :

  • Utiliser si préféré. Ce paramètre est celui par défaut. Aucune configuration supplémentaire n’est requise. Il garantit que Thinwire est sélectionné pour toutes les connexions Citrix® et optimisé pour l’évolutivité, la bande passante et une qualité d’image supérieure pour les charges de travail de bureau typiques.
  • Pour tout l’écran. Fournit Thinwire avec H.264 ou H.265 plein écran pour optimiser l’expérience utilisateur et la bande passante, en particulier dans les cas d’utilisation intensive de graphiques 3D. Le filigrane de session est pris en charge lorsque l’option Pour tout l’écran est sélectionnée, ou lorsque l’option Utiliser si préféré est sélectionnée et que l’option Optimiser pour les charges de travail graphiques 3D est activée.

  • Pour les régions en évolution active. La technologie d’affichage adaptatif de Thinwire identifie les images en mouvement (vidéo, 3D en mouvement). Elle utilise AV1, H.265 ou H.264 uniquement dans la partie de l’écran où l’image est en mouvement. L’utilisation sélective du codec vidéo AV1, H.265 ou H.264 permet à HDX Thinwire de détecter et d’encoder les parties de l’écran qui sont fréquemment mises à jour. La compression d’images fixes (JPEG, RLE) et la mise en cache bitmap continuent d’être utilisées pour le reste de l’écran, y compris le texte et les images photographiques. Les utilisateurs bénéficient d’une consommation de bande passante réduite et d’une meilleure qualité pour le contenu vidéo, combinées à un texte sans perte ou à des images de haute qualité ailleurs. L’utilisation sélective d’AV1 et de H.265 n’est pas prise en charge lorsque la stratégie Qualité visuelle est définie sur Toujours sans perte ou Construire sans perte.

    Sélection de l'option Pour tout l'écran

Certains autres paramètres de stratégie, y compris les paramètres de stratégie d’affichage visuel suivants, peuvent être utilisés pour affiner les performances de l’affichage à distance :

  • Profondeur de couleur préférée pour les graphiques simples
  • Fréquence d’images cible

  • Qualité visuelle

  • Encodage matériel AV1/H.265/H.264

  • La stratégie Utiliser l’encodage matériel pour le codec vidéo permet d’utiliser l’accélération matérielle GPU, si disponible, pour compresser les éléments d’écran avec le codec vidéo. L’accélération matérielle GPU optimise l’utilisation des ressources matérielles et améliore considérablement les performances en termes d’images par seconde (FPS).

  • Utiliser si préféré
  • Pour tout l’écran

    • Pour les régions en évolution active

    • Pour activer la compression vidéo matérielle, suivez les étapes suivantes :

  1. Définissez la stratégie Utiliser l’encodage matériel pour le codec vidéo sur Activé.

  2. Définissez Utiliser le codec vidéo pour la compression sur Utiliser si préféré, Pour tout l’écran ou Pour les régions en évolution active. Assurez-vous qu’il n’est pas défini sur Ne pas utiliser le codec vidéo.

    • Pour être utilisable, le codec vidéo AV1 ou H.265 doit être pris en charge et activé à la fois sur le VDA et sur l’application Citrix Workspace. AV1 est préféré à H.265 et H.264 lors de la négociation du codec. Lorsque AV1 n’est pas pris en charge, H.265 est négocié. Si AV1 et H.265 ne sont pas pris en charge, les sessions reviennent à l’utilisation du codec vidéo H.264. Si le matériel GPU n’est pas disponible, le VDA revient à l’encodage basé sur le CPU à l’aide du codec vidéo logiciel.

Exigences pour l’encodage matériel AV1

VDA
Client
  • Application Citrix Workspace™ 2305 pour Windows ou version ultérieure
  • GPU client prenant en charge le décodage AV1 :
    • NVIDIA Ampere ou version ultérieure
    • Intel 11e génération / Arc ou version ultérieure
    • AMD Radeon RX 6000 / Radeon Pro W6000 series (RDNA2) ou version ultérieure

Exigences pour l’encodage matériel H.265

Client 
-  Citrix Receiver pour Windows 4.10 à 4.12

  • Application Citrix Workspace 1808 pour Windows et versions ultérieures

Compression sans perte H.265/H.264

La compression sans perte H.265/H.264 est disponible pour l’accélération matérielle HDX 3D PRO par les GPU NVIDIA. La compression sans perte H.265 nécessite l’application Citrix Workspace 2305 pour Windows et versions ultérieures. La compression sans perte H.264 nécessite les clients suivants :

  • Application Citrix Workspace 2303 pour Windows et versions ultérieures
  • Application Citrix Workspace 2301 pour Mac et versions ultérieures avec la puce Apple M1

Pour activer la compression sans perte H.265/H.264, suivez les étapes suivantes :

  1. Définissez la stratégie Utiliser l’encodage matériel pour le codec vidéo sur Activé.

  2. Définissez la stratégie Utiliser le codec vidéo pour la compression sur Pour tout l’écran.

  3. Définissez la stratégie Qualité visuelle sur Toujours sans perte ou Construire sans perte.

Autoriser la compression visuellement sans perte

La stratégie Autoriser la compression visuellement sans perte permet d’utiliser une compression visuellement sans perte au lieu d’une véritable compression sans perte pour les graphiques. La compression visuellement sans perte améliore les performances par rapport à la véritable compression sans perte, mais présente une perte mineure qui est imperceptible à l’œil. Ce paramètre modifie la façon dont les valeurs du paramètre Qualité visuelle sont utilisées.

La stratégie Autoriser la compression visuellement sans perte est désactivée par défaut. Pour activer la compression visuellement sans perte, définissez Autoriser la compression visuellement sans perte sur Activé et la stratégie Qualité visuelle sur Construire sans perte.

Si la stratégie Utiliser le codec vidéo pour la compression est définie sur Ne pas utiliser le codec vidéo, la compression visuellement sans perte s’applique à l’encodage d’images statiques. Si la stratégie Utiliser le codec vidéo pour la compression est définie sur un mode graphique autre que Ne pas utiliser le codec vidéo, la compression visuellement sans perte s’applique à l’encodage H.264.

Pour plus d’informations sur les paramètres de stratégie Qualité visuelle et Utiliser le codec vidéo pour la compression, consultez Paramètres de stratégie d’affichage visuel et Paramètres de stratégie graphique.

Curseur de qualité graphique

Nous avons inclus un curseur de qualité graphique dans l’outil d’indicateur d’état graphique qui s’exécute dans vos sessions Linux virtuelles. Le curseur permet de trouver le juste équilibre entre la qualité d’image et l’interactivité.

Pour utiliser le curseur, suivez les étapes suivantes :

  1. Activez la stratégie Graphic status indicator dans Citrix Studio.

    La stratégie d'indicateur d'état graphique

  2. Ouvrez le Terminal et exécutez la commande ctxslider. L’interface utilisateur du curseur apparaît.

    Remarque :

    • Si vous avez défini la stratégie Qualité visuelle sur Toujours sans perte ou Construire sans perte, l’interface utilisateur du curseur ne s’affiche pas.

    • Vous pouvez lancer l’interface utilisateur du curseur à partir du Terminal et de la zone de notification.

    Curseur de qualité graphique

    Les choix suivants sont désormais disponibles :

    • Pour modifier la qualité de l’image, déplacez le curseur. Le curseur prend en charge une plage de 0 à 9.
    • Pour utiliser les paramètres définis par le système, sélectionnez Laisser le système décider.
    • Pour passer en mode sans perte, sélectionnez Pixel parfait.

Ajuster les débits binaires moyens en fonction des estimations de bande passante

Citrix améliore l’encodage matériel HDX™ 3D Pro en ajustant les débits binaires moyens en fonction des estimations de bande passante.

Lorsque l’encodage matériel HDX 3D Pro est utilisé, le VDA peut estimer par intermittence la bande passante du réseau et ajuster les débits binaires des trames encodées en conséquence. Cette nouvelle fonctionnalité fournit un mécanisme pour équilibrer la netteté et la fluidité.

Cette fonctionnalité est activée par défaut. Pour la désactiver, exécutez la commande suivante :

sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "DisableReconfigureEncoder" -d "0x00000001" --force
<!--NeedCopy-->

En plus d’utiliser cette fonctionnalité, vous pouvez également exécuter les commandes suivantes pour ajuster la netteté et la fluidité. Les paramètres AverageBitRatePercent et MaxBitRatePercent définissent le pourcentage d’utilisation de la bande passante. Plus les valeurs que vous définissez sont élevées, plus les graphiques sont nets et moins la fluidité est bonne. La plage de réglage recommandée est de 50 à 100.

sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "AverageBitRatePercent" -d "90" --force

sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "MaxBitRatePercent" -d "100" --force
<!--NeedCopy-->

Lors de l’ajustement du débit binaire moyen, lorsque votre écran reste immobile, la trame la plus récente reste dans un état de faible qualité car aucune nouvelle trame n’est envoyée. La prise en charge de l’accentuation peut résoudre ce problème en reconfigurant et en envoyant immédiatement la trame la plus récente à la plus haute qualité.

Pour une liste complète des stratégies prises en charge par Thinwire du VDA Linux, consultez Liste de prise en charge des stratégies.

Pour plus d’informations sur la configuration de la prise en charge multi-écrans sur le VDA Linux, consultez CTX220128.

Traitement parallèle

Thinwire peut améliorer le nombre d’images par seconde (FPS) en parallélisant certaines tâches, avec un léger surcoût de consommation globale du CPU. Cette fonctionnalité est désactivée par défaut. Pour activer la fonctionnalité, exécutez la commande suivante sur votre VDA :

sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "ParallelProcessing" -d "0x00000001" --force
<!--NeedCopy-->

Dépannage

Vérifier le mode graphique utilisé

Exécutez la commande suivante pour vérifier le mode graphique utilisé (0 signifie TW+. 1 signifie codec vidéo plein écran) :

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep GraphicsMode
<!--NeedCopy-->

Le résultat ressemble à :

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "GraphicsMode" -d "0x00000000" --force

Vérifier que l’AV1 est utilisé

Remarque :

Pour vérifier quel codec vidéo est utilisé pour la session actuelle, exécutez une commande fournie ci-dessous ou vérifiez l’état graphique via la zone de notification.

Exécutez la commande suivante pour vérifier que l’AV1 est utilisé (0 signifie non utilisé. 1 signifie utilisé) :

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep AV1
<!--NeedCopy-->

Par exemple, le résultat peut ressembler à :

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "AV1" -d "0x00000000" --force

Vérifier que le H.265 est utilisé

Exécutez la commande suivante pour vérifier que le H.265 plein écran est utilisé (0 signifie non utilisé. 1 signifie utilisé) :

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep H265
<!--NeedCopy-->

Par exemple, le résultat peut ressembler à :

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "H265" -d "0x00000000" --force

Vérifier que le H.264 est utilisé

Exécutez la commande suivante pour vérifier que le H.264 est utilisé (0 signifie non utilisé. 1 signifie utilisé) :

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep H264
<!--NeedCopy-->

Par exemple, le résultat peut ressembler à :

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "H264" -d "0x00000000" --force

Vérifier le schéma d’encodage YUV utilisé

Exécutez la commande suivante pour vérifier le schéma d’encodage YUV utilisé (0 signifie YUV420. 1 signifie YUV422. 2 signifie YUV444) :

Remarque :

La valeur de YUVFormat n’est significative que lorsqu’un codec vidéo est utilisé.

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep YUVFormat
<!--NeedCopy-->

Par exemple, le résultat peut ressembler à ceci :

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "YUVFormat" -d "0x00000000" --force

Vérifier que l’encodage logiciel YUV444 est utilisé

Exécutez la commande suivante pour vérifier que l’encodage logiciel YUV444 est utilisé :

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep Graphics
<!--NeedCopy-->

Lorsque YUV444 est utilisé, le résultat ressemble à ceci :

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "GraphicsMode" -d "0x00000001" --force

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "H264" -d "0x00000001" --force

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "HardwareEncoding" -d "0x00000000" --force

create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "YUVFormat" -d "0x00000002" --force

Vérifier que HDX 3D Pro est activé

Exécutez les commandes suivantes pour vérifier que HDX 3D Pro est activé :

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep ProductEdition

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep StackSessionMode

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep 3DPro
<!--NeedCopy-->

Lorsque HDX 3D Pro est activé, le résultat ressemble à ceci :

create -k "HKLM\Software\Citrix\VirtualDesktopAgent\State" -t "REG_SZ" -v "ProductEdition" -d "<PLT or ENT>" --force

create -k "HKLM\System\CurrentControlSet\Control\Citrix\WinStations\tcp" -t "REG_DWORD" -v "StackSessionMode" -d "0x00000000" --force

create -k "HKLM\System\CurrentControlSet\Control\Citrix" -t "REG_DWORD" -v "3DPro" -d "0x00000000" --force

Pour vérifier que les bibliothèques NVIDIA requises sont chargées pour HDX 3D Pro, exécutez la commande nvidia-smi sur le VDA Linux. Le résultat ressemble à ceci :

Tue Apr 12 10:42:03 2016
+------------------------------------------------------+
| NVIDIA-SMI 361.28     Driver Version: 361.28         |
|-------------------------------+----------------------+----------------------+
| GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |
| Fan  Temp  Perf  Pwr:Usage/Cap|         Memory-Usage | GPU-Util  Compute M. |
|===============================+======================+======================|
|   0  GRID K1             Off  | 0000:00:05.0     Off |                  N/A |
| N/A   42C    P0    14W /  31W |    207MiB /  4095MiB |      8%      Default |
+-------------------------------+----------------------+----------------------+

+-----------------------------------------------------------------------------+
| Processes:                                                       GPU Memory |
|  GPU       PID  Type  Process name                               Usage      |
|=============================================================================|
|    0      2164  C+G   /usr/local/bin/ctxgfx                          106MiB |
|    0      2187    G   Xorg                                            85MiB |
+-----------------------------------------------------------------------------+
<!--NeedCopy-->

Vérifier que l’encodage matériel est utilisé pour 3D Pro

Exécutez la commande suivante (0 signifie non utilisé. 1 signifie utilisé) :

sudo /opt/Citrix/VDA/bin/ctxreg dump | grep HardwareEncoding
<!--NeedCopy-->

Lorsque 3D Pro est utilisé, le résultat ressemble à ceci :

create -k "HKLM\Software\Citrix\Ica\Session\1\Graphics" -t "REG_DWORD" -v "HardwareEncoding" -d "0x00000001" --force

Vérifier que le pilote graphique NVIDIA GRID est correctement installé

Pour vérifier que le pilote graphique NVIDIA GRID est correctement installé, exécutez nvidia-smi. Le résultat ressemble à ceci :

+------------------------------------------------------+
| NVIDIA-SMI 352.70     Driver Version: 352.70         |
|-------------------------------+----------------------+----------------------+
| GPU  Name        Persistence-M| Bus-Id        Disp.A | Volatile Uncorr. ECC |
| Fan  Temp  Perf  Pwr:Usage/Cap|         Memory-Usage | GPU-Util  Compute M. |
|===============================+======================+======================|
|   0  Tesla M60           Off  | 0000:00:05.0     Off |                  Off |
| N/A   20C    P0    37W / 150W |     19MiB /  8191MiB |      0%      Default |
+-------------------------------+----------------------+----------------------+

+-----------------------------------------------------------------------------+
| Processes:                                                       GPU Memory |
|  GPU       PID  Type  Process name                               Usage      |
|=============================================================================|
|  No running processes found                                                 |
+-----------------------------------------------------------------------------+
<!--NeedCopy-->

Définissez la configuration correcte pour la carte :

etc/X11/ctx-nvidia.sh

Problèmes de redessin multi-écrans HDX 3D Pro

Si vous rencontrez des problèmes de redessin sur des écrans autres que l’écran principal, vérifiez que la licence NVIDIA GRID est disponible.

Vérifier les journaux d’erreurs Xorg

Le fichier journal de Xorg est nommé de manière similaire à Xorg.{DISPLAY}.log dans le dossier /var/log/.

Problèmes connus et limitations

Pour le vGPU, la console locale XenServer (anciennement Citrix Hypervisor™) affiche l’écran de session de bureau ICA

Solution de contournement : Désactivez la console VGA locale de la machine virtuelle en exécutant la commande suivante :

[root@xenserver® ~]# xe vgpu-param-set uuid=vgpu-uuid extra_args=disable_vnc=1
<!--NeedCopy-->

Les fenêtres contextuelles du bureau Gnome 3 sont lentes lors de la connexion

Il s’agit d’une limitation du démarrage de la session de bureau Gnome 3.

Certaines applications OpenGL/WebGL ne s’affichent pas correctement lors du redimensionnement de la fenêtre de l’application Citrix Workspace

Le redimensionnement de la fenêtre de l’application Citrix Workspace modifie la résolution de l’écran. Le pilote propriétaire NVIDIA modifie certains états internes et peut exiger que les applications y répondent en conséquence. Par exemple, l’élément de bibliothèque WebGL lightgl.js peut générer une erreur indiquant que Rendering to this texture is not supported (incomplete frame buffer).

Configuration et réglage précis des graphiques
April 10, 2026
Contributeur: 
C C
April 10, 2026
Contributeur: 
C C

Dans cet article

Commentaires sur le site | Your privacy choices footer linkVos préférences de confidentialité | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.