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

# 形状（[name]）

使用路径以及可选的孔洞来定义一个二维形状平面。 它可以和[page:ExtrudeGeometry]、[page:ShapeGeometry]一起使用，获取点，或者获取三角面。

`var heartShape = new THREE.Shape(); heartShape.moveTo( 25, 25 ); heartShape.bezierCurveTo( 25, 25, 20, 0, 0, 0 ); heartShape.bezierCurveTo( 30, 0, 30, 35,30,35 ); heartShape.bezierCurveTo( 30, 55, 10, 77, 25, 95 ); heartShape.bezierCurveTo( 60, 77, 80, 55, 80, 35 ); heartShape.bezierCurveTo( 80, 35, 80, 0, 50, 0 ); heartShape.bezierCurveTo( 35, 0, 25, 25, 25, 25 ); var extrudeSettings = { amount: 8, bevelEnabled: true, bevelSegments: 2, steps: 2, bevelSize: 1, bevelThickness: 1 }; var geometry = new THREE.ExtrudeGeometry( heartShape, extrudeSettings ); var mesh = new THREE.Mesh( geometry, new THREE.MeshPhongMaterial() );`

## 示例

[example:webgl_geometry_shapes geometry / shapes ]
[example:webgl_geometry_extrude_shapes geometry / extrude / shapes ]
[example:webgl_geometry_extrude_shapes2 geometry / extrude / shapes2 ]

## 构造函数

### [name]( [param:Array points] )

points -- (optional) 一个[page:Vector2 Vector2]数组。
从点来创建一个Shape。第一个点定义了偏移量， 接下来的点被作为[page:LineCurve LineCurves]加入到[page:CurvePath.curves curves]中。
如果没有点被指定，一个空的形状将会被创建，且[page:.currentPoint]将会被设为原点。

## 属性

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

### [property:String uuid]

该类所创建的实例的[link:http://en.wikipedia.org/wiki/Universally_unique_identifier UUID]。它是自动被指定的，因此它不应当被编辑、更改。

### [property:array holes]

一个[page:Path paths]数组，定义了形状上的孔洞。

## 方法

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

### [method:Array extractPoints]( [param:Integer divisions] )

divisions -- 结果的精细程度（细分数）。
在形状以及[page:.holes]（孔洞）数组上调用[page:Curve.getPoints getPoints]，并返回一个来自于： `{ shape holes }` 的对象，其中的形状和孔洞是[page:Vector2 Vector2]数组。

### [method:Array getPointsHoles]( [param:Integer divisions] )

divisions -- 结果的精细程度（细分数）。
获取一个表示形状上的孔洞的[page:Vector2 Vector2s]数组。

## 源代码

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