グラフィックの構成と微調整

最終公開日 : Nov 13, 2026
この記事では、Linux VDA のグラフィック構成と微調整について説明します。
詳細については、「システム要件」および「インストール概要」セクションを参照してください。
Related information
グラフィックス

構成

3Dグラフィックワークロード向けに最適化

この設定は、グラフィックを多用するワークロードに最適なデフォルト値を構成します。グラフィックを多用するアプリケーションに重点を置くユーザーに対して、この設定を有効にします。このポリシーは、セッションで GPU が利用可能な場合にのみ適用してください。このポリシーによって設定されたデフォルト設定を明示的に上書きする他の設定は、すべて優先されます。
デフォルトでは、3Dグラフィックワークロード向けに最適化は無効になっています。

圧縮用ビデオコーデック

Thinwire は、Linux VDA で使用されるディスプレイリモート処理テクノロジーです。このテクノロジーにより、あるマシンで生成されたグラフィックを、通常はネットワーク経由で別のマシンに送信して表示できます。
圧縮にビデオコーデックを使用 グラフィックポリシーは、デフォルトのグラフィックモードを設定し、さまざまなユースケースに対して以下のオプションを提供します。
  • 優先する場合に適用。この設定はデフォルトです。追加の構成は必要ありません。これにより、すべてのCitrix®接続でThinwireが選択され、スケーラビリティ、帯域幅、および一般的なデスクトップワークロードの優れた画質のために最適化されます。
  • 画面全体。フルスクリーンH.264またはH.265でThinwireを提供し、特に3Dグラフィックを多用する場合に、ユーザーエクスペリエンスと帯域幅の向上を最適化します。画面全体が選択されている場合、または優先する場合に適用が選択され、3Dグラフィックワークロード向けに最適化が有効になっている場合に、セッションウォーターマークがサポートされます。
  • アクティブに変化する領域。Thinwire の適応型ディスプレイテクノロジーは、動く画像（ビデオ、モーション内の3D）を識別します。画像が動いている画面の一部でのみ、AV1、H.265、またはH.264を使用します。AV1、H.265、またはH.264ビデオコーデックを選択的に使用することで、HDX Thinwire は頻繁に更新される画面の一部を検出し、エンコードできます。静止画圧縮（JPEG、RLE）とビットマップキャッシュは、テキストや写真画像を含む画面の残りの部分で引き続き使用されます。ユーザーは、ビデオコンテンツの帯域幅消費量の削減と品質の向上、およびロスレステキストまたは高品質の画像を他の場所で組み合わせるという利点を得られます。視覚品質ポリシーが常にロスレスまたはロスレスに構築に設定されている場合、AV1およびH.265の選択的な使用はサポートされません。
    画面全体が選択されている様子
以下の視覚ディスプレイポリシー設定を含む、その他のポリシー設定を使用して、ディスプレイリモート処理のパフォーマンスを微調整できます。

AV1/H.265/H.264 ハードウェアエンコーディング

ビデオコーデックのハードウェアエンコーディングを使用ポリシーは、利用可能な場合、GPUハードウェアアクセラレーションを使用して、ビデオコーデックで画面要素を圧縮することを可能にします。GPUハードウェアアクセラレーションは、ハードウェアリソースの利用を最適化し、1秒あたりのフレーム数 (FPS) のパフォーマンスを大幅に向上させます。
GPUハードウェアアクセラレーションは、圧縮にビデオコーデックを使用ポリシーによって設定されたすべてのグラフィックモードをカバーします。
  • 優先する場合に使用
  • 画面全体
  • アクティブに変更される領域
ハードウェアビデオ圧縮を有効にするには、次の手順を実行します。
  1. ビデオコーデックのハードウェアエンコーディングを使用ポリシーを有効に設定します。
  2. 圧縮にビデオコーデックを使用を優先する場合に使用、画面全体、またはアクティブに変更される領域に設定します。ビデオコーデックを使用しないに設定されていないことを確認してください。
使用可能にするには、AV1またはH.265ビデオコーデックがVDAとCitrix Workspaceアプリの両方でサポートされ、有効になっている必要があります。コーデックネゴシエーション中、AV1はH.265およびH.264よりも優先されます。AV1がサポートされていない場合、H.265がネゴシエートされます。AV1とH.265の両方がサポートされていない場合、セッションはH.264ビデオコーデックの使用にフォールバックします。GPUハードウェアが利用できない場合、VDAはソフトウェアビデオコーデックを使用したCPUベースのエンコーディングにフォールバックします。

AV1ハードウェアエンコーディングの要件

VDA
  • VDA: 2311以降
  • GPU: NVIDIA Ada Lovelace以降 (NVIDIA GPUがサポートするビデオコーデックの対応表については、<https://developer.nvidia.com/video-encode-and-decode-gpu-support-matrix-new>のNVIDIAドキュメントを参照してください。)
  • NVIDIAグラフィックドライバー 522.25以降 (Video Codec SDK v12.0)
クライアント
  • Citrix Workspace™ アプリ 2305 for Windows 以降
  • AV1 デコードをサポートするクライアント GPU:
    • NVIDIA Ampere 以降
    • Intel 第11世代 / Arc 以降
    • AMD Radeon RX 6000 / Radeon Pro W6000 シリーズ (RDNA2) 以降

H.265 ハードウェアエンコードの要件

クライアント
  • Windows向け Citrix Receiver 4.10 から 4.12 まで
  • Windows向けCitrix Workspaceアプリ1808以降
クライアントで H.265 ハードウェアエンコードを有効にするには、「H.265 ビデオエンコード」を参照してください。

H.265/H.264 ロスレス圧縮

H.265/H.264 ロスレス圧縮は、NVIDIA GPU による HDX 3D PRO ハードウェアアクセラレーションで利用できます。H.265 ロスレス圧縮には、Citrix Workspace アプリ 2305 for Windows 以降が必要です。H.264 ロスレス圧縮には、以下のクライアントが必要です。
  • Citrix Workspace アプリ 2303 for Windows 以降
  • Apple M1 チップを搭載した Citrix Workspace アプリ 2301 for Mac 以降
H.265/H.264 ロスレス圧縮を有効にするには、次の手順を実行します。
  1. 「ビデオコーデックにハードウェアエンコードを使用」ポリシーを「有効」に設定します。
  2. 「圧縮にビデオコーデックを使用」ポリシーを「画面全体」に設定します。
  3. 「視覚的品質」ポリシーを「常に損失」または「ロスレスに構築」に設定します。

視覚的にロスレスな圧縮を許可する

「視覚的にロスレスな圧縮を許可」ポリシーにより、グラフィックで真のロスレス圧縮の代わりに「視覚的に」ロスレスな圧縮を使用できます。視覚的にロスレスな圧縮は、真のロスレス圧縮よりもパフォーマンスを向上させますが、目視では気づかない程度のわずかな損失があります。この設定は、「視覚的品質」設定の値の使用方法を変更します。
「視覚的にロスレスな圧縮を許可」ポリシーは、デフォルトで無効になっています。「視覚的に」ロスレスな圧縮を有効にするには、「視覚的にロスレスな圧縮を許可」を「有効」に設定し、「視覚的品質」ポリシーを「ロスレスに構築」に設定します。
「圧縮にビデオコーデックを使用」ポリシーが「ビデオコーデックを使用しない」に設定されている場合、「視覚的に」ロスレスな圧縮は、静止画エンコードに適用されます。「圧縮にビデオコーデックを使用」ポリシーが「ビデオコーデックを使用しない」以外のグラフィックモードに設定されている場合、「視覚的に」ロスレスな圧縮は、H.264エンコードに適用されます。
「視覚的品質」および「圧縮にビデオコーデックを使用」ポリシー設定の詳細については、視覚表示ポリシー設定およびグラフィックポリシー設定を参照してください。

グラフィック品質スライダー

仮想Linuxセッションで実行されるグラフィックステータスインジケーターツールに、グラフィック品質スライダーを含めました。このスライダーは、画質と対話性の適切なバランスを見つけるのに役立ちます。
スライダーを使用するには、次の手順を実行します。
  1. Citrix Studioで「グラフィックステータスインジケーター」ポリシーを有効にします。
    グラフィックステータスインジケーターポリシー
  2. ターミナルを開き、ctxsliderコマンドを実行します。スライダーUIが表示されます。
    注:
    • 「視覚的品質」ポリシーを「常にロスレス」または「ロスレスに構築」に設定している場合、スライダーUIは表示されません。
    • スライダーUIは、ターミナルとシステムトレイの両方から起動できます。
    グラフィック品質スライダー
    次の選択肢が利用可能です。
    • 画像品質を変更するには、スライダーを動かします。スライダーは0～9の範囲をサポートしています。
    • システム定義の設定を使用するには、システムに決定させるを選択します。
    • ロスレスモードに切り替えるには、ピクセルパーフェクトを選択します。

帯域幅の見積もりに基づいて平均ビットレートを調整する

Citrixは、帯域幅の見積もりに基づいて平均ビットレートを調整することにより、HDX™ 3D Proハードウェアエンコーディングを強化します。
HDX 3D Proハードウェアエンコーディングが使用されている場合、VDAはネットワークの帯域幅を断続的に推定し、それに応じてエンコードされたフレームのビットレートを調整できます。この新機能は、シャープネスと流暢さのバランスを取るメカニズムを提供します。
この機能はデフォルトで有効になっています。無効にするには、次のコマンドを実行します。
sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "DisableReconfigureEncoder" -d "0x00000001" --force
この機能を使用するだけでなく、次のコマンドを実行してシャープネスと流暢さのバランスを調整することもできます。AverageBitRatePercentとMaxBitRatePercentパラメーターは、帯域幅使用率のパーセンテージを設定します。設定値が高いほど、グラフィックはシャープになりますが、流暢さは低下します。推奨される設定範囲は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
平均ビットレート調整では、画面が静止している場合、新しいフレームが送信されないため、最新のフレームは低品質の状態のままになります。シャープ化サポートは、最新のフレームを最高品質で再構成してすぐに送信することで、この問題に対処できます。
Linux VDA Thinwireでサポートされているポリシーの完全なリストについては、ポリシーサポートリストを参照してください。
Linux VDAでのマルチモニターサポートの構成については、CTX220128を参照してください。

並列処理

Thinwireは、特定のタスクを並列化することで、1秒あたりのフレーム数（FPS）を向上させることができますが、全体的なCPU消費量がわずかに増加するというオーバーヘッドがあります。この機能はデフォルトで無効になっています。この機能を有効にするには、VDAで次のコマンドを実行します。
sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\System\CurrentControlSet\Control\Citrix\Thinwire" -t "REG_DWORD" -v "ParallelProcessing" -d "0x00000001" --force

トラブルシューティング

使用中のグラフィックモードを確認する

使用中のグラフィックモードを確認するには、次のコマンドを実行します（0はTW+、1は全画面ビデオコーデックを意味します）。
sudo /opt/Citrix/VDA/bin/ctxreg dump | grep GraphicsMode
結果は次のようになります。
create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "GraphicsMode" -d "0x00000000" --force

AV1が使用されていることを確認する

注:
現在のセッションでどのビデオコーデックが使用されているかを確認するには、以下のコマンドを実行するか、(/ja-jp/linux-virtual-delivery-agent/2311/configure/graphics/system-tray.html)からグラフィックステータスを確認します。
AV1が使用されていることを確認するには、次のコマンドを実行します（0は使用されていないことを意味します。1は使用されていることを意味します）。
sudo /opt/Citrix/VDA/bin/ctxreg dump | grep AV1
たとえば、結果は次のようになります。
create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "AV1" -d "0x00000000" --force

H.265が使用されていることを確認する

全画面H.265が使用されていることを確認するには、次のコマンドを実行します（0は使用されていないことを意味します。1は使用されていることを意味します）。
sudo /opt/Citrix/VDA/bin/ctxreg dump | grep H265
たとえば、結果は次のようになります。
create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "H265" -d "0x00000000" --force

H.264が使用されていることを確認する

H.264が使用されていることを確認するには、次のコマンドを実行します（0は使用されていないことを意味します。1は使用されていることを意味します）。
sudo /opt/Citrix/VDA/bin/ctxreg dump | grep H264
たとえば、結果は次のようになります。
create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "H264" -d "0x00000000" --force

どのYUVエンコーディングスキームが使用されているかを確認する

どのYUVエンコーディングスキームが使用されているかを確認するには、次のコマンドを実行します（0はYUV420を意味します。1はYUV422を意味します。2はYUV444を意味します）。
注:
YUVFormatの値は、ビデオコーデックが使用されている場合にのみ意味があります。
sudo /opt/Citrix/VDA/bin/ctxreg dump | grep YUVFormat
たとえば、結果は次のようになります。
create -k "HKLM\Software\Citrix\Ica\Session\4\Graphics" -t "REG_DWORD" -v "YUVFormat" -d "0x00000000" --force

YUV444ソフトウェアエンコーディングが使用されていることを確認します

次のコマンドを実行して、YUV444ソフトウェアエンコーディングが使用されていることを確認します。
sudo /opt/Citrix/VDA/bin/ctxreg dump | grep Graphics
YUV444が使用されている場合、結果は次のようになります。
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

HDX 3D Proが有効になっていることを確認します

次のコマンドを実行して、HDX 3D Proが有効になっていることを確認します。
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
HDX 3D Proが有効になっている場合、結果は次のようになります。
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
HDX 3D Proに必要なNVIDIAライブラリがロードされていることを確認するには、Linux VDAでnvidia-smiコマンドを実行します。結果は次のようになります。
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 |
+-----------------------------------------------------------------------------+

3D Proでハードウェアエンコーディングが使用されていることを確認します

次のコマンドを実行します (0は使用されていないことを意味します。1は使用中であることを意味します):
sudo /opt/Citrix/VDA/bin/ctxreg dump | grep HardwareEncoding
3D Proが使用されている場合、結果は次のようになります。
create -k "HKLM\Software\Citrix\Ica\Session\1\Graphics" -t "REG_DWORD" -v "HardwareEncoding" -d "0x00000001" --force

NVIDIA GRIDグラフィックドライバーが正しくインストールされていることを確認します

NVIDIA GRIDグラフィックドライバーが正しくインストールされていることを確認するには、nvidia-smiを実行します。結果は次のようになります。
+------------------------------------------------------+
| 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                                                 |
+-----------------------------------------------------------------------------+
カードの正しい構成を設定します:
etc/X11/ctx-nvidia.sh

HDX 3D Proマルチモニターの再描画に関する問題

プライマリモニター以外の画面で再描画に関する問題が発生している場合は、NVIDIA GRIDライセンスが利用可能であることを確認してください。

Xorgエラーログを確認する

Xorgのログファイルは、/var/log/ フォルダーに Xorg.{DISPLAY}.log のような名前で保存されています。

既知の問題と制限事項

vGPU の場合、XenServer (旧称 Citrix Hypervisor™) のローカルコンソールにICAデスクトップセッション画面が表示されます

回避策: 次のコマンドを実行して、VMのローカルVGAコンソールを無効にします。
[root@xenserver® ~]# xe vgpu-param-set uuid=vgpu-uuid extra_args=disable_vnc=1

Gnome 3デスクトップのポップアップがログオン時に遅い

これはGnome 3デスクトップセッションの起動における制限事項です。

Citrix Workspaceアプリのウィンドウのサイズ変更時に、一部のOpenGL/WebGLアプリケーションがうまくレンダリングされないことがあります

Citrix Workspaceアプリのウィンドウサイズを変更すると、画面解像度が変更されます。NVIDIA独自のドライバーは一部の内部状態を変更し、アプリケーションがそれに応じて応答する必要がある場合があります。たとえば、WebGLライブラリ要素 lightgl.js は、このテクスチャへのレンダリングはサポートされていません (不完全なフレームバッファー) というエラーを発生させる可能性があります。