Trail Renderer component reference
Explore the properties of the Trail Renderer component.
읽는 시간 3분최근 업데이트: 한 달 전
중요
The Built-In Render Pipeline is deprecated and will be made obsolete in a future release.
It remains supported, including bug fixes and maintenance, through the full Unity 6.7 LTS lifecycle.
For more information on migration, refer to Migrating from the Built-In Render Pipeline to the Universal Render Pipeline and Render pipeline feature comparison.
This section contains the following sub-sections:
Trail settings
Property | Function |
|---|---|
| Width | Define a width value, and a curve value to control the width of your trail along its length. The curve is sampled at each vertex, so its accuracy is limited by the number of vertices in your trail. The overall width of the trail is controlled by the width value. |
| Time | Define the lifetime of a point in the trail, in seconds. |
| Min Vertex Distance | The minimum distance between points in the trail, in world units. |
| AutoDestruct | Enable this to destroy the GameObject to which the Trail Renderer component is attached after it has not moved for Time seconds. |
| Emitting | When this is enabled, Unity adds new points in the trail. When this is disabled, Unity does not add new points to the trail. Use this to pause and unpause trail generation. |
| Color | Define a gradient to control the color of the trail along its length. Unity samples colors from the Color gradient at each vertex. Between each vertex, Unity applies linear interpolation to colors. Adding more vertices to your trail might give a closer approximation of a detailed gradient. |
| Corner Vertices | This property dictates how many extra vertices are used when drawing corners in a trail. Increase this value to make the trail corners appear rounder. |
| End Cap Vertices | This property dictates how many extra vertices are used to create end caps on the trail. Increase this value to make the trail caps appear rounder. |
| Alignment | Set the direction that the trail faces. The options are:
|
| Texture Mode | Control how the Texture is applied to the trail. The options are:
|
| Shadow Bias | Set the amount to move shadows away from the Light to remove shadowing artifacts. |
| Generate Lighting Data | If enabled, Unity builds the trail geometry with normals and tangents included. This allows it to use Materials that use the Scene lighting. |
Materials
The Materials section lists all the materials that this component uses.
Property | Description |
|---|---|
Size | The number of elements in the material list. If you decrease the number of elements, Unity deletes the elements at the end of the list. If you increase the number of elements, Unity adds new elements to the end of the list. Unity populates new elements with the same material that the element at the end of the list uses. |
Element | The materials in the list. You can assign a material asset to each element. By default, Unity orders the list alphabetically based on the name of the materials. This list is reorderable, and Unity updates the number of the elements automatically as you change their order. |
Lighting
The Lighting section contains properties that relate to lighting.
Property | Description |
|---|---|
Cast Shadows | Specify if and how this Renderer casts shadows when a suitable Light shines on it. This property corresponds to the Renderer.shadowCastingMode API. The options are:
|
Receive Shadows | Specify if Unity displays shadows cast onto this Renderer. This property only has an effect if you enable Baked Global Illumination or Enlighten Realtime Global Illumination for this scene. This property corresponds to the Renderer.receiveShadows API. If your project uses the Universal Render Pipeline (URP), this property appears in the Inspector window of materials instead. For more information, refer to Shader material Inspector window reference for URP. |
Contribute Global Illumination | Include this Renderer in global illumination calculations, which take place at bake time. This property only has an effect if you enable Baked Global Illumination or Enlighten Realtime Global Illumination for this scene. Enabling this property enables the Contribute GI flag in the GameObject's Static Editor Flags. It corresponds to the StaticEditorFlags.ContributeGI API. |
Receive Global Illumination | Whether Unity provides global illumination data to this Renderer from baked lightmaps, or from runtime Light Probes. This property is only editable if you enable Contribute Global Illumination. It only has an effect if you enable Baked Global Illumination or Enlighten Realtime Global Illumination for this scene. This property corresponds to the MeshRenderer.receiveGI API. The options are:
|
Prioritize Illumination | Enable this property to always include this Renderer in Enlighten Realtime Global Illumination calculations. This ensures that the Renderer is affected by distant emissives, even those which are normally excluded from Global Illumination calculations for performance reasons. This property is visible only if Contribute GI is enabled in the GameObject's Static Editor Flags, your project uses the Built-in Render Pipeline, and Enlighten Realtime Global Illumination is enabled in your scene. |
Mesh LOD for Global Illumination | The Mesh LOD index to use for global illumination and when baking lights. A less detailed model lowers global illumination quality, but decreases the bake memory usage and increases the bake performance. This setting is only visible if Mesh LODs have been generated for the mesh and the renderer contributes to global illumination. |
Probes
The Probes section contains properties relating to Light Probe and Reflection Probes.
Property | Description |
|---|---|
Light Probes | Set how this Renderer receives light from the Light Probes system. This property corresponds to the Renderer.lightProbeUsage API. The options are:
|
Proxy Volume Override | Set a reference to another GameObject that has a Light Probe Proxy Volume component. This property is only visible when Light Probes is set to Use Proxy Volume. |
Reflection Probes | Set how the Renderer receives reflections from the Reflection Probe system. This property is available only if you use the Built-In Render Pipeline. This property corresponds to the Renderer.probeAnchor API. The options are:
|
Anchor Override | Set the Transform that Unity uses to determine the interpolation position when using the Light Probe or Reflection Probe systems. By default, this is the centre of the bounding box of the Renderer's geometry. This property corresponds to the Renderer.probeAnchor API. |
Additional Settings
The Additional Settings section contains additional properties.
Property | Description |
|---|---|
Motion Vectors | Set whether to use motion vectors to track this Renderer's per-pixel, screen-space motion from one frame to the next. You can use this information to apply post-processing effects such as motion blur. Note: not all platforms support motion vectors. See SystemInfo.supportsMotionVectors for more information. This property corresponds to the Renderer.motionVectorGenerationMode API. The options are:
|
Dynamic Occlusion | When Dynamic Occlusion is enabled, Unity's occlusion culling system culls this Renderer when it is blocked from a Camera's view by a Static Occluder. Otherwise, the system does not cull this Renderer when it is blocked from a Camera's view by a Static Occluder. Dynamic Occlusion is enabled by default. Disable it for effects such as drawing the outline of a character behind a wall. Baked occlusion culling is deprecated and will be removed in a future release. Unity hides this property in projects you create in Unity 6.7 and later. For more information, refer to Remove a baked occlusion culling setup. |
Sorting Layer | The name of this Renderer’s Sorting Layer. |
Order in Layer | This Renderer’s order within a Sorting Layer. |