虚幻引擎5文档已被迁移至 Epic开发者社区

动态分辨率 可根据先前画面的GPU工作负载调节主要屏幕百分比。分辨率是基于启发法（按需要）调节的，例如，如果在屏幕上有太多Object，或者有成本高昂的效果突然进入画面，GPU渲染时间将会延长，此时为了维持目标帧率就会降低屏幕分辨率。

启用动态分辨率

在运行时启用动态分辨率

动态分辨率可以通过在 Game User Settings 节点上获取一个布尔数值来启用。你可以在使用蓝图或C++时设置它。

在 蓝图 中，你可以使用 Game User Settings 节点选择此功能来启用动态分辨率，如下图：

在 C++ 中，你可以在 UGameUserSettings 设置如下布尔值：

GEngine->GetDynamicResolutionStatus()->SetEnabled(true);

将 SetEnabled 设置为 false 可将其禁用。

GEngine->GameUserSettings->ApplyNonResolutionSettings();

使用运算模式控制动态分辨率

你可以使用 运算模式（Operation Mode） 设置如何在游戏中覆盖和使用动态分辨率，设置在游戏中覆盖它和使用它的方式。为了控制这种模式，在项目所对应平台（Xbox One、PlayStation 4等）的平台配置描述（或设备描述）中，你可以使用下列控制台命令：

r.DynamicRes.OperationMode

使用下列数值之一来设置运算模式如何针对项目的平台工作：

• 1 是根据游戏用户设置状态（在C++或蓝图中设置）启用动态分辨率。

• 2 是无论游戏用户设置状态如何都启用动态分辨率。

启用动态分辨率后，下列控制台变量会设置屏幕百分比的最大值和最小值，以及在降低分辨率之前任何给定帧的最大预算。如果你不设置，这些变量都有默认值：

暂停和恢复动态分辨率

有时你可能需要为项目启用动态分辨率，但你又不想对主大厅之类的区域启用。动态分辨率可以随运作模式暂停和恢复。下列控制台变量可用于设置动态分辨率的运算模式：

r.DynamicRes.OperationMode

下表概括了当启用或禁用特定运算模式时可用的不同状态，以及GameUserSettings所受的影响：

在 C++ 中，你可以使用下列函数控制和检查动态分辨率的状态：

统计动态分辨率的相关数据

你可以启用几个统计屏幕来调试与动态和分辨率有关的性能。可以使用反引号（ ` ） 键打开控制台，然后输入下列命令之一来启用它们：

• Stat Unit 用于查看总体帧时间，以及游戏线程、渲染线程和GPU时间。

• Stat UnitGraph 用于查看使用Stat Unit的数据制作的图。

• Stat Raw 使用Stat UnitGraph输出未经过滤的数据。

Stat Unit

调用 Stat Unit 时，你可以通过参考 DynRes 行来即时了解你的场景是否启用了动态分辨率。

如果已启用， DynRes 标签将会显示 主要屏幕百分比 和 次要屏幕百分比 ：

此处显示X轴和Y轴的主要屏幕百分比，以免你忘记它是在两条轴上缩放的。GPU绘制的像素数实际上与 屏幕百分比x屏幕百分比 成正比。

例如1920x1080或1280x720。

Stat UnitGraph和Stat Raw

如果调用 Stat UnitGraph ，将会绘制一张图来显示动态分辨率功能选择的 主要屏幕百分比 。

1. 时间（过滤后的时间或原始时间）

2. 目标帧时阈值

3. 动态分辨率最大屏幕百分比

4. 动态主要屏幕百分比曲线

UnitGraph可以显示动态分辨率功能选择的主要屏幕百分比。但是，该曲线也与GPU使用屏幕百分比x屏幕百分比绘制的像素数成正比。

此外，你可以使用 Stat Raw 在经过滤和未过滤数据之间切换，获取UnitGraph中未经过滤（原始）的时间。该图的时间标签将会发生变化，以表明其显示的是原始时间。

原始时间

过滤后的时间

动态分辨率巡航

在UE4中，动态分辨率功能的实现与以前其他引擎中同类功能有所不同，因为我们允许分辨率根据需要在一个给定的范围内变化，而不是限制为单一的分辨率（1080p、900p、720p）。在这张示例图中，此模型演示了控制台变量所控制的对象。它演示了当一切都运行顺利、没有超过给定帧的预算时，动态分辨率是如何在给定范围（3）中自动调节的。可以把这个范围想象为飞机的巡航高度，飞机在这一高度范围可以自由机动，以实现到达目的地的理想速度。和飞机一样，分辨率也可以根据需要上下调节，从而在分辨率和充足的性能之间保持良好的平衡。

如果你的瓶颈是在CPU而非GPU，还可以使用下列控制台变量调节用于动态分辨率的启发法历史记录和要使用的屏幕百分比：

超预算应急

如果你发现动态分辨率会非常迅速地超出预算，例如在镜头切换时或者成本高昂的视觉效果出现时，那就说明使用的启发法实际上无法预测这种情况何时会发生。在这类情况确实发生时，可以使用某种"应急"按钮快速降低分辨率，从而减少超出预算的帧数。如果启发法发现有N（一定数量）个连续帧的可用GPU时间超出预算，它将会立即调整分辨率来应对这些超预算时间。它还会自动执行历史记录重置，使得先前成本较低的帧时间不会影响启发法对成本较高的帧的判断。

请使用下列控制台命令来控制在启用"应急"开关降低分辨率之前可以出现的超GPU预算的连续帧数：

r.DynamicRes.MaxConsecutiveOverbudgetGPUFrameCount

在此图中，画面中突然发生跳跃，因此有两个以上的连续帧超过了设定的33.3毫秒的预算。系统激活了应急开关来快速降低分辨率，使得后续帧不再超出预算。

1. 超出预算的最大连续GPU帧数。

2. 从检测到GPU导致分辨率变化为止未与渲染线程同步的帧延迟。

3. 发生紧急情况检测，引发帧率下降。

4. 一定数量的帧发生分辨率更改。

在下列截图（取自Epic Games Launcher的 学习（Learn） 选项卡中提供的Infiltrator演示）中，使用了 Stat Raw 命令明确标识当发生镜头切换或者屏幕上出现高成本的视觉效果时的场景行为：

1. 在镜头切换之后，画面的渲染成本显著提高，至少有若干帧是如此。

2. 动态分辨率有应急反应能力，可以快速降低分辨率进行补偿，然后再慢慢将分辨率提高到正常水平。

1. 发生了渲染成本较高的视觉效果，导致相当数量的帧超出分配的帧预算。

2. 动态分辨率迅速作出反应，降低了分辨率，然后又缓慢将分辨率提高到正常水平。

测试使用不同的主要屏幕百分比的内容

如果你的项目启用了动态分辨率，你需要对它进行测试，确保在使用降低的主要屏幕百分比时图像与预期差异不大。在分辨率降低时，有些细节可能会丢失，你的资源可能不会保持你所希望的外观。正因如此，所有的编辑器视口都可以使用滑块设置屏幕百分比以便测试。

使用滑块对视口应用更高或更低的屏幕百分比，然后相应检查关卡内容。特别是美工，应该使用该滑块在将用于项目的高低范围屏幕百分比下检查他们的内容。

在调节屏幕百分比滑块时，视口（右下）将显示所有高于100的屏幕百分比值。这样设计的目的是提醒用户视口屏幕百分比值已经更改为非默认值，因为使用了高于正常水平的分辨率，可能导致性能问题。

支持动态分辨率的平台

支持以下平台

• 微软的Xbox One、Xbox Series S和Xbox Series X

• PlayStation 4 和 PlayStation 5 （不包括PSVR）

• Nintendo Switch

• Oculus VR

未来引擎版本将逐渐支持其他平台。

在C++中替换动态分辨率启发法

引擎提供的渲染线程启发法完整地自包含在 DynamicResolution.cpp 中。它的架构设置使你可以在游戏代码中用插件将启发法完全替换掉。

例如，如果你希望Gameplay代码提示后续帧将发生的情况，因而需要在项目中替换掉默认启发法，可以重写整套启发法来达成这一目的。通过实现`IDynamicResolutionState`和`ISceneViewFamilyScreenPercentage`，你可以替换默认的动态分辨率状态，如下例所示：

GEngine->ChangeDynamicResolutionStateNextFrame(new FMyGameSpecificDynamicResolutionState());

分辨率分数 = 屏幕百分比/100 = 1/放大系数

动态分辨率的局限性

以下是动态分辨率在当前的一些局限性：

• 它的设计不支持配合多场景的"在编辑器中运行"功能使用。

• 如果启用了TAAU，它将会与VR一起工作。多重取样抗锯齿（MSAA）支持将在今后的发行版中提供。

• API与移动渲染器完全兼容。但是，我们还没有采取措施使视图大小保持不等于主要屏幕百分比上限所设置的渲染目标缓冲区大小。

• 高斯景深（DoF）和 距离场环境光遮蔽 （DFAO）在分辨率更改时会有问题。

常见问题及解答

下面是关于动态分辨率的一些常见问题：

可以替换用于动态分辨率的启发法吗？

可以，它采用了模块化设计，可以在C++中插入。虚幻引擎4不仅保有一种启发法，而且它的架构允许创建独立的自定义启发法，后者可具备能够由Gameplay代码或Sequencer触发的自定义游戏线程事件。

动态分辨率可以使用任意的次要屏幕百分比吗？

是的。可以使用控制台变量 r.SecondaryScreenPercentage.GameViewport. 来实现这一点

可以控制次要屏幕百分比的动态分辨率吗？

这是不可能的，它的设计就是这样。你不会希望更改时空抗锯齿历史记录的大小，这就是为什么你不需要动态地更改次要屏幕百分比。

为什么动态分辨率忽略了FPostProcessSettings中用于ScreenPercentage的函数？

这是先前的机制的一部分，在这种机制下，可以在设置中将后期处理体积的屏幕百分比配置为手动调高或调低。如果使用动态分辨率，就再也不需要设置了，因为它会根据GPU工作负载自动处理。

为什么在编辑器中动态分辨率没有可选的显示标志？

因为它是全局发生的，由游戏线程来判断。屏幕百分比显示标志只会切换 主要屏幕百分比 的显示。

为什么在编辑器视口中不支持动态分辨率？

当前仅对Xbox One、PlayStation 4和Nintendo Switch支持动态分辨率，它们不使用PIE。等到它在平台上提供的时候（Vulkan，D3D12），你就可以在编辑器中将它与PIE配合使用了。

可以在材质中访问主要和次要屏幕百分比吗？

不可以。材质的渲染应该独立于分辨率。