RenderQueue

Description

The order in which Unity renders objects.

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.

// 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;
    }
}

Properties