Version: Unity 6 (6000.0)
Language : English
Introduction to the BatchRendererGroup API in URP
Creating a renderer with the BatchRendererGroup API in URP

Set up your project for the BatchRendererGroup API in URP

Before you use BRG, your project must support it. BRG requires your project to:

  • Use the SRP Batcher. To enable the SRP Batcher, see Using the SRP Batcher.
  • Keep BRG shader variantsA verion of a shader program that Unity generates according to a specific combination of shader keywords and their status. A Shader object can contain multiple shader variants. More info
    See in Glossary
    . To do this, select Edit > Project Settings > Graphics, and set BatchRendererGroup variants to Keep all.
  • If your project uses URP, it’s best practice to disable the Strip Unused Variants Global Setting. This helps to avoid problems with Unity stripping necessary DOTS Instancing variants. For more information, see DOTS Instancing shaders. To find this setting, select Edit > Project Settings > URP Global Settings.
  • Allow unsafe code. To do this, enable the Allow ‘unsafe’ Code Player Setting.

Note: The BatchRendererGroup uses DOTS Instancing shaders, but it doesn’t require any DOTS packages. The name reflects the new data-oriented way to load instance data, and also helps with backward compatibility with existing Hybrid Renderer compatible shadersA program that runs on the GPU. More info
See in Glossary
.

For information on how to use BRG to create a basic renderer, see Creating a renderer with BatchRendererGroup.

Introduction to the BatchRendererGroup API in URP
Creating a renderer with the BatchRendererGroup API in URP