Version: 2023.2
LanguageEnglish
  • C#

RenderingThreadingMode

enumeration

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

Description

Options for the application's actual rendering threading mode.

The combination of Player Settings PlayerSettings.MTRendering, PlayerSettings.graphicsJobs and PlayerSettings.graphicsJobMode, as well as the target platform capabilities decides the rendering threading mode during the start of the Unity Editor or Standalone. After startup, you can use the property SystemInfo.renderingThreadingMode to query the rendering threading mode.
See the tutorial page Multithreaded Rendering & Graphics Jobs for a comparison of different rendering threading modes.

Properties

DirectUse the Direct enum to directly render your application from the main thread.
SingleThreadedUse SingleThreaded for internal debugging. It uses only a single thread to simulate RenderingThreadingMode.MultiThreaded.
MultiThreadedGenerates intermediate graphics commands via the main thread. The render thread converts them into low-level platform API graphics commands.
LegacyJobifiedGenerates intermediate graphics commands via several worker threads. A single render thread then converts them into low-level platform API graphics commands.
NativeGraphicsJobsMain thread generates intermediate graphics commands. Render thread converts them into low-level platform API graphics commands. Render thread can also dispatch graphics jobs to several worker threads.
NativeGraphicsJobsWithoutRenderThreadGenerates intermediate graphics commands via several worker threads and converts them into low-level platform API graphics commands.
NativeGraphicsJobsSplitThreadingGenerates intermediate graphics commands via several worker threads and render thread dispatches several worker threads to convert them into low-level platform API graphics commands.