Shader variant collections
Replacing shaders at runtime
Shader loadingBy default, Unityâs runtime shaderA program that runs on the GPU. More info
See in Glossary loading behavior is:
The benefit of this behavior is that there is no upfront GPU memory usage or load time for shader variants. The downside is that there can be visible stalls when a variant is used for the first time, because the graphics driver must create the shader program on the GPU and perform any additional work.
Prewarming shader variantsTo avoid visible stalls at performance-intensive times, Unity can ask the graphics driver to create GPU representations of shader variants before theyâre first needed. This is called prewarming.
You can prewarm in the following ways:
You can also add shader variant collections to the Preloaded shaders section of the Graphics Settings window. Unity uses the ShaderVariantCollection.WarmUp
API to load and prewarm the shader variant collections when your built application starts.
If you build for DirectX 12, Metal or Vulkan, the graphics driver can only create an accurate GPU representation of a shader variant if it knows the exact vertex data layout and render state. If a prewarmed GPU representation is inaccurate, Unity might still stall when it needs to create the accurate representation.
To create accurate variants and avoid stalling, you should prewarm by rendering Materials off-screen.
You can also:
Experimental.Rendering.ShaderWarmup
, but only if you can provide the vertex data layout and set the render state accurately.ShaderVariantCollection.Warmup
or Shader.WarmupAllShaders
, which may create inaccurate prewarmed GPU representations because you canât provide a vertex data layout or render state.In your built application, Unity stores several âchunksâ of compressed shader variant data. Each chunk contains multiple shader variants. When Unity loads a sceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
See in Glossary at runtime, it loads all the sceneâs chunks into CPU memory and decompresses them.
To reduce memory usage on platforms that have limited memory, you can limit the size of chunks and how many decompressed chunks Unity keeps in memory.
To do this, in Player settingsSettings that let you set various player-specific options for the final game built by Unity. More info
See in Glossary, select Other Settings > Shader Variant Loading and adjust the following settings:
0
, which means thereâs no limit.See PlayerSettings.SetDefaultShaderChunkCount for more information.
You can use Override to override the values for each platform individually. See PlayerSettings.SetShaderChunkCountForPlatform for more information.
You can also use Shader.maximumChunksOverride to override Default chunk count at runtime.
Profiler markers for shader loadingThe profilerA window that helps you to optimize your game. It shows how much time is spent in the various areas of your game. For example, it can report the percentage of time spent rendering, animating, or in your game logic. More info
See in Glossary marker for Unity creating a representation of shader variant data to send to the GPU is Shader.Parse
. The profiler markerPlaced in code to describe a CPU or GPU event that is then displayed in the Unity Profiler window. Added to Unity code by default, or you can use ProfilerMarker API to add your own custom markers. More info
See in Glossary for uploading the shader program to the GPU, and waiting for the GPU to perform any required work, is CreateGPUProgram
.
For information on using the Unity Profiler, see Profile your application.
Shader variant collections
Replacing shaders at runtime
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4