Class Path3

表示一个由多个三维点组成的路径。

Hierarchy

Path3

Index

Constructors

Accessors

closed distance points

Methods

addPoint close getPointAtDistance getPointAtPercent FromPoints

Constructors

constructor

new Path3(x: number, y: number, z: number): Path3
由给定的起点构造一个新有向路径。
Parameters
- x: number
  
  起点的 x 坐标
- y: number
  
  起点的 y 坐标
- z: number
  
  起点的 z 坐标
Returns Path3

Accessors

closed

get closed(): boolean
如果路径起点与终点相同，则为闭合路径，否则为开放路径。

Returns boolean

distance

get distance(): number
按序计算每个路径点的距离，并获取各个长度的合计值。

Returns
路径的总长度

Returns number

points

get points(): Vector3[]
获取构成路径的点集。

Returns
路径内部的点集

Returns Vector3[]

Methods

addPoint

addPoint(x: number, y: number, z: number): Path3
通过指定坐标的点，向当前路径末端他增加线段。

Returns
更新后的当前路径
Parameters
- x: number
  
  加入点的 x 坐标
- y: number
  
  加入点的 y 坐标
- z: number
  
  加入点的 z 坐标
Returns Path3
addPoint(point: Vector3): Path3
通过指定坐标的点，向当前路径末端他增加线段。

Returns
更新后的当前路径
Parameters
- point: Vector3
  
  线段的终点，需要是一个坐标点
Returns Path3

close

close(): Path3
将开放路径闭合，如果已经是闭合路径，则不做任何操作。

Returns
更新后的当前路径

Returns Path3

getPointAtDistance

getPointAtDistance(distance: number): Vector3
在路径上获取由起点开始，指定路径长度的点。

Returns
指定路径长度的点
Parameters
- distance: number
  
  由起点开始的路径长度
Returns Vector3

getPointAtPercent

getPointAtPercent(percent: number): Vector3
在路径上获取由起点开始，指定路径长度比例(0~1)的点。

Returns
指定路径长度比例的点
Parameters
- percent: number
  
  由起点开始的路径长度比例
Returns Vector3

`Static` FromPoints

FromPoints(points: Vector3[]): Path3
由给定的点集构造一个新有向路径。

Returns
新的路径
Parameters
- points: Vector3[]
  
  表示路径的点集
Returns Path3