Renderer Shader User Value sample

Use the Renderer ShaderA program that runs on the GPU. More info
See in Glossary User Value sample in your URP or HDRP project to experience the implementation and effects of the RSUV feature through different preset scenesA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
See in Glossary.

Import the sample

1. Create or use a project based on URP or HDRP.
2. Open the Package Manager window.
3. In the package list, find and select the package corresponding to your current render pipelineA series of operations that take the contents of a Scene, and displays them on a screen. Unity lets you choose from pre-built render pipelines, or write your own. More info
   See in Glossary (Universal or High Definition).
4. Select the Samples tab.
5. Find Renderer Shader User Value Sample and select Import.

Sample contents

The sample includes two scenes and some helpers to streamline the process of packing/unpacking data with RSUV.

LookDev scene

This scene features an animated soldier with one simple idle animation and two components dedicated to pass data to the skinned meshThe main graphics primitive of Unity. Meshes make up a large part of your 3D worlds. Unity supports triangulated or Quadrangulated polygon meshes. Nurbs, Nurms, Subdiv surfaces must be converted to polygons. More info
See in Glossary renderer. Those components use the RSUV feature and allow you to customize the rendering of the soldier through different techniques:

• The Health RSUV component uses a simple quadA primitive object that resembles a plane but its edges are only one unit long, it uses only 4 vertices, and the surface is oriented in the XY plane of the local coordinate space. More info
  See in Glossary outside the soldier geometry. The health value and bar opacity are passed with RSUV. The health of the character is renderered in the shader by manipulating UVs and sampling a gradient.

• The Body RSUV component allows to customize the material with different methods, for example:
  • Color palette sampling based on UVoffset.
  • Showing/hiding vertices based on vertex colors (set in DCC software like blender).
  • Inflating vertices from a central point to change the belly size.

Agora scene

This scene includes 100 instances of the soldier from the LookDev scene.

• The soldiers have randomized material feature on start, so they always look more or less different.
• When you click on a soldier in Play mode, you make them jump, which is also done with RSUV.
• The scene leverages GPU Resident Drawer (GRD), which allows the SRP Batcher to handle the hundred drawcalls in one batch without breaking.

In this scene, the soldier uses a simple MeshRenderer and a Vertex Animation 2D Texture Array instead of the animator and SkinnedMeshRenderer combo because GRD is not compatible with animators and skinned meshes. Having multiple instances of them would break the batching, even with RSUV.

This version of the soldier with Mesh RendererA mesh component that takes the geometry from the Mesh Filter and renders it at the position defined by the object’s Transform component. More info
See in Glossary and Vertex Animation Texture (VAT) uses only one draw call per material (so only 4 draw calls for the whole scene) and is suitable to render crowds, for example. For that to work, make sure GRD is properly set up.

Also, the VAT is a texture array and not a single texture, which allows to change the animation index to target another texture in the texture array. Here, one texture is for the idle animation, and another one is for the jump animation.

Additional resources

• Introduction to RSUV
• Set and use the RSUV