Documentation

Unity Engine

User Manual

Script Reference

Unity Engine

RenderQueue

The order in which Unity renders objects.
Read time 2 minutesLast updated 4 days ago

Definition

public enum RenderQueue

Remarks

This enum represents the start of each range of render queue values. The render queue value of a material is an integer in the range [0;5000], which determines the order in which Unity renders the object. Unity renders materials with lower render queue values earlier than materials with higher values.
The total range of render queue values is divided into sections, and each section is represented as an element in this enum. Use the render queue section that matches the object type. For example, opaque geometry should be in the 
Geometry
queue, while transparent geometry should be in the 
Transparent
queue. This ensures that Unity renders transparent objects after opaque objects.
Objects using a render queue value in the range [0; 2500] are sorted during rendering based on Camera.opaqueSortMode (typically front-to-back order), while objects using a render queue value in the range [2501; 5000] are sorted based on Camera.transparencySortMode (typically back-to-front). This behavior ensures that Unity renders opaque objects performantly and renders transparent objects without sorting artifacts.
Additional Resources: Material.renderQueue, Shader.renderQueue.

Examples

// To use this script, attach it to a GameObject with a mesh renderer.using UnityEngine;using UnityEngine.Rendering;// This example sets the render queue value of an object based on settings selected in the Inspector.// The queue setting selects the base render queue and queueOffset adds a small offset to it.[RequireComponent(typeof(MeshRenderer))]public class RenderQueueAssigner : MonoBehaviour{    public RenderQueue queue = RenderQueue.Geometry; // Base queue    [Range(-20, 20)] public int queueOffset = 0; // Small offset to control order of objects on the same queue    private Material material;    private void Start()    {        material = GetComponent<Renderer>().material;    }    void Update()    {        material.renderQueue = (int)queue + queueOffset;    }}

Fields

Value

Description

AlphaTestAlpha tested geometry uses this queue. This value corresponds to a render queue of 2450.
BackgroundThis render queue is rendered before any others. This value corresponds to a render queue of 1000.
Geometry
Geometry
is a predefined render queue that Unity uses for opaque geometry.
GeometryLastThe last render queue that is treated as opaque. This value corresponds to a render queue of 2500.
OverlayThis render queue is meant for overlay effects, and is rendered last. This value corresponds to a render queue of 4000.
TransparentThis render queue is rendered after Geometry and AlphaTest, in back-to-front order. This value corresponds to a render queue of 3000.