Documentation

Unity Engine

User Manual

Script Reference

Unity Engine

RenderPrimitivesIndexedIndirect(in RenderParams, MeshTopology, GraphicsBuffer, GraphicsBuffer, int, int)

Renders indexed primitives with GPU instancing and a custom shader with rendering command arguments from commandBuffer.
Read time 3 minutesLast updated 5 days ago

Definition

  • Type: Method
  • Namespace: UnityEngine
  • Assembly: UnityEngine.CoreModule

RenderPrimitivesIndexedIndirect(RenderParams, MeshTopology, GraphicsBuffer, GraphicsBuffer, int, int)

public static void RenderPrimitivesIndexedIndirect(in RenderParams rparams, MeshTopology topology, GraphicsBuffer indexBuffer, GraphicsBuffer commandBuffer, int commandCount = 1, int startCommand = 0)

Parameters

rparams

RenderParams
The parameters Unity uses to render the primitives.

topology

MeshTopology
Primitive topology (for example, triangles or lines).

indexBuffer

GraphicsBuffer
Index buffer for the rendered primitives.

commandBuffer

GraphicsBuffer
A command buffer that provides rendering command arguments (see GraphicsBuffer.IndirectDrawIndexedArgs).

commandCount

int
The number of rendering commands to execute in the 
commandBuffer
.

startCommand

int
The first command to execute in the 
commandBuffer
.

Remarks

This function allows you to control rendering command arguments from the GPU to render a given number of indexed primitives and instances. Use /RenderParams.worldBounds/ to define bounds to cull and sort the geometry rendered with the method as a single entity.
This function only works on platforms that support compute shaders.
Add the following lines in the pass section of a shader to access command, instance and vertex ID's as specified in UnityIndirect.cginc: A: Graphics.RenderMeshIndirect.
#define UNITY_INDIRECT_DRAW_ARGS IndirectDrawIndexedArgs#include "UnityIndirect.cginc"
Add the following line to the beginning of the shader function to setup the ID access functions:
InitIndirectDrawArgs(0);
The following example executes two indirect rendering commands. Each rendering command renders 10 Mesh instances. The associated Material must use the below custom shader.:
using UnityEngine;public class ExampleClass : MonoBehaviour{    public Material material;    public Mesh mesh;    GraphicsBuffer meshTriangles;    GraphicsBuffer meshPositions;    GraphicsBuffer commandBuf;    GraphicsBuffer.IndirectDrawIndexedArgs[] commandData;    const int commandCount = 2;    void Start()    {        // note: remember to check "Read/Write" on the mesh asset to get access to the geometry data        meshTriangles = new GraphicsBuffer(GraphicsBuffer.Target.Structured, mesh.triangles.Length, sizeof(int));        meshTriangles.SetData(mesh.triangles);        meshPositions = new GraphicsBuffer(GraphicsBuffer.Target.Structured, mesh.vertices.Length, 3 * sizeof(float));        meshPositions.SetData(mesh.vertices);        commandBuf = new GraphicsBuffer(GraphicsBuffer.Target.IndirectArguments, commandCount, GraphicsBuffer.IndirectDrawIndexedArgs.size);        commandData = new GraphicsBuffer.IndirectDrawIndexedArgs[commandCount];    }    void OnDestroy()    {        meshTriangles?.Dispose();        meshTriangles = null;        meshPositions?.Dispose();        meshPositions = null;        commandBuf?.Dispose();        commandBuf = null;    }    void Update()    {        RenderParams rp = new RenderParams(material);        rp.worldBounds = new Bounds(Vector3.zero, 10000*Vector3.one); // use tighter bounds        rp.matProps = new MaterialPropertyBlock();        rp.matProps.SetBuffer("_Triangles", meshTriangles);        rp.matProps.SetBuffer("_Positions", meshPositions);        rp.matProps.SetMatrix("_ObjectToWorld", Matrix4x4.Translate(new Vector3(-4.5f, 0, 0)));        commandData[0].indexCountPerInstance = mesh.GetIndexCount(0);        commandData[0].baseVertexIndex = mesh.GetBaseVertex(0);        commandData[0].startIndex = mesh.GetIndexStart(0);        commandData[0].instanceCount = 10;        commandData[1].indexCountPerInstance = mesh.GetIndexCount(0);        commandData[1].baseVertexIndex = mesh.GetBaseVertex(0);        commandData[1].startIndex = mesh.GetIndexStart(0);        commandData[1].instanceCount = 10;        commandBuf.SetData(commandData);        Graphics.RenderPrimitivesIndexedIndirect(rp, MeshTopology.Triangles, meshTriangles, commandBuf, commandCount);    }}
Use the following example shader with the above C# example code:
Shader "ExampleShader"{    SubShader    {        Pass        {            CGPROGRAM            #pragma vertex vert            #pragma fragment frag            #include "UnityCG.cginc"            #define UNITY_INDIRECT_DRAW_ARGS IndirectDrawIndexedArgs            #include "UnityIndirect.cginc"            struct v2f            {                float4 pos : SV_POSITION;                float4 color : COLOR0;            };            StructuredBuffer<float3> _Positions;            uniform float4x4 _ObjectToWorld;            v2f vert(uint svVertexID: SV_VertexID, uint svInstanceID : SV_InstanceID)            {                InitIndirectDrawArgs(0);                v2f o;                uint cmdID = GetCommandID(0);                uint instanceID = GetIndirectInstanceID(svInstanceID);                float3 pos = _Positions[GetIndirectVertexID(svVertexID)];                float4 wpos = mul(_ObjectToWorld, float4(pos + float3(instanceID, cmdID, 0.0f), 1.0f));                o.pos = mul(UNITY_MATRIX_VP, wpos);                o.color = float4(cmdID & 1 ? 0.0f : 1.0f, cmdID & 1 ? 1.0f : 0.0f, instanceID / float(GetIndirectInstanceCount()), 0.0f);                return o;            }            float4 frag(v2f i) : SV_Target            {                return i.color;            }            ENDCG        }    }}