グラフィックの構成

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

構成

Thinwire は、Linux VDA で使用されるディスプレイリモート処理テクノロジーです。このテクノロジーにより、あるマシンで生成されたグラフィックを、通常はネットワーク経由で別のマシンに送信して表示できます。
**圧縮にビデオコーデックを使用**グラフィックポリシーは、デフォルトのグラフィックモードを設定し、さまざまなユースケースに対して以下のオプションを提供します。
  • 優先する場合にのみ使用。この設定はデフォルトです。追加の構成は不要です。この設定を維持することで、すべてのCitrix®接続でThinwireが選択され、一般的なデスクトップワークロードのスケーラビリティ、帯域幅、および優れた画質のために最適化されます。
  • 画面全体。Thinwire をフルスクリーン H.264 または H.265 で配信し、特に 3D グラフィックを多用する場合のユーザーエクスペリエンスと帯域幅の向上を最適化します。
  • アクティブに変更される領域。Thinwire の適応型ディスプレイテクノロジーは、動く画像(ビデオ、移動中の 3D)を識別し、画像が動いている画面の部分でのみ H.264 を使用します。H.264 ビデオコーデックの選択的な使用により、HDX Thinwire は、ビデオコンテンツなど、H.264 ビデオコーデックを使用して頻繁に更新される画面の一部を検出し、エンコードできます。静止画圧縮(JPEG、RLE)とビットマップキャッシュは、テキストや写真画像を含む画面の残りの部分で引き続き使用されます。ユーザーは、ビデオコンテンツの帯域幅の低減と品質の向上に加えて、ロスレステキストまたは他の場所での高品質画像の恩恵を受けます。この機能を有効にするには、ポリシー設定 圧縮にビデオコーデックを使用 を 優先する場合にのみ使用(デフォルト)または アクティブに変更される領域 に変更します。詳細については、グラフィックポリシー設定を参照してください。
画面全体の画像
以下の視覚表示ポリシー設定を含む、その他のポリシー設定を使用して、ディスプレイリモート処理のパフォーマンスを微調整できます。

Thinwire の Build to Lossless に H.264 を使用

デフォルトでは、視覚的品質ポリシー設定のBuild to Losslessの優先設定は、動画の場合、JPEG ではなく H.264 になりました。
H.264エンコーディングは、優れた画質を提供します。Use video codec for compressionポリシーは、その設定を制御し、デフォルトはUse when preferredです。Build to LosslessでJPEGを使用するように強制するには、Use video codec for compressionポリシーをDo not use video codecに設定します。クライアントがSelective H.264をサポートしていない場合、ポリシー設定に関係なく、Build to LosslessはJPEGにフォールバックします。Citrix Receiver for Windows 4.9~4.12、Citrix Receiver for Linux 13.5~13.10、Citrix Workspaceアプリ1808 for Windows以降、およびCitrix Workspaceアプリ1808 for Linux以降は、Selective H.264をサポートしています。Visual qualityおよびUse video codec for compressionポリシー設定について詳しくは、「Visual display policy settings」および「Graphics policy settings」を参照してください。

H.265ビデオコーデックのサポート

7.18リリース以降、Linux VDAはリモートグラフィックとビデオのハードウェアアクセラレーションのためにH.265ビデオコーデックをサポートしています。この機能は、Citrix Receiver for Windows 4.10~4.12、およびCitrix Workspaceアプリ1808 for Windows以降で使用できます。この機能を利用するには、Linux VDAとクライアントの両方で有効にする必要があります。クライアントのGPUがDXVAインターフェイスを使用したH.265デコードをサポートしていない場合、グラフィックポリシー設定のH.265デコードは無視され、セッションはH.264ビデオコーデックの使用にフォールバックします。詳しくは、「H.265 video encoding」を参照してください。
VDAでH.265ハードウェアエンコーディングを有効にするには:
  1. Use hardware encoding for video codecポリシーを有効にします。
  2. Optimize for 3D graphics workloadポリシーを有効にします
  3. Use video codec for compressionポリシーがデフォルトであるか、For the entire screenに設定されていることを確認します。
  4. Visual qualityポリシーがBuild to LosslessまたはAlways Losslessに設定されていないことを確認します。
クライアントでH.265ハードウェアエンコーディングを有効にするには、「H.265 video encoding」を参照してください。

YUV444ソフトウェアエンコーディングのサポート

Linux VDAはYUV444ソフトウェアエンコーディングをサポートしています。YUVエンコーディングスキームは、各ピクセルに輝度値と色値の両方を割り当てます。YUVでは、「Y」が輝度または「ルミナンス」値を表し、「UV」が色または「クロミナンス」値を表します。このLinux VDAの機能は、Citrix Receiver for Windows 4.10~4.12、およびCitrix Workspaceアプリ1808 for Windows以降で使用できます。
各Y、U、Vの一意の値は、8ビット、つまり1バイトのデータで構成されます。YUV444データ形式は、ピクセルあたり24ビットを送信します。YUV422データ形式は、2つのピクセル間でU値とV値を共有し、その結果、ピクセルあたり平均16ビットの伝送速度になります。次の表は、YUV444とYUV420の直感的な比較を示しています。
YUV444 YUV420
yuv444の画像 yuv420の画像(/en-us/linux-virtual-delivery-agent/1912-ltsr/media/yuv420.png)
VDAでYUV444ソフトウェアエンコーディングを有効にするには:
  1. 圧縮にビデオコーデックを使用ポリシーが画面全体に設定されていることを確認します。
  2. 視覚品質ポリシーが常にロスレスまたはビルドトゥロスレスに設定されていることを確認します。

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

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」を参照してください。

トラブルシューティング

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

使用中のグラフィックモードを確認するには、次のコマンドを実行します(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

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

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

どの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

3D Proでハードウェアエンコードが使用中であるかを確認する

次のコマンドを実行します (0 は使用中ではないことを意味し、1 は使用中であることを意味します):
sudo /opt/Citrix/VDA/bin/ctxreg dump | grep HardwareEncoding
結果は次のようになります。
create -k "HKLM\Software\Citrix\Ica\Session\1\Graphics" -t "REG_DWORD" -v "HardwareEncoding" -d "0x00000001" --force
別の方法は、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 |
+-----------------------------------------------------------------------------+

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の場合、Citrix Hypervisor™ローカルコンソールにICAデスクトップセッション画面が表示される

回避策: 次のコマンドを実行して、VMのローカルVGAコンソールを無効にします。
Citrix Hypervisor 8.1以降の場合:
[root@xenserver® ~]# xe vgpu-param-set uuid=vgpu-uuid extra_args=disable_vnc=1
Citrix Hypervisor 8.1より前の場合:
xe vm-param-set uuid=<vm-uuid> platform:vgpu_extra_args="disable_vnc=1"

NVIDIA K2グラフィックカードは、パススルーモードでのYUV444ハードウェアエンコーディングをサポートしていません

ポリシー設定でBuild to Losslessが有効になっている場合、NVIDIA K2グラフィックカードを使用してユーザーがアプリ/デスクトップセッションを起動すると、黒または灰色の画面が表示されます。この問題は、NVIDIA K2グラフィックカードがパススルーモードでYUV444ハードウェアエンコーディングをサポートしていないために発生します。詳細については、Video Encode and Decode GPU Support Matrixを参照してください。

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

これはGnome 3デスクトップセッション起動の制限です。

Citrix Workspaceアプリのウィンドウのサイズを変更すると、一部のOpenGL/WebGLアプリケーションが適切に描画されないことがあります

Citrix Workspaceアプリのウィンドウのサイズを変更すると、画面解像度が変更されます。NVIDIA独自のドライバーは一部の内部状態を変更し、アプリケーションがそれに応じて応答する必要がある場合があります。たとえば、WebGLライブラリ要素lightgl.jsは、「Rendering to this texture is not supported (incomplete frame buffer)」というエラーを生成する可能性があります。