EntityComponentSystemSamples/HybridHDRPSamples

Hybrid HDRP Samples Project

This Project includes feature sample Scenes, stress test Scenes, and unit tests for the HDRP Hybrid Renderer.

Feature sample Scenes

The feature sample Scenes are in the SampleScenes folder. To ensure full workflow coverage, most of these Scenes include GameObjects in a SubScene and GameObjects that have a ConvertToEntity component.

Unity renders GameObjects with the Hybrid Renderer when a coresponding DOTS entity exists, and without the Hybrid Renderer when a corresponding DOTS entity does not exist. For the GameObjects in the SubScene, this means that Unity renders them with the Hybrid Renderer at all times; in Edit Mode, in Play Mode, and in the built player. For the GameObjects with a ConvertToEntity component, this means that Unity renders them with the Hybrid Renderer only in Play Mode and in the built player. This is because Unity converts the components to DOTS entities at runtime.

Scene List

Scene	Description	Screenshot
AddComponentsExample	Demonstrates the new RenderMeshUtility.AddComponents API
BuiltinProperties	Demonstrates override of the built-in material SH property values
Deformations	Demonstrates BlendShape and SkinWeight entities
DisabledEntities	Demonstrates disabled entities
EntityCreationAPI	Demonstrates how to efficiently create entities at run time that are rendered via Hybrid Renderer
HybridEntitiesConversion	Demonstrates the graphics related Hybrid entities that you can put in a Subscene
Lightmaps	Demonstrates lightmap support for Entities
Lightprobes	Demonstrates lightprobe support for Entities
LODs	Demonstrates LODs and HLODs in Hybrid Renderer
LODsStatic	Demonstrates static optimized LOD hierarchies
MaterialMeshChange	Demonstrates how to change a Material and Mesh on Entities at runtime
MaterialOverridesSample	Demonstrates the setup of overriding a material's properties without having to write code
MatrixPrevious	Demonstrates moving Entities and support for HDRP Motion Vectors
OcclusionCulling	Demonstrates the new occlusion culling system on Entities
ShaderGraphProperties	Demonstrates material property overrides for Shader Graph shaders on Entities
SharedComponentOverrides	Demonstrates the support for overriding DOTS instanced material properties using ISharedComponentData
SkinnedMeshes	Demonstrates SkinnedMeshRenderer entities
TransparencyOrdering	Demonstrates transparent entities ordering
TriggerParticles	Demonstrates how to play VFX from an ECS System
HDRPLitProperties	Demonstrates material property overrides for different HDRP Lit material properties on Entities
HDRPShaders	Demonstrates material property overrides for HDRP Lit, LitTessellation, Unlit, LayeredLit, LayeredLitTessellation shaders on Entities

Stress test scenes

Stress test Scenes are located in the StressTestScenes folder.

The BigBatches stress test measures maximum thoughput of perfectly batched content. StressTestGameObjects uses GameObjects, and StressTestHybrid uses the Hybrid Renderer. This allows you to measure performance differences between GameObject rendering and Hybrid Rendering.

The stress test scene contains 100,000 spawned boxes. They cycle though four different animation modes: no animation, color animation, position animation, color + position animation.

StressTestGameObjects has two variants: one that includes the color overrides, and one that does not incude color overrides. This is because modifying GameObject color requires Material changes per GameObject, which causes material replication per object and has a large performance impact. Providing a variant without color overrides demonstrates more realistic performance for cases where you only modify position.

Compatibility

Compatible with Unity 2021.3.4f1 and HDRP 12.1.7 or later.