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

# [name]

Definisce un piano di forma 2D arbitrario usando percorsi con hole opzionali. Può essere usato con [page:ExtrudeGeometry], [page:ShapeGeometry], per ottenere punti, o per ottenere facce triangolate.

## Codice di Esempio

`const 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 ); const extrudeSettings = { depth: 8, bevelEnabled: true, bevelSegments: 2, steps: 2, bevelSize: 1, bevelThickness: 1 }; const geometry = new THREE.ExtrudeGeometry( heartShape, extrudeSettings ); const mesh = new THREE.Mesh( geometry, new THREE.MeshPhongMaterial() );`

## Esempi

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

## Costruttore

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

points -- (opzionale) un array di [page:Vector2 Vector2].
Crea una Shape dai punti. Il primo punto defisce l'offset, quindi i punti successivi vengono aggiunti all'array [page:CurvePath.curves curves] come [page:LineCurve LineCurves].
Se i punti non vengono specificati, viene creata una shape vuota e il [page:.currentPoint] viene impostato nell'origine.

## Proprietà

Vedi la classe base [page:Path] per le proprietà comuni.

### [property:String uuid]

L'[link:http://en.wikipedia.org/wiki/Universally_unique_identifier UUID] di questa istanza. Viene assegnato automaticamente, quindi non dovrebbe essere modificato.

### [property:Array holes]

Un array di [page:Path path] che definisce gli hole nella forma.

## Metodi

Vedi la classe base [page:Path] per i metodi comuni.

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

divisions -- La finezza del risultato.
Chiama [page:Curve.getPoints getPoints] sulla forma e l'array [page:.holes], e restituisce un oggetto della forma: `{ shape holes }` dove shape e holes sono array di tipo [page:Vector2 Vector2].

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

divisions -- La finezza del risultato.
Ottiene un array di [page:Vector2 Vector2] che rapprensenta gli hole nella forma.

## Source

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