Class EntitiesGraphicsSystem
Renders all entities that contain both RenderMesh and LocalToWorld components.
Inherited Members
Namespace: Unity.Rendering
Syntax
[WorldSystemFilter(WorldSystemFilterFlags.Default | WorldSystemFilterFlags.Editor, WorldSystemFilterFlags.Default)]
[UpdateInGroup(typeof(PresentationSystemGroup))]
[UpdateAfter(typeof(UpdatePresentationSystemGroup))]
[BurstCompile]
public class EntitiesGraphicsSystem : SystemBase
Properties
EntitiesGraphicsEnabled
Toggles the activation of EntitiesGraphicsSystem.
Declaration
public static bool EntitiesGraphicsEnabled { get; }
Property Value
| Type | Description |
|---|---|
| Boolean |
Remarks
To disable this system, use the HYBRID_RENDERER_DISABLED define.
MaxBytesPerBatch
The maximum GPU buffer size (in bytes) that a batch can access.
Declaration
public static int MaxBytesPerBatch { get; }
Property Value
| Type | Description |
|---|---|
| Int32 |
Methods
GetMaterial(BatchMaterialID)
Returns the Material that corresponds to the given registered material ID, or null if no such material exists.
Declaration
public Material GetMaterial(BatchMaterialID material)
Parameters
| Type | Name | Description |
|---|---|---|
| BatchMaterialID | material | A material ID received from RegisterMaterial(Material). |
Returns
| Type | Description |
|---|---|
| Material | The Material object corresponding to the given material ID if the ID is valid, or |
GetMesh(BatchMeshID)
Returns the Mesh that corresponds to the given registered mesh ID, or null if no such mesh exists.
Declaration
public Mesh GetMesh(BatchMeshID mesh)
Parameters
| Type | Name | Description |
|---|---|---|
| BatchMeshID | mesh | A mesh ID received from RegisterMesh(Mesh). |
Returns
| Type | Description |
|---|---|
| Mesh | The Mesh object corresponding to the given mesh ID if the ID is valid, or |
OnCreate()
Called when this system is created.
Declaration
protected override void OnCreate()
Overrides
OnDestroy()
Called when this system is destroyed.
Declaration
protected override void OnDestroy()
Overrides
OnUpdate()
Called when this system is updated.
Declaration
protected override void OnUpdate()
Overrides
RegisterMaterial(Material)
Registers a material with the Entities Graphics System.
Declaration
public BatchMaterialID RegisterMaterial(Material material)
Parameters
| Type | Name | Description |
|---|---|---|
| Material | material | The material instance to register |
Returns
| Type | Description |
|---|---|
| BatchMaterialID | Returns the batch material ID |
RegisterMaterialPropertyType(Type, String, Int16)
Registers a material property type with the given name.
Declaration
public static void RegisterMaterialPropertyType(Type type, string propertyName, short overrideTypeSizeGPU = -1)
Parameters
| Type | Name | Description |
|---|---|---|
| Type | type | The type of material property to register. |
| String | propertyName | The name of the property. |
| Int16 | overrideTypeSizeGPU | An optional size of the type on the GPU. |
RegisterMaterialPropertyType<T>(String, Int16)
A templated version of the material type registration method.
Declaration
public static void RegisterMaterialPropertyType<T>(string propertyName, short overrideTypeSizeGPU = -1)
where T : IComponentData
Parameters
| Type | Name | Description |
|---|---|---|
| String | propertyName | The name of the property. |
| Int16 | overrideTypeSizeGPU | An optional size of the type on the GPU. |
Type Parameters
| Name | Description |
|---|---|
| T | The type of material property to register. |
RegisterMesh(Mesh)
Registers a mesh with the Entities Graphics System.
Declaration
public BatchMeshID RegisterMesh(Mesh mesh)
Parameters
| Type | Name | Description |
|---|---|---|
| Mesh | mesh | Mesh instance to register |
Returns
| Type | Description |
|---|---|
| BatchMeshID | Returns the batch mesh ID |
UnregisterMaterial(BatchMaterialID)
Unregisters a material from the Entities Graphics System.
Declaration
public void UnregisterMaterial(BatchMaterialID material)
Parameters
| Type | Name | Description |
|---|---|---|
| BatchMaterialID | material | Material ID received from RegisterMaterial(Material) |
UnregisterMesh(BatchMeshID)
Unregisters a mesh from the Entities Graphics System.
Declaration
public void UnregisterMesh(BatchMeshID mesh)
Parameters
| Type | Name | Description |
|---|---|---|
| BatchMeshID | mesh | A mesh ID received from RegisterMesh(Mesh). |