Vector3D

Pacchetto	flash.geom
Classe	public class Vector3D
Ereditarietà	Vector3D Object

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

La classe Vector3D rappresenta un punto o una posizione nello spazio tridimensionale utilizzando le coordinate cartesiane x, y e z. Come nello spazio bidimensionale, la proprietà x rappresenta l'asse orizzontale e la proprietà y quello verticale. Nello spazio tridimensionale, la proprietà z rappresenta la profondità. Il valore della proprietà x aumenta mentre l'oggetto si sposta a destra. Il valore della proprietà y aumenta mentre l'oggetto si sposta in basso. Il valore della proprietà z aumenta mentre l'oggetto si sposta lontano dal punto di vista. Se si utilizza la proiezione prospettica e la modifica in scala, l'oggetto appare più grande quando è vicino e più piccolo quando è più lontano dallo schermo. Come in un sistema di coordinate destrorse, l'asse z positivo punta nella direzione opposta all'osservatore, mentre il valore della proprietà z aumenta mentre l'oggetto si allontana dall'occhio dell'osservatore. Il punto di origine (0,0,0) dello spazio globale è l'angolo superiore sinistro dello stage.

Assi X, Y, Z

La classe Vector3D può anche rappresentare una direzione, quale una freccia dal punto di origine delle coordinate, ad esempio (0,0,0), a un punto finale; oppure un componente a virgola mobile di un modello di colore RGB (Red, Green, Blue).

La notazione basata su quaternione introduce un quarto elemento, la proprietà w, che fornisce ulteriori informazioni sull'orientamento. La proprietà w, ad esempio, può definire un angolo di rotazione di un oggetto Vector3D. La combinazione dell'angolo di rotazione con le coordinate x, y e z può determinare l'orientamento dell'oggetto di visualizzazione. Di seguito è riportata una rappresentazione di elementi Vector3D in notazione di matrici:

Elementi Vector3D

Elementi API correlati

flash.display.DisplayObject
flash.geom.Point
flash.geom.Matrix3D
flash.geom.Utils3D
Vector

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		length : Number [sola lettura] La lunghezza, o grandezza, dell'oggetto Vector3D corrente dall'origine (0,0,0) alle coordinate x, y e z dell'oggetto.	Vector3D
		lengthSquared : Number [sola lettura] Il quadrato della lunghezza dell'oggetto Vector3D corrente, calcolato utilizzando le proprietà x, y e z.	Vector3D
		w : Number Il quarto elemento di un oggetto Vector3D (oltre alle proprietà x, y e z) può includere dati quale l'angolo di rotazione.	Vector3D
		x : Number Il primo elemento di un oggetto Vector3D, ad esempio la coordinata x di un punto nello spazio tridimensionale.	Vector3D
		y : Number Il secondo elemento di un oggetto Vector3D, ad esempio la coordinata y di un punto nello spazio tridimensionale.	Vector3D
		z : Number Il terzo elemento di un oggetto Vector3D, ad esempio la coordinata z di un punto nello spazio tridimensionale.	Vector3D

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		Vector3D(x:Number = 0., y:Number = 0., z:Number = 0., w:Number = 0.) Crea un'istanza di un oggetto Vector3D.	Vector3D
		add(a:Vector3D):Vector3D Somma il valore degli elementi x, y e z dell'oggetto Vector3D corrente ai valori degli elementi x, y e z di un altro oggetto Vector3D.	Vector3D
		angleBetween(a:Vector3D, b:Vector3D):Number [statico] Restituisce l'angolo in radianti tra due vettori.	Vector3D
		clone():Vector3D Restituisce un nuovo oggetto Vector3D che è la copia esatta dell'oggetto Vector3D corrente.	Vector3D
		copyFrom(sourceVector3D:Vector3D):void Copia tutti i dati di vettore dall'oggetto Vector3D di origine all'oggetto Vector3D chiamante.	Vector3D
		crossProduct(a:Vector3D):Vector3D Restituisce un nuovo oggetto Vector3D che è perpendicolare (ad angolo retto) all'oggetto Vector3D corrente e a un altro oggetto Vector3D.	Vector3D
		decrementBy(a:Vector3D):void Diminuisce il valore degli elementi x, y e z dell'oggetto Vector3D corrente in base ai valori degli elementi x, y e z di un oggetto Vector3D specificato.	Vector3D
		distance(pt1:Vector3D, pt2:Vector3D):Number [statico] Restituisce la distanza tra due oggetti Vector3D.	Vector3D
		dotProduct(a:Vector3D):Number Se l'oggetto Vector3D corrente e quello specificato come parametro sono vertici unitari, questo metodo restituisce il coseno dell'angolo tra i due vertici.	Vector3D
		equals(toCompare:Vector3D, allFour:Boolean = false):Boolean Determina se due oggetti Vector3D sono uguali confrontando gli elementi x, y e z dell'oggetto Vector3D corrente con un oggetto Vector3D specificato.	Vector3D
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		incrementBy(a:Vector3D):void Aumenta il valore degli elementi x, y e z dell'oggetto Vector3D corrente in base ai valori degli elementi x, y e z di un oggetto Vector3D specificato.	Vector3D
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		nearEquals(toCompare:Vector3D, tolerance:Number, allFour:Boolean = false):Boolean Confronta gli elementi dell'oggetto Vector3D corrente con gli elementi di un oggetto Vector3D specificato per determinare se sono quasi uguali.	Vector3D
		negate():void Imposta l'oggetto Vector3D corrente sul relativo inverso.	Vector3D
		normalize():Number Converte un oggetto Vector3D in un vettore unitario dividendo i primi tre elementi (x, y, z) per la lunghezza del vettore.	Vector3D
		project():void Divide il valore delle proprietà x, y e z dell'oggetto Vector3D corrente per il valore della relativa proprietà w.	Vector3D
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		scaleBy(s:Number):void Modifica in scala l'oggetto Vector3D corrente di un valore scalare, ovvero una grandezza.	Vector3D
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		setTo(xa:Number, ya:Number, za:Number):void Imposta i membri dell'oggetto Vector3D sui valori specificati.	Vector3D
		subtract(a:Vector3D):Vector3D Sottrae il valore degli elementi x, y e z dell'oggetto Vector3D corrente dai valori degli elementi x, y e z di un altro oggetto Vector3D.	Vector3D
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce una rappresentazione in formato stringa dell'oggetto Vector3D corrente.	Vector3D
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object

Costanti pubbliche

	Costante		Definito da
		X_AXIS : Vector3D [statico] L'asse x definito come un oggetto Vector3D con coordinate (1,0,0).	Vector3D
		Y_AXIS : Vector3D [statico] L'asse y definito come un oggetto Vector3D con coordinate (0,1,0).	Vector3D
		Z_AXIS : Vector3D [statico] L'asse z definito come un oggetto Vector3D con coordinate (0,0,1).	Vector3D

Descrizione delle proprietà

length

proprietà

length:Number [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

La lunghezza, o grandezza, dell'oggetto Vector3D corrente dall'origine (0,0,0) alle coordinate x, y e z dell'oggetto. La proprietà w viene ignorata. Un vettore unitario ha una lunghezza o grandezza pari a uno.

Implementazione
public function get length():Number

Elementi API correlati

lengthSquared

proprietà

lengthSquared:Number [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Il quadrato della lunghezza dell'oggetto Vector3D corrente, calcolato utilizzando le proprietà x, y e z. La proprietà w viene ignorata. Utilizzate il metodo lengthSquared() ogni volta che è possibile al posto della più lenta chiamata al metodo Math.sqrt() del metodo Vector3D.length().

Implementazione
public function get lengthSquared():Number

Elementi API correlati

length

w

proprietà

public var w:Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Il quarto elemento di un oggetto Vector3D (oltre alle proprietà x, y e z) può includere dati quale l'angolo di rotazione. Il valore predefinito è 0.

La notazione basata su quaternione utilizza un angolo come quarto elemento nel calcolo della rotazione tridimensionale. La proprietà w può essere utilizzata per definire l'angolo di rotazione intorno all'oggetto Vector3D. La combinazione dell'angolo di rotazione con le coordinate (x,y,z) determina l'orientamento dell'oggetto di visualizzazione.

Inoltre, la proprietà w può essere utilizzata come fattore di deformazione prospettica per una posizione tridimensionale proiettata o come valore di trasformazione della proiezione nella rappresentazione di una coordinata tridimensionale proiettata nello spazio bidimensionale. Potete ad esempio creare una matrice di proiezione utilizzando la proprietà Matrix3D.rawData che, quando viene applicata a un oggetto Vector3D, produce un valore di trasformazione nel quarto elemento dell'oggetto Vector3D (la proprietà w). Dividendo gli altri elementi dell'oggetto Vector3D per il valore di trasformazione, viene generato un oggetto Vector3D proiettato. Potete utilizzare il metodo Vector3D.project() per dividere i primi tre elementi di un oggetto Vector3D per il quarto elemento dell'oggetto stesso.

Elementi API correlati

project()

x

proprietà

public var x:Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Il primo elemento di un oggetto Vector3D, ad esempio la coordinata x di un punto nello spazio tridimensionale. Il valore predefinito è 0.

y

proprietà

public var y:Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Il secondo elemento di un oggetto Vector3D, ad esempio la coordinata y di un punto nello spazio tridimensionale. Il valore predefinito è 0.

z

proprietà

public var z:Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Il terzo elemento di un oggetto Vector3D, ad esempio la coordinata z di un punto nello spazio tridimensionale. Il valore predefinito è 0.

Descrizione della funzione di costruzione

()

Funzione di costruzione

public function Vector3D(x:Number = 0., y:Number = 0., z:Number = 0., w:Number = 0.)

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Crea un'istanza di un oggetto Vector3D. Se non specificate un parametro per la funzione di costruzione, viene creato un oggetto Vector3D con gli elementi (0,0,0,0).

Parametri

	`x:Number` (default = `0.`) — Il primo elemento, ad esempio la coordinata x.

	`y:Number` (default = `0.`) — Il secondo elemento, ad esempio la coordinata y.

	`z:Number` (default = `0.`) — Il terzo elemento, ad esempio la coordinata z.

	`w:Number` (default = `0.`) — Un elemento opzionale per i dati aggiuntivi, quale l'angolo di rotazione.

Descrizione dei metodi

add

()

metodo

public function add(a:Vector3D):Vector3D

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Somma il valore degli elementi x, y e z dell'oggetto Vector3D corrente ai valori degli elementi x, y e z di un altro oggetto Vector3D. Il metodo add() non modifica l'oggetto Vector3D corrente. Al contrario, restituisce un nuovo oggetto Vector3D con nuovi valori.

Il risultato della somma di due vettori è un vettore risultante. Un modo per visualizzare il risultato consiste nel disegnare un vettore dall'origine, o coda, del primo vettore alla fine, o testa, del secondo vettore. Il vettore risultante è la distanza tra il punto di origine del primo vettore e il punto finale del secondo vettore.

Vector3D risultante

Parametri

a:Vector3D — Un oggetto Vector3D da sommare all'oggetto Vector3D corrente.

Restituisce

Vector3D — Un oggetto Vector3D risultante dalla somma dell'oggetto Vector3D corrente a un altro oggetto Vector3D.

Elementi API correlati

incrementBy()

angleBetween

()

metodo

public static function angleBetween(a:Vector3D, b:Vector3D):Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Restituisce l'angolo in radianti tra due vettori. Se l'angolo restituito è il radiante inferiore, il primo oggetto Vector3D ruota finché non si allinea con il secondo oggetto Vector3D.

Il metodo angleBetween() è di tipo statico. Potete utilizzarlo direttamente come un metodo della classe Vector3D.

Per convertire gradi in radianti, potete utilizzare la formula seguente:

radian = Math.PI/180 * degree

Parametri

	`a:Vector3D` — Il primo oggetto Vector3D.

	`b:Vector3D` — Il secondo oggetto Vector3D.

Restituisce

Number — L'angolo tra due oggetti Vector3D.

clone

()

metodo

public function clone():Vector3D

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Restituisce un nuovo oggetto Vector3D che è la copia esatta dell'oggetto Vector3D corrente.

Restituisce

Vector3D — Un nuovo oggetto Vector3D che è la copia dell'oggetto Vector3D corrente.

copyFrom

()

metodo

public function copyFrom(sourceVector3D:Vector3D):void

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 11, AIR 3.0, Flash Lite 4

Copia tutti i dati di vettore dall'oggetto Vector3D di origine all'oggetto Vector3D chiamante.

Parametri

sourceVector3D:Vector3D — L'oggetto Vector3D da cui copiare i dati.

crossProduct

()

metodo

public function crossProduct(a:Vector3D):Vector3D

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Restituisce un nuovo oggetto Vector3D che è perpendicolare (ad angolo retto) all'oggetto Vector3D corrente e a un altro oggetto Vector3D. Se le coordinate dell'oggetto Vector3D restituito sono (0,0,0), significa che i due oggetti Vector3D sono paralleli tra di essi.

Prodotto vettoriale

Potete usare il prodotto vettoriale normalizzato di due vertici di una superficie poligonale con il vettore normalizzato del punto di vista della videocamera o dell'occhio per ottenere un prodotto scalare. Il valore del prodotto scalare può identificare se una superficie di un oggetto tridimensionale viene nascosto dal punto di vista.

Parametri

a:Vector3D — Un secondo oggetto Vector3D.

Restituisce

Vector3D — Un nuovo oggetto Vector3D che è perpendicolare all'oggetto Vector3D corrente e all'oggetto Vector3D specificato come parametro.

Elementi API correlati

dotProduct()
normalize()

decrementBy

()

metodo

public function decrementBy(a:Vector3D):void

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Diminuisce il valore degli elementi x, y e z dell'oggetto Vector3D corrente in base ai valori degli elementi x, y e z di un oggetto Vector3D specificato. A differenza del metodo Vector3D.subtract(), il metodo decrementBy() modifica l'oggetto Vector3D corrente e non restituisce un nuovo oggetto Vector3D.

Parametri

a:Vector3D — L'oggetto Vector3D che contiene i valori da sottrarre dall'oggetto Vector3D corrente.

Elementi API correlati

subtract()

distance

()

metodo

public static function distance(pt1:Vector3D, pt2:Vector3D):Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Restituisce la distanza tra due oggetti Vector3D. Il metodo distance() è di tipo statico. Potete utilizzarlo direttamente come un metodo della classe Vector3D per ottenere la distanza euclidea tra due punti tridimensionali.

Parametri

	`pt1:Vector3D` — Un oggetto Vector3D come primo punto tridimensionale.

	`pt2:Vector3D` — Un oggetto Vector3D come secondo punto tridimensionale.

Restituisce

Number — La distanza tra due oggetti Vector3D.

dotProduct

()

metodo

public function dotProduct(a:Vector3D):Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Se l'oggetto Vector3D corrente e quello specificato come parametro sono vertici unitari, questo metodo restituisce il coseno dell'angolo tra i due vertici. I vertici unitari sono vertici che puntano nella stessa direzione ma la cui lunghezza è uno. Rimuovono la lunghezza del vettore come fattore del risultato. Potete utilizzare il metodo normalize() per convertire un vettore in vettore unitario.

Il metodo dotProduct() trova l'angolo tra due vertici. Viene utilizzato anche nei calcoli per il backface culling (eliminazione delle facce posteriori) o l'illuminazione. Il backface culling è una procedura che consente di determinare quali superfici vengono nascoste dal punto di vista. Potete utilizzare i vertici normalizzati dal punto di vista della videocamera, o dell'occhio, e il prodotto vettoriale dei vertici di una superficie poligonale per ottenere il prodotto scalare. Se il prodotto scalare è inferiore a zero, la superficie è rivolta verso la videocamera o l'osservatore. Se i due vertici unitari sono perpendicolari tra di essi, sono ortogonali e il prodotto scalare è pari a zero. Se i due vertici unitari sono paralleli tra di essi, il prodotto scalare è pari a uno.

Parametri

a:Vector3D — Il secondo oggetto Vector3D.

Restituisce

Number — Un valore scalare che corrisponde al prodotto scalare dell'oggetto Vector3D corrente e dell'oggetto Vector3D specificato.

Elementi API correlati

crossProduct()
normalize()

equals

()

metodo

public function equals(toCompare:Vector3D, allFour:Boolean = false):Boolean

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Determina se due oggetti Vector3D sono uguali confrontando gli elementi x, y e z dell'oggetto Vector3D corrente con un oggetto Vector3D specificato. Se i valori di questi elementi sono gli stessi, i due oggetti Vector3D sono uguali. Se il secondo parametro opzionale è impostato su true, vengono confrontati tutti e quattro gli elementi degli oggetti Vector3D, inclusa la proprietà w.

Parametri

	`toCompare:Vector3D` — L'oggetto Vector3D da confrontare con l'oggetto Vector3D corrente.

	`allFour:Boolean` (default = `false`) — Un parametro opzionale che specifica se la proprietà `w` degli oggetti Vector3D viene utilizzata nel confronto.

Restituisce

Boolean — Un valore true se l'oggetto Vector3D specificato è uguale all'oggetto Vector3D corrente; false se non è uguale.

Elementi API correlati

nearEquals()

incrementBy

()

metodo

public function incrementBy(a:Vector3D):void

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Aumenta il valore degli elementi x, y e z dell'oggetto Vector3D corrente in base ai valori degli elementi x, y e z di un oggetto Vector3D specificato. A differenza del metodo Vector3D.add(), il metodo incrementBy() modifica l'oggetto Vector3D corrente e non restituisce un nuovo oggetto Vector3D.

Parametri

a:Vector3D — L'oggetto Vector3D da sommare all'oggetto Vector3D corrente.

Elementi API correlati

add()

nearEquals

()

metodo

public function nearEquals(toCompare:Vector3D, tolerance:Number, allFour:Boolean = false):Boolean

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Confronta gli elementi dell'oggetto Vector3D corrente con gli elementi di un oggetto Vector3D specificato per determinare se sono quasi uguali. I due oggetti Vector3D sono quasi uguali se il valore di tutti gli elementi dei due vertici sono uguali, oppure il risultato del confronto è compreso nell'intervallo di tolleranza. La differenza tra due elementi deve essere minore del numero specificato come parametro tolerance. Se il terzo parametro opzionale è impostato su true, vengono confrontati tutti e quattro gli elementi degli oggetti Vector3D, inclusa la proprietà w. In caso contrario, vengono inclusi nel confronto solo gli elementi x, y e z.

Parametri

	`toCompare:Vector3D` — L'oggetto Vector3D da confrontare con l'oggetto Vector3D corrente.

	`tolerance:Number` — Un numero che determina il fattore di tolleranza. Se la differenza tra i valori dell'elemento Vector3D specificato nel parametro `toCompare` e l'elemento Vector3D corrente è inferiore al numero di tolleranza, i due valori sono considerati quasi uguali.

	`allFour:Boolean` (default = `false`) — Un parametro opzionale che specifica se la proprietà `w` degli oggetti Vector3D viene utilizzata nel confronto.

Restituisce

Boolean — Un valore true se l'oggetto Vector3D specificato è quasi uguale all'oggetto Vector3D corrente; false se non è uguale.

Elementi API correlati

equals()

negate

()

metodo

public function negate():void

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Imposta l'oggetto Vector3D corrente sul relativo inverso. L'oggetto inverso viene anche considerato l'opposto dell'oggetto originale. Il valore delle proprietà x, y e z dell'oggetto Vector3D corrente viene modificato in -x, -y e -z.

normalize

()

metodo

public function normalize():Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Converte un oggetto Vector3D in un vettore unitario dividendo i primi tre elementi (x, y, z) per la lunghezza del vettore. I vertici unitari sono vertici che hanno una direzione ma la cui lunghezza è uno. Semplificano i calcoli vettoriali rimuovendo la lunghezza come fattore.

Restituisce

Number — La lunghezza dell'oggetto Vector3D corrente.

project

()

metodo

public function project():void

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Divide il valore delle proprietà x, y e z dell'oggetto Vector3D corrente per il valore della relativa proprietà w.

Se l'oggetto Vector3D corrente è il risultato della moltiplicazione di un oggetto Vector3D per un oggetto di proiezione Matrix3D, la proprietà w può includere il valore di trasformazione. Il metodo project() può quindi completare la proiezione dividendo gli elementi per la proprietà w. Utilizzate la proprietà Matrix3D.rawData per creare un oggetto di proiezione Matrix3D.

scaleBy

()

metodo

public function scaleBy(s:Number):void

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Modifica in scala l'oggetto Vector3D corrente di un valore scalare, ovvero una grandezza. Gli elementi x, y e z di un oggetto Vector3D vengono moltiplicati per il numero scalare specificato nel parametro. Se ad esempio il vettore viene modificato in scala per dieci, il risultato è un vettore dieci volte più lungo. Il valore scalare può anche modificare la direzione del vettore. Moltiplicando il vettore per un numero negativo, se ne inverte la direzione.

Parametri

s:Number — Un moltiplicatore (scalare) utilizzato per la modifica in scala di un oggetto Vector3D.

setTo

()

metodo

public function setTo(xa:Number, ya:Number, za:Number):void

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 11, AIR 3.0, Flash Lite 4

Imposta i membri dell'oggetto Vector3D sui valori specificati.

Parametri

	`xa:Number` — I valori su cui impostare il vettore.

	`ya:Number`

	`za:Number`

subtract

()

metodo

public function subtract(a:Vector3D):Vector3D

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Sottrae il valore degli elementi x, y e z dell'oggetto Vector3D corrente dai valori degli elementi x, y e z di un altro oggetto Vector3D. Il metodo subtract() non modifica l'oggetto Vector3D corrente. Al contrario, restituisce un nuovo oggetto Vector3D con nuovi valori.

Parametri

a:Vector3D — L'oggetto Vector3D da sottrarre dall'oggetto Vector3D corrente.

Restituisce

Vector3D — Un nuovo oggetto Vector3D che corrisponde alla differenza tra l'oggetto Vector3D corrente e l'oggetto Vector3D specificato.

Elementi API correlati

decrementBy()

toString

()

metodo

public function toString():String

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Restituisce una rappresentazione in formato stringa dell'oggetto Vector3D corrente. La stringa contiene i valori delle proprietà x, y e z.

Restituisce

String — Una stringa contenente i valori delle proprietà x, y e z.

Descrizione delle costanti

X_AXIS

Costante

public static const X_AXIS:Vector3D

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

L'asse x definito come un oggetto Vector3D con coordinate (1,0,0).

Y_AXIS

Costante

public static const Y_AXIS:Vector3D

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

L'asse y definito come un oggetto Vector3D con coordinate (0,1,0).

Z_AXIS

Costante

public static const Z_AXIS:Vector3D

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

L'asse z definito come un oggetto Vector3D con coordinate (0,0,1).

Note legali | Informativa sulla privacy online

Vector3D - AS3

Pacchettix

Elementi del linguaggio

Appendici

Pacchetto flash.geom

length

lengthSquared

w

x

y

z

Vector3D

add

angleBetween

clone

copyFrom

crossProduct

decrementBy

distance

dotProduct

equals

incrementBy

nearEquals

negate

normalize

project

scaleBy

setTo

subtract

toString

X_AXIS

Y_AXIS

Z_AXIS