Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


PrepareRendererListsAsync(List<RendererList>)

Starts to process the provided RendererLists in the background.
Read time 1 minuteLast updated 5 days ago

Definition

public void PrepareRendererListsAsync(List<RendererList> rendererLists)

Parameters

rendererLists

The list of RendererList objects to prepare for rendering.

Remarks

With this command, an application can manually start the batch processing and filtering of the visible GameObjects. It is an asynchronous operation and the control returns immediately to the application. To check the status for each RendererList, use QueryRendererList.
If you do not use this command, then the batch processing of RendererLists begins with ScriptableRenderContext.Submit. By using this command, the application can start the processing of a number of RendererLists manually at the beginning of a frame, before recording any other rendering commands. This enables RendererList processing to overlap with other work, which improves performance.
Furthermore, by using the ScriptableRenderContext.QueryRendererListStatus command, the application can get information about the type of visible objects in the scene and optimize rendering accordingly (for example by skipping a color pyramid generation pass if no objects with distortion are visible).