Version: 2021.3
LanguageEnglish
  • C#

QualitySettings.maxQueuedFrames

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Switch to Manual
public static int maxQueuedFrames;

Description

Maximum number of frames queued up by graphics driver.

Graphics drivers queue up frames that are yet to be rendered, especially when the CPU has lesser processes to execute than the graphics card, this queue can grow large. In such scenarios, the user's input might lag behind the content displayed on the screen.

Use QualitySettings.maxQueuedFrames to limit maximum number of frames that are queued. On PC, the default value is 2, which strikes a good balance between frame latency and framerate.

Note: You can reduce input latency by using smaller maxQueuedFrames, such that the CPU waits until the graphics card completes rendering previous frames. However, doing this might result in a lower framerate.

Currently, maxQueuedFrames is implemented in Direct3D 11 and Direct3D 12 graphics APIs only and ignored by other graphics APIs. For information about other graphics APIs, where maxQueuedFrames is implemented, refer to platform-specific documentation.