# LineRenderer 线段渲染器

线段渲染器组件需要一个在三维空间中两个或两个以上的点的数组,可以使用线段渲染器画任何东西,从一个简单的线段到一个复杂的螺旋。

# 在 IDE 中

要在 IDE 中创建,只需要选中场景或者 Prefab 中的一个节点,在 Inspector 中添加即可:

# 使用代码创建

LineRenderer 是渲染组件,因此需要挂载到非渲染节点上。

const line = entity.addComponent(engine.LineRenderer);

# 属性

属性名 类型 默认值 说明
positions engine.Vector3[] [] 形成线段的顶点数组
startWidth number 1 起始位置宽度
endWidth number 1 末尾位置宽度
startColor engine.Color engine.Color.WHITE 起始位置颜色
endColor engine.Color engine.Color.WHITE 末尾位置颜色
alignment LineAlignment LineAlignment.View 目前只实现了面片始终面向相机
    View - engine.LineRenderer.LineAlignment.View 面向相机平面。
    Local - engine.LineRenderer.LineAlignment.Local 与所在 Entity 的transform对齐。
useWorldSpace boolean true positions是否是世界坐标中的位置

# 方法

getPosition(index: number) : engine.Vector3 获取 index 顶点的位置。

setPosition(index: number, position: Vector3) : boolean 设置数组中 index 的位置信息。