Provides parameters and methods for tracking shader variants that have been uploaded to the GPU driver during the last frame at runtime.
This class provides access to shader variants that were uploaded to the GPU driver during the last frame. To reduce shader stutters, use the class to find shader variants that aren't warmed up, and add them to a ShaderVariantCollection or a GraphicsStateCollection.
Note: You can only use this class in a built application, not in the Unity Editor.
Additional resources: ShaderVariantCollection, GraphicsStateCollection, UploadData.
using UnityEngine;
using UnityEngine.Shaders;
/*
Attach this script to a GameObect. When run in the player, it reports shader variants sent to the
GPU driver for compilation during the last frame in the console.
*/
public class VariantsUploadedToGpuLogger : MonoBehaviour
{
void Update()
{
uint variantCount = VariantsUploadedToGpuLastFrame.count;
if (variantCount > 0)
{
Debug.Log("Sent " + variantCount + " variants to the GPU.");
for (uint variantIndex = 0; variantIndex < variantCount; ++variantIndex)
{
VariantsUploadedToGpuLastFrame.UploadData d;
if (!VariantsUploadedToGpuLastFrame.TryGetUploadData(variantIndex, out d))
continue;
string keywords = "'";
for (uint keywordIndex = 0; keywordIndex < d.keywords.Length; ++keywordIndex)
{
if (keywordIndex != 0)
keywords += " ";
keywords += d.keywords[keywordIndex].name;
}
keywords += "'";
string passId = "subshader " + (d.passIdentifier.SubshaderIndex + 1) + " pass " + (d.passIdentifier.PassIndex + 1);
string description = "Shader " + d.shader.name + " " + passId + " stages " + d.stages;
Debug.Log(description + " keywords " + keywords + " uploaded in " + d.uploadTimeInMilliseconds + " ms.");
}
}
}
}
| Property | Description |
|---|---|
| count | The number of shader variants submitted to the GPU driver during the last frame. |
| Method | Description |
|---|---|
| GetUploadData | Gets the UploadData for the shader variant at the given index. |
| TryGetUploadData | Fetches the UploadData for the shader variant at given index. |