# [name]

Classe che rappresenta un [link:https://en.wikipedia.org/wiki/Vector_space vettore] 2D. Un vettore 2D è una coppia ordinata di numeri (etichettati con x e y), che può essere utilizzata per rappresentare una serie di cose, come:

- Un punto nello spazio 2D (cioè una posizione su un piano).
- Una direzione e lunghezza su un piano. In three.js la lunghezza sarà sempre la [link:https://en.wikipedia.org/wiki/Euclidean_distance distanza Euclidea] (distanza in liena retta) da `(0, 0)` a `(x, y)` e anche la direzione viene misurata da `(0, 0)` verso `(x, y)`.
- Qualsiasi coppia di numeri ordinata arbitrariamente.

Ci sono altre cose che possono essere rappresentate da un vettore 2D, come i vettori di quantità di moto, numeri complessi e così via, tuttavia questi sono gli usi comuni in three.js.

L'iterazione di un'istanza [name] produrrà i suoi componenti `(x, y)` nell'ordine corrispondente.

## Codice di Esempio

`const a = new THREE.Vector2( 0, 1 ); // nessun argomento; sarà inizializzato a (0, 0) const b = new THREE.Vector2( ); const d = a.distanceTo( b );`

## Costruttore

### [name]( [param:Float x], [param:Float y] )

[page:Float x] - il valore x di questo vettore. Il valore predefinito è `0`.
[page:Float y] - il valore y di questo vettore. Il valore predefinito è `0`.
Crea un nuovo [name].

## Proprietà

### [property:Float height]

Alternativa per [page:.y y].

### [property:Boolean isVector2]

Flag di sola lettura per verificare che l'oggetto dato sia di tipo [name].

### [property:Float width]

lternativa per [page:.x x].

### [property:Float x]

### [property:Float y]

## Metodi

### [method:this add]( [param:Vector2 v] )

Aggiunge [page:Vector2 v] a questo vettore.

### [method:this addScalar]( [param:Float s] )

Aggiunge il valore scalare [page:Float s] ai valori [page:.x x] e [page:.y y] di questo vettore.

### [method:this addScaledVector]( [param:Vector2 v], [param:Float s] )

Aggiunge il multiplo di [page:Vector2 v] e [page:Float s] a questo vettore.

### [method:this addVectors]( [param:Vector2 a], [param:Vector2 b] )

Imposta questo vettore a [page:Vector2 a] + [page:Vector2 b].

### [method:Float angle]()

Calcola l'angolo in radianti di questo vettore rispetto all'asse x positivo.

### [method:Float angleTo]( [param:Vector2 v] )

Restituisce l'angolo tra questo vettore e il vettore [page:Vector2 v] in radianti.

### [method:this applyMatrix3]( [param:Matrix3 m] )

Moltiplica questo vettore (con un 1 implicito come terza componente) per m.

### [method:this ceil]()

I componenti [page:.x x] e [page:.y y] di questo vettore vengono arrotondati per eccesso al valore intero più vicino.

### [method:this clamp]( [param:Vector2 min], [param:Vector2 max] )

[page:Vector2 min] - i valori minimi x e y.
[page:Vector2 max] - i valori massimi x e y nell'intervallo desiderato.
Se il valore x o y di questo vettore è maggiore del valore x o y del vettore massimo, verrà sostituito dal valore corrispondente.
Se il valore x o y di questo vettore è minore del valore x o y del vettore minimo, verrà sostituito dal valore corrispondente.

### [method:this clampLength]( [param:Float min], [param:Float max] )

[page:Float min] - il valore minimo a cui verrà fissata la lunghezza.
[page:Float max] - il valore massimo a cui verrà fissata la lunghezza.
Se la lunghezza di questo vettore è maggiore del valore massimo, verrà sostituita dal valore massimo.
Se la lunghezza di questo vettore è minore del valore minimo, verrà sostituita dal valore minimo.

### [method:this clampScalar]( [param:Float min], [param:Float max] )

[page:Float min] - il valore minimo a cui verranno fissati i componenti.
[page:Float max] - il valore massimo a cui verranno fissati i componenti.
Se i valori di x o y di questo vettore sono maggiori del valore massimo, verranno sostuiti dal valore massimo.
Se i valori di x o y di questo vettore sono minori del valore minimo, verranno sostuiti dal valore minimo.

### [method:Vector2 clone]()

Restituisce un nuovo Vector2 con gli stessi valori [page:.x x] e [page:.y y] di questo.

### [method:this copy]( [param:Vector2 v] )

Copia i valori delle proprietà [page:.x x] e [page:.y y] del vettore passate di questo Vector2.

### [method:Float distanceTo]( [param:Vector2 v] )

Calcola la distanza da questo vettore a [page:Vector2 v].

### [method:Float manhattanDistanceTo]( [param:Vector2 v] )

Calcola la [link:https://en.wikipedia.org/wiki/Taxicab_geometry distanza Manhattan] da questo vettore a [page:Vector2 v].

### [method:Float distanceToSquared]( [param:Vector2 v] )

Calcola la distanza al quadrato da questo vettore a [page:Vector2 v]. Se stai semplicemente confrontando la distanza con un'altra distanza, dovresti invece confrontare la distanza al quadrato poiché è leggermente più efficiente da calcolare.

### [method:this divide]( [param:Vector2 v] )

Divide questo vettore per [page:Vector2 v].

### [method:this divideScalar]( [param:Float s] )

Divide questo vettore per lo scalare [page:Float s].

### [method:Float dot]( [param:Vector2 v] )

Calcola il [link:https://en.wikipedia.org/wiki/Dot_product prodotto scalare] di questo vettore e [page:Vector2 v].

### [method:Float cross]( [param:Vector2 v] )

Calcola il [link:https://en.wikipedia.org/wiki/Cross_product prodotto vettoriale] di questo vettore e [page:Vector2 v]. Si noti che un 'prodotto vettoriale' in 2D non è ben definito. Questa funzione calcola un prodotto vettoriale geometrico spesso utilizzato nella grafica 2D.

### [method:Boolean equals]( [param:Vector2 v] )

Restituisce `true` se il componente di questo vettore e [page:Vector2 v] sono strettamente uguali; `false` altrimenti.

### [method:this floor]()

I componenti di questo vettore vengono arrotondati per difetto al valore intero più vicino.

### [method:this fromArray]( [param:Array array], [param:Integer offset] )

[page:Array array] - l'array sorgente.
[page:Integer offset] - (opzionale) l'offset nell'array. Il valore predefinito è 0.
Imposta il valore [page:.x x] di questo vettore su `array[ offset ]` e il valore [page:.y y] su `array[ offset + 1 ]`.

### [method:this fromBufferAttribute]( [param:BufferAttribute attribute], [param:Integer index] )

[page:BufferAttribute attribute] - l'array sorgente.
[page:Integer index] - indice nell'attributo.
Imposta i valori [page:.x x] e [page:.y y] di questo vettore nell'[page:BufferAttribute attributo].

### [method:Float getComponent]( [param:Integer index] )

[page:Integer index] - 0 o 1.
Se l'indice è uguale 0 restituisce il valore [page:.x x].
Se l'indice è uguale 1 restituisce il valore [page:.y y].

### [method:Float length]()

Calcola la [link:https://en.wikipedia.org/wiki/Euclidean_distance lunghezza Euclidea] (lunghezza in linea retta) da (0, 0) a (x, y).

### [method:Float manhattanLength]()

Calcola la [link:http://en.wikipedia.org/wiki/Taxicab_geometry lunghezza Manhattan] di questo vettore.

### [method:Float lengthSq]()

Calcola il quadrato della [link:https://en.wikipedia.org/wiki/Euclidean_distance lunghezza Euclidea] (lunghezza in linea retta) da (0, 0) a (x, y). Se stai comparando le lunghezze dei vettori, dovresti invece confrontare la lunghezza quadrata poiché è leggermente più efficiente da calcolare.

### [method:this lerp]( [param:Vector2 v], [param:Float alpha] )

[page:Vector2 v] - [page:Vector2] verso cui interpolare.
[page:Float alpha] - fattore interpolazione, tipicamente nell'intervallo chiuso `[0, 1]`.
Interpola linearmente tra questo vettore e [page:Vector2 v], dove alfa è la distanza percentuale lungo la linea - alfa = 0 sarà questo vettore e alfa = 1 sarà [page:Vector2 v].

### [method:this lerpVectors]( [param:Vector2 v1], [param:Vector2 v2], [param:Float alpha] )

[page:Vector2 v1] - il [page:Vector2] iniziale.
[page:Vector2 v2] - [page:Vector2] verso cui interpolare.
[page:Float alpha] - fattore interpolazione, tipicamente nell'intervallo chiuso `[0, 1]`.
Imposta questo vettore per essere il vettore lineare interpolato tra [page:Vector2 v1] e [page:Vector2 v2] dove alfa è la distanza percentuale lungo la linea che collega i due vettori - alfa = 0 sarà [page:Vector2 v1] e alfa = 1 sarà [page:Vector2 v].

### [method:this negate]()

Inverte questo vettore - cioè imposta x = -x e y = -y.

### [method:this normalize]()

Converte questo vettore ad un [link:https://en.wikipedia.org/wiki/Unit_vector vettore unitario] - cioè, lo imposta uguale ad un vettore con la stessa direzione di questo, ma con [page:.length lunghezza] 1.

### [method:this max]( [param:Vector2 v] )

Se il valore x o y di questo vettore è minore del valore x o y di [page:Vector2 v], sostituisce questo valore con il valore massimo corrispondente.

### [method:this min]( [param:Vector2 v] )

Se il valore x o y di questo vettore è maggiore del valore x o y di [page:Vector2 v], sostituisce questo valore con il valore minimo corrispondente.

### [method:this multiply]( [param:Vector2 v] )

Moltiplica questo vettore per [page:Vector2 v].

### [method:this multiplyScalar]( [param:Float s] )

Moltiplica questo vettore per lo scalare [page:Float s].

### [method:this rotateAround]( [param:Vector2 center], [param:Float angle] )

[page:Vector2 center] - il punto attorno al quale ruotare.
[page:Float angle] - l'angolo di rotazione, in radianti.
Ruota questo vettore attorno al [page:Vector2 centro] di un [page:Float angolo] in radianti.

### [method:this round]()

I componenti di questo vettore vengono arrotondati al valore intero più vicino.

### [method:this roundToZero]()

I componenti di questo vettore vengono arrotondati per difetto (per eccesso se negativo, per difetto se positivo) a un valore intero.

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

Imposta i componenti [page:.x x] e [page:.y y] di questo.

### [method:this setComponent]( [param:Integer index], [param:Float value] )

[page:Integer index] - 0 o 1.
[page:Float value] - [page:Float]
Se l'indice è uguale a 0 imposta [page:.x x] a [page:Float value].
Se l'indice è uguale a 1 imposta [page:.y y] a [page:Float value].

### [method:this setLength]( [param:Float l] )

Imposta questo vettore ad un vettore con la stessa direzione di questo, ma con [page:.length lunghezza] [page:Float l].

### [method:this setScalar]( [param:Float scalar] )

Imposta i valori [page:.x x] e [page:.y y] di questo vettore entrambi uguali allo [page:Float scalare].

### [method:this setX]( [param:Float x] )

Sostuisce il valore di [page:.x x] di questo vettore con [page:Float x].

### [method:this setY]( [param:Float y] )

Sostuisce il valore di [page:.y y] di questo vettore con [page:Float y].

### [method:this sub]( [param:Vector2 v] )

Sottrae [page:Vector2 v] da questo vettore.

### [method:this subScalar]( [param:Float s] )

Sottrae [page:Float s] dai componenti [page:.x x] e [page:.y y] di questo vettore.

### [method:this subVectors]( [param:Vector2 a], [param:Vector2 b] )

Imposta questo vettore a [page:Vector2 a] - [page:Vector2 b].

### [method:Array toArray]( [param:Array array], [param:Integer offset] )

[page:Array array] - (opzionale) array in cui memorizzare questo vettore. Se non viene fornito, verrà creato un nuovo array.
[page:Integer offset] - (opzionale) offset opzionale nell'array.
Restituisce un array [x, y], o copia x e y nell'[page:Array array] fornito.

### [method:this random]()

Imposta ogni componente di questo vettore ad un valore pseudo-random tra 0 e 1, escludendo 1.

## Source

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