VariantsUploadedToGpuLastFrame
Provides parameters and methods for tracking shader variants that have been uploaded to the GPU driver during the last frame at runtime.
Read time 2 minutesLast updated 12 days ago
Definition
- Type: Class
- Namespace: UnityEngine.Shaders
- Assembly: UnityEngine.CoreModule
public static class VariantsUploadedToGpuLastFrame
Remarks
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, VariantsUploadedToGpuLastFrame.UploadData.
Examples
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."); } } }}
Static Properties
Property | Description |
|---|---|
| count | The number of shader variants submitted to the GPU driver during the last frame. |
Static Methods
Method | Description |
|---|---|
| GetUploadData | Gets the VariantsUploadedToGpuLastFrame.UploadData for the shader variant at the given index. |
| TryGetUploadData | Fetches the VariantsUploadedToGpuLastFrame.UploadData for the shader variant at given index. |
Structs
Struct | Description |
|---|---|
| VariantsUploadedToGpuLastFrame.UploadData | Represents a shader variant that was uploaded to the GPU driver. |