Version: 2022.2

LineRenderer

class in UnityEngine

/

继承自:Renderer

切换到手册

描述

线渲染器用于在 3D 空间中绘制自由浮动的线。

此类是线渲染器组件的脚本接口。

变量

alignment选择线是朝向摄像机还是变换组件的方向。
colorGradient设置颜色渐变,用于描述线在其长度上各个点处的颜色。
endColor设置线终点处的颜色。
endWidth设置线终点处的宽度。
generateLightingData配置线以生成法线和切线。借助此数据,场景光照可以通过法线贴图和 Unity 标准着色器或是您自己的定制着色器来影响线。
loop将线的起点和终点位置连接在一起,以形成连续循环。
maskInteractionSpecifies how the LineRenderer interacts with SpriteMask.
numCapVerticesSet this to a value greater than 0, to get rounded corners on each end of the line. The default is 0.
numCornerVertices将它设置为大于 0 的值,可在线的每个细分段之间获得圆角。
positionCount设置/获取顶点数。
shadowBias应用阴影偏差以防止自我阴影瑕疵。指定的值是每一段的线宽比例。
startColor设置线起点处的颜色。
startWidth设置线起点处的宽度。
textureMode选择线纹理的 U 坐标是进行平铺还是拉伸。
textureScaleA multiplier for the UV coordinates of the line texture.
useWorldSpace如果启用,则在世界空间中定义线。
widthCurve设置曲线,用于描述线在其长度上各个点处的宽度。
widthMultiplier设置一个整体乘数,它应用于 LineRenderer.widthCurve 以获取线的最终宽度。

公共函数

BakeMesh创建 LineRenderer 的快照并将其存储在 mesh 中。
GetPosition获取线中某个顶点的位置。
GetPositions获取线中所有顶点的位置。
SetPosition设置线中某个顶点的位置。
SetPositions设置线中所有顶点的位置。
Simplify通过删除处于指定公差内的点来生成原始线的简化版本。

继承的成员

变量

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.
FindObjectOfType返回第一个类型为 type 的已加载的激活对象。
FindObjectsByTypeRetrieves a list of all loaded objects of Type type.
FindObjectsOfTypeGets 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.