Renderer
General functionality for all renderers.
Read time 8 minutesLast updated 2 days ago
Definition
- Type: Class
- Namespace: UnityEngine
- Assembly: UnityEngine.CoreModule
- Inherits from: Component
[RequireComponent(typeof(Transform))]public class Renderer : Component
Remarks
A renderer is what makes an object appear on the screen. Use this class to access the renderer of any object, mesh or Particle System. Renderers can be disabled to make objects invisible (see Renderer.enabled), and the materials can be accessed and modified through them (see Renderer.material).
Properties
Property | Description |
|---|---|
| allowOcclusionWhenDynamic | Controls if dynamic occlusion culling should be performed for this renderer. |
| bounds | The bounding box of the renderer in world space. |
| enabled | Makes the rendered 3D object visible if enabled. |
| forceMeshLod | Force a specific Mesh LOD level for this renderer if the mesh has Mesh LODs. If the value is -1, Unity uses the default Mesh LOD selection method. |
| forceRenderingOff | Allows turning off rendering for a specific component. |
| isLOD0 | Is the renderer the first LOD level in its group. |
| isPartOfStaticBatch | Indicates whether the renderer is part of a static batch with other renderers. |
| isVisible | Is this renderer visible in any camera? (Read Only) |
| lightmapIndex | The index of the baked lightmap applied to this renderer. |
| lightmapScaleOffset | The UV scale & offset used for a lightmap. |
| lightProbeProxyVolumeOverride | If set, the Renderer will use the Light Probe Proxy Volume component attached to the source GameObject. |
| lightProbeUsage | The light probe interpolation type. |
| localBounds | The bounding box of the renderer in local space. |
| localToWorldMatrix | Matrix that transforms a point from local space into world space (Read Only). |
| LODGroup | The LODGroup for this Renderer. |
| lodGroupMask | The LOD levels of the owning LODGroup that use this Renderer, as a bit mask. |
| material | Returns the first instantiated Material assigned to the renderer. |
| materials | Returns all the instantiated materials of this object. |
| meshLodSelectionBias | Bias to add to the calculated value when selecting a Mesh LOD level. |
| motionVectorGenerationMode | Specifies the mode for motion vector rendering. |
| probeAnchor | If set, Renderer will use this Transform's position to find the light or reflection probe. |
| rayTracingAccelerationStructureBuildFlags | The flags Unity uses when it builds acceleration structures associated with geometry used by renderers. |
| rayTracingAccelerationStructureBuildFlagsOverride | Whether to override the default build flags specified when creating a RayTracingAccelerationStructure. |
| rayTracingMode | Describes how this renderer is updated for ray tracing. |
| receiveShadows | Does this object receive shadows? |
| reflectionProbeUsage | Should reflection probes be used for this Renderer? |
| rendererPriority | This value sorts renderers by priority. Lower values are rendered first and higher values are rendered last. |
| renderingLayerMask | Determines which rendering layer this renderer lives on, if you use a scriptable render pipeline. |
| shadowCastingMode | Does this object cast shadows? |
| sharedMaterial | The shared material of this object. |
| sharedMaterials | All the shared materials of this object. |
| sortingLayerID | Unique ID of the Renderer's sorting layer. |
| sortingLayerName | Name of the Renderer's sorting layer. |
| sortingOrder | Renderer's order within a sorting layer. |
| staticShadowCaster | Is this renderer a static shadow caster? |
| worldToLocalMatrix | Matrix that transforms a point from world space into local space (Read Only). |
Methods
Method | Description |
|---|---|
| GetClosestReflectionProbes | Returns an array of closest reflection probes with weights, weight shows how much influence the probe has on the renderer, this value is also used when blending between reflection probes occur. |
| GetMaterials | Returns all the instantiated materials of this object. |
| GetPropertyBlock | Get per-Renderer or per-Material property block. |
| GetSharedMaterials | Returns all the shared materials of this object. |
| HasPropertyBlock | Returns true if the Renderer has a material property block attached via SetPropertyBlock. |
| OnBecameInvisible | OnBecameInvisible is called when the object is no longer visible by any camera. |
| OnBecameVisible | OnBecameVisible is called when the object became visible by any camera. |
| ResetBounds | Reset custom world space bounds. |
| ResetLocalBounds | Reset custom local space bounds. |
| SetMaterials | Assigns the shared materials of this renderer using the list of materials provided. |
| SetPropertyBlock | Lets you set or clear per-renderer or per-material parameter overrides. |
| SetSharedMaterials | Assigns the shared materials of this renderer using the list of materials provided. |
Inheritance
Operators
Operator | Description |
|---|---|
| operator == | Compares two object references to see if they refer to the same object. |
| bool | Determines whether the object exists. |
| operator != | Compares if two objects refer to a different object. |