Linux Virtual Delivery Agent 2201

非 GRID 3D 图形

概述

通过此功能增强,Linux VDA 不仅支持 NVIDIA GRID 3D 显卡,还支持非 GRID 3D 显卡。

  • 安装

要使用非 GRID 3D 图形功能,必须:

  • 安装 XDamage 作为必备条件。通常,XDamage 作为 XServer 的扩展存在。
  • 安装 Linux VDA 时,将 CTX_XDL_HDX_3D_PRO 设置为 Y。有关环境变量的信息,请参阅步骤 7:设置运行时环境以完成安装

  • 配置

  • Xorg 配置文件

如果 3D 显卡驱动程序是 NVIDIA,配置文件将自动安装和设置。

其他类型的 3D 显卡

如果 3D 显卡驱动程序不是 NVIDIA,必须修改安装在 /etc/X11/ 下的以下四个模板配置文件:

  • ctx-driver_name-1.conf
  • ctx-driver_name-2.conf
  • ctx-driver_name-3.conf
  • ctx-driver_name-4.conf

ctx-driver_name-1.conf 为例,执行以下操作来修改模板配置文件:

  1. driver_name 替换为实际的驱动程序名称。

    例如,如果驱动程序名称是 intel,可以将配置文件名称更改为 ctx-intel-1.conf

  2. 添加视频驱动程序信息。

    每个模板配置文件都包含一个名为“Device”的部分,该部分已注释掉。此部分描述了视频驱动程序信息。在添加视频驱动程序信息之前,请启用此部分。要启用此部分,请执行以下操作:

    1. 请参阅制造商提供的 3D 显卡指南以获取配置信息。可以生成本机配置文件。验证在不使用 Linux VDA ICA® 会话时,3D 显卡是否可以在本地环境中使用本机配置文件工作。

    2. 将本机配置文件的“Device”部分复制到 ctx-driver_name-1.conf

  3. 运行以下命令以设置注册表项,以便 Linux VDA 可以识别在步骤 1 中设置的配置文件名称。

    /opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\XDamage" -t "REG_SZ" -v "DriverName" -d "intel" --force
    <!--NeedCopy-->
    

启用非 GRID 3D 图形功能

非 GRID 3D 图形功能默认处于禁用状态。可以通过运行以下命令,将 XDamageEnabled 设置为 1 来启用此功能。

/opt/Citrix/VDA/bin/ctxreg create -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\XDamage" -t "REG_DWORD" -v "XDamageEnabled" -d "0x00000001" --force
<!--NeedCopy-->

故障排除

无图形输出或图形输出乱码

如果可以在本地运行 3D 应用程序且所有配置都正确,缺少图形输出或图形输出乱码是 Bug 导致的。使用 /opt/Citrix/VDA/bin/setlog 并将 GFX_X11 设置为 verbose 以收集跟踪信息进行调试。

硬件编码不起作用

此功能仅支持软件编码。

非 GRID 3D 图形