[page:Curve] → [page:CurvePath] →

路径([name])

该类定义了二维路径,提供了一些类似2D Canvas API的方法来创建或者构造二维路径。

代码示例

const path = new THREE.Path(); path.lineTo( 0, 0.8 ); path.quadraticCurveTo( 0, 1, 0.2, 1 ); path.lineTo( 1, 1 ); const points = path.getPoints(); const geometry = new THREE.BufferGeometry().setFromPoints( points ); const material = new THREE.LineBasicMaterial( { color: 0xffffff } ); const line = new THREE.Line( geometry, material ); scene.add( line );

构造函数

[name]( [param:Array points] )

points -- (可选)[page:Vector2 Vector2s]数组。

从传入的点中创建一条Path。第一个点定义了偏移量, 接下来的点作为[page:LineCurve LineCurves]被添加到[page:CurvePath.curves curves]数组中。

倘若没有点被指定,一条空路径将会被创建,[page:.currentPoint]将被设置为原点。

属性

共有属性请参见其基类[page:CurvePath]。

[property:Vector2 currentPoint]

路径当前的偏移量,任何新被加入的[page:Curve]将会从这里开始。

方法

共有方法请参见其基类[page:CurvePath]。

[method:this absarc]( [param:Float x], [param:Float y], [param:Float radius], [param:Float startAngle], [param:Float endAngle], [param:Boolean clockwise] )

x, y -- 弧线的绝对中心。
radius -- 弧线的半径。
startAngle -- 起始角,以弧度来表示。
endAngle -- 终止角,以弧度来表示。
clockwise -- 以顺时针方向创建(扫过)弧线。默认值为*false*。

添加一条绝对定位的[page:EllipseCurve EllipseCurve]到路径中。

[method:this absellipse]( [param:Float x], [param:Float y], [param:Float xRadius], [param:Float yRadius], [param:Float startAngle], [param:Float endAngle], [param:Boolean clockwise], [param:Float rotation] )

x, y -- 椭圆的绝对中心。
xRadius -- 椭圆x轴方向的半径。
yRadius -- 椭圆y轴方向的半径。
startAngle -- 起始角,以弧度来表示。
endAngle -- 终止角,以弧度来表示。
clockwise -- 以顺时针方向创建(扫过)椭圆。默认值为*false*。
rotation -- 椭圆从X轴正方向逆时针的旋转角度(可选),以弧度表示,默认值为*0*。

添加一条绝对定位的[page:EllipseCurve EllipseCurve]到路径中。

[method:this arc]( [param:Float x], [param:Float y], [param:Float radius], [param:Float startAngle], [param:Float endAngle], [param:Boolean clockwise] )

x, y -- 弧线的中心来自上次调用后的偏移量。
radius -- 弧线的半径。
startAngle -- 起始角,以弧度来表示。
endAngle -- 终止角,以弧度来表示。
clockwise -- 以顺时针方向创建(扫过)弧线。默认值为*false*。

添加一条[page:EllipseCurve EllipseCurve]到路径中,位置相对于[page:.currentPoint]。

[method:this bezierCurveTo]( [param:Float cp1X], [param:Float cp1Y], [param:Float cp2X], [param:Float cp2Y], [param:Float x], [param:Float y] )

从[page:.currentPoint]创建一条贝塞尔曲线,以(cp1X, cp1Y)和(cp2X, cp2Y)作为控制点,并将[page:.currentPoint]更新到x,y。

[method:this ellipse]( [param:Float x], [param:Float y], [param:Float xRadius], [param:Float yRadius], [param:Float startAngle], [param:Float endAngle], [param:Boolean clockwise], [param:Float rotation] )

x, y -- 椭圆的中心来自上次调用后的偏移量。The center of the ellipse offset from the last call.
xRadius -- 椭圆x轴方向的半径。
yRadius -- 椭圆y轴方向的半径。
startAngle -- 起始角,以弧度来表示。
endAngle -- 终止角,以弧度来表示。
clockwise -- 以顺时针方向创建(扫过)椭圆。默认值为*false*。
rotation -- 椭圆从X轴正方向逆时针的旋转角度(可选),以弧度表示,默认值为*0*。

添加一条[page:EllipseCurve EllipseCurve]到路径中,位置相对于[page:.currentPoint]。

[method:this lineTo]( [param:Float x], [param:Float y] )

在当前路径上,从[page:.currentPoint]连接一条直线到x,y。

[method:this moveTo]( [param:Float x], [param:Float y] )

将[page:.currentPoint]移动到x, y。

[method:this quadraticCurveTo]( [param:Float cpX], [param:Float cpY], [param:Float x], [param:Float y] )

从[page:.currentPoint]创建一条二次曲线,以(cpX,cpY)作为控制点,并将[page:.currentPoint]更新到x,y。

[method:this setFromPoints]( [param:Array vector2s] )

points -- [page:Vector2 Vector2]数组。

点将被作为[page:LineCurve LineCurves]加入到[page:CurvePath.curves curves]数组中。

[method:this splineThru] ( [param:Array points] )

points -[page:Vector2 Vector2]数组。

连接一条新的[page:SplineCurve]到路径上。

源代码

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]