Version: 2023.1

TrailRenderer

class in UnityEngine

/

继承自:Renderer

切换到手册

描述

轨迹渲染器用于在场景中的对象移动时在对象后面生成轨迹。

此类是 trail renderer 组件的脚本接口。

变量

alignment选择轨迹是朝向摄像机还是变换组件的方向。
autodestruct此轨迹渲染器的 GameObject 是否自动销毁?
colorGradient设置颜色渐变,用于描述轨迹在其长度上各个点处的颜色。
emitting创建 GameObject 移动时的轨迹。
endColor设置轨迹终点处的颜色。
endWidth轨迹终点处的轨迹宽度。
generateLightingData配置轨迹以生成法线和切线。借助此数据,场景光照可以通过法线贴图和 Unity 标准着色器或是您自己的定制着色器来影响轨迹。
maskInteractionSpecifies how the TrailRenderer interacts with SpriteMask.
minVertexDistance设置轨迹在新顶点添加到其中之前可以行进的最小距离。
numCapVertices将它设置为大于 0 的值,可在轨迹的每端上获得圆角。
numCornerVertices将它设置为大于 0 的值,可在轨迹的每个细分段之间获得圆角。
positionCount获取轨迹中的线细分段数。
shadowBias应用阴影偏差以防止自我阴影瑕疵。指定的值是每一段的轨迹宽度比例。
startColor设置轨迹起点处的颜色。
startWidth生成点处的轨迹宽度。
textureMode选择轨迹纹理的 U 坐标是进行平铺还是拉伸。
textureScaleA multiplier for the UV coordinates of the trail texture.
time轨迹淡出需要的时间。
widthCurve设置曲线,用于描述轨迹在其长度上各个点处的宽度。
widthMultiplier设置一个整体乘数,它应用于 TrailRenderer.widthCurve 以得到轨迹的最终宽度。

公共函数

AddPosition向轨迹添加位置。
AddPositions向轨迹添加位置数组。
BakeMesh创建 TrailRenderer 的快照并将其存储在 mesh 中。
Clear删除 TrailRenderer 中的所有点。 对于从新位置重新开始轨迹非常有用。
GetPosition获取轨迹中某个顶点的位置。
GetPositions获取轨迹中所有顶点的位置。
GetVisiblePositionsGet the visible positions of all vertices in the trail.
SetPosition设置轨迹中某个顶点的位置。
SetPositions设置轨迹中所有顶点的位置。

继承的成员

变量

gameObject此组件附加到的游戏对象。始终将组件附加到游戏对象。
tag此游戏对象的标签。
transform附加到此 GameObject 的 Transform。
hideFlags该对象应该隐藏、随场景一起保存还是由用户修改?
name对象的名称。
allowOcclusionWhenDynamic控制是否应对该渲染器执行动态遮挡剔除。
boundsThe bounding box of the renderer in world space.
enabled如果启用,则使渲染的 3D 对象可见。
forceRenderingOff允许关闭特定组件的渲染。
isPartOfStaticBatchIndicates whether the renderer is part of a static batch with other renderers.
isVisible该渲染器是否在任何摄像机中可见?(只读)
lightmapIndex应用到该渲染器的烘焙光照贴图的索引。
lightmapScaleOffset用于光照贴图的 UV 缩放和偏移。
lightProbeProxyVolumeOverride如果设置,则渲染器将使用附加到源 GameObject 的 **Light Probe Proxy Volume** 组件。
lightProbeUsage光照探针插值类型。
localBoundsThe bounding box of the renderer in local space.
localToWorldMatrix将点从本地空间转换到世界空间的矩阵(只读)。
material返回指定给渲染器的第一个实例化 Material。
materials返回该对象的所有实例化材质。
motionVectorGenerationMode指定运动矢量渲染的模式。
probeAnchor如果设置,渲染器将使用该变换的位置来查找光源或反射探针。
rayTracingMode描述如何更新该渲染器来进行射线追踪。
realtimeLightmapIndexThe index of the real-time lightmap applied to this renderer.
realtimeLightmapScaleOffsetThe UV scale & offset used for a real-time lightmap.
receiveShadows该对象是否接受阴影?
reflectionProbeUsage是否应为该渲染器使用反射探针?
rendererPriority此值按优先级对渲染器排序。首先渲染较小值,最后渲染较大值。
renderingLayerMask确定该渲染器所在的渲染层。
shadowCastingMode该对象是否投射阴影?
sharedMaterial该对象的共享材质。
sharedMaterials该对象的所有共享材质。
sortingLayerID渲染器排序图层的唯一 ID。
sortingLayerName渲染器排序图层的名称。
sortingOrder排序图层中的渲染器顺序。
staticShadowCasterIs this renderer a static shadow caster?
worldToLocalMatrix将点从世界空间转换到本地空间的矩阵(只读)。

公共函数

BroadcastMessage调用此游戏对象或其任何子项中的每个 MonoBehaviour 上名为 methodName 的方法。
CompareTagChecks the GameObject's tag against the defined tag.
GetComponentGets a reference to a component of type T on the same GameObject as the component specified.
GetComponentInChildrenGets a reference to a component of type T on the same GameObject as the component specified, or any child of the GameObject.
GetComponentInParentGets a reference to a component of type T on the same GameObject as the component specified, or any parent of the GameObject.
GetComponentsGets references to all components of type T on the same GameObject as the component specified.
GetComponentsInChildrenGets references to all components of type T on the same GameObject as the component specified, and any child of the GameObject.
GetComponentsInParentGets references to all components of type T on the same GameObject as the component specified, and any parent of the GameObject.
SendMessage调用此游戏对象中的每个 MonoBehaviour 上名为 methodName 的方法。
SendMessageUpwards调用此游戏对象中的每个 MonoBehaviour 上或此行为的每个父级上名为 methodName 的方法。
TryGetComponent获取指定类型的组件(如果存在)。
GetInstanceIDGets the instance ID of the object.
ToString返回对象的名称。
GetClosestReflectionProbes返回一个数组,其中包含带有权重的最近反射探针。权重显示探针对渲染器的影响程度,当反射探针之间发生混合时,也会用到该值。
GetMaterials返回该对象的所有实例化材质。
GetPropertyBlock获取每渲染器或每材质的属性块。
GetSharedMaterials返回该对象的所有共享材质。
HasPropertyBlock如果渲染器具有通过 SetPropertyBlock 附加的材质属性块,则返回 true。
ResetBoundsReset custom world space bounds.
ResetLocalBoundsReset custom local space bounds.
SetMaterialsAssigns the shared materials of this object using the list of materials provided.
SetPropertyBlock允许您设置或清除每渲染器或每材质参数重写。
SetSharedMaterialsAssigns the shared materials of this object using the list of materials provided.

静态函数

Destroy移除 GameObject、组件或资源。
DestroyImmediate立即销毁对象 /obj/。强烈建议您改用 Destroy。
DontDestroyOnLoad在加载新的 Scene 时,请勿销毁 Object。
FindAnyObjectByTypeRetrieves any active loaded object of Type type.
FindFirstObjectByTypeRetrieves the first active loaded object of Type type.
FindObjectsByTypeRetrieves a list of all loaded objects of Type type.
Instantiate克隆 original 对象并返回克隆对象。

运算符

bool该对象是否存在?
operator !=比较两个对象是否引用不同的对象。
operator ==比较两个对象引用,判断它们是否引用同一个对象。

消息

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.