Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: Recupero dati dal server...
Recupero dati dal server...
flash.geom 

Utils3D  - AS3

Pacchettoflash.geom
Classepublic class Utils3D
EreditarietàUtils3D Inheritance Object

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

La classe Utils3D contiene metodi statici che semplificano l'implementazione di determinate operazioni di matrice tridimensionali.

Elementi API correlati



Proprietà pubbliche
 ProprietàDefinito da
 Inheritedconstructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
Metodi pubblici
 MetodoDefinito da
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
  
pointTowards(percent:Number, mat:Matrix3D, pos:Vector3D, at:Vector3D = null, up:Vector3D = null):Matrix3D
[statico] Interpola l'orientamento di un oggetto verso una posizione.
Utils3D
  
[statico] Utilizzando un oggetto di proiezione Matrix3D, viene proiettato un oggetto Vector3D da una coordinata dello spazio a un'altra.
Utils3D
  
projectVectors(m:Matrix3D, verts:Vector.<Number>, projectedVerts:Vector.<Number>, uvts:Vector.<Number>):void
[statico] Utilizzando un oggetto di proiezione Matrix3D, viene proiettato un vettore di coordinate dello spazio tridimensionali (verts) su un vettore di coordinate dello spazio bidimensionali (projectedVerts).
Utils3D
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.
Object
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Descrizione dei metodi

pointTowards

()metodo
public static function pointTowards(percent:Number, mat:Matrix3D, pos:Vector3D, at:Vector3D = null, up:Vector3D = null):Matrix3D

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Interpola l'orientamento di un oggetto verso una posizione. Il metodo pointTowards() combina la funzionalità dei metodi Matrix3D.pointAt() e Matrix3D.interpolateTo().

Il metodo pointTowards() consente la modifica in posizione dell'orientamento. Scompone l'elemento Matrix3D dell'oggetto di visualizzazione e sostituisce gli elementi di rotazione con un elemento che imprime una rotazione percentuale verso la posizione del target. L'oggetto può effettuare una rotazione incrementale verso il target continuando a muoversi nella propria direzione. Le chiamate consecutive a pointTowards() seguite da un metodo di conversione possono produrre l'animazione di un oggetto che rincorre o segue un target in movimento. Indirizzate innanzitutto l'oggetto di un punto percentuale verso il target, quindi spostate l'oggetto in modo incrementale lungo un asse.

Parametri

percent:Number — Un numero tra 0 e 1 che orienta in modo incrementale l'oggetto verso il target.
 
mat:Matrix3D — La proprietà Matrix3D dell'oggetto trasformato.
 
pos:Vector3D — La posizione relativa all'ambiente dell'oggetto target. Con "relativa all'ambiente" viene definita la trasformazione dell'oggetto in relazione allo spazio e alle coordinate dell'ambiente in cui sono posizionati tutti gli oggetti.
 
at:Vector3D (default = null) — Il vettore relativo all'oggetto che definisce la direzione verso cui punta l'oggetto. Con "relativo all'oggetto" viene definita la trasformazione dell'oggetto in relazione allo spazio dell'oggetto, il fotogramma di riferimento stesso dell'oggetto e il sistema di coordinate. Il valore predefinito è (0,0,-1).
 
up:Vector3D (default = null) — Il vettore relativo all'oggetto che definisce la direzione "su" per l'oggetto di visualizzazione. Se disegnate l'oggetto rivolto dall'alto verso il basso, l'asse +z rappresenta il suo vettore "su". Con "relativo all'oggetto" viene definita la trasformazione dell'oggetto in relazione allo spazio dell'oggetto, il fotogramma di riferimento stesso dell'oggetto e il sistema di coordinate. Il valore predefinito è (0,-1,0).

Restituisce
Matrix3D — Una versione modificata dell'oggetto Matrix3D specificato nel secondo parametro. Per trasformare l'oggetto di visualizzazione utilizzando il metodo pointTowards(), impostate la proprietà Matrix3D dell'oggetto di visualizzazione sull'oggetto Matrix3D restituito.

Elementi API correlati

projectVector

()metodo 
public static function projectVector(m:Matrix3D, v:Vector3D):Vector3D

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Utilizzando un oggetto di proiezione Matrix3D, viene proiettato un oggetto Vector3D da una coordinata dello spazio a un'altra. Il metodo projectVector()è analogo al metodo Matrix3D.transformVector(), con la sola differenza che il metodo projectVector() divide gli elementi x, y e z dell'oggetto Vector3D in base al valore della profondità di proiezione. Il valore di profondità corrisponde alla distanza dall'occhio all'oggetto Vector3D nello spazio di visualizzazione o visivo. Il valore predefinito per questa distanza è il valore dell'elemento z.

Parametri

m:Matrix3D — Un oggetto di proiezione Matrix3D che implementa la trasformazione della proiezione. Se a un oggetto di visualizzazione è associato un oggetto PerspectiveProjection, potete utilizzare il metodo perspectiveProjection.toMatrix() per generare un oggetto di proiezione Matrix3D applicabile agli elementi secondari dell'oggetto di visualizzazione. Per proiezioni più avanzate, utilizzate la proprietà matrix3D.rawData per creare una matrice di proiezione personalizzata. Non è disponibile un metodo Matrix3D incorporato per la creazione di un oggetto di proiezione Matrix3D.
 
v:Vector3D — L'oggetto Vector3D che viene proiettato su una nuova coordinata dello spazio.

Restituisce
Vector3D — Un nuovo oggetto Vector3D con una coordinata dello spazio trasformata.

Elementi API correlati

projectVectors

()metodo 
public static function projectVectors(m:Matrix3D, verts:Vector.<Number>, projectedVerts:Vector.<Number>, uvts:Vector.<Number>):void

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Utilizzando un oggetto di proiezione Matrix3D, viene proiettato un vettore di coordinate dello spazio tridimensionali (verts) su un vettore di coordinate dello spazio bidimensionali (projectedVerts). L'oggetto vettore proiettato dovrebbe essere allocato prima di utilizzarlo come parametro.

Il metodo projectVectors() imposta anche il valore t dei dati uvt. Si consiglia di allocare preventivamente un vettore che può contenere i dati uvts per ogni gruppo di coordinate del vettore proiettato. Specificate inoltre i valori u e v dei dati uvt. I dati uvt corrispondono a un vettore di coordinate normalizzate utilizzato per applicare il mapping delle texture. Nelle coordinate UV, (0,0) è il vertice superiore sinistro della bitmap e (1,1) è il vertice inferiore destro della bitmap.

Potete utilizzare questo metodo unicamente al metodo Graphics.drawTriangles() e alla classe GraphicsTrianglePath.

Parametri

m:Matrix3D — Un oggetto di proiezione Matrix3D che implementa la trasformazione della proiezione. Potete generare un oggetto di proiezione Matrix3D utilizzando la proprietà Matrix3D.rawData.
 
verts:Vector.<Number> — Un vettore di numeri, dove ogni gruppo di tre numeri rappresenta le coordinate x, y e z di uno spazio tridimensionale, ad esempio Vector3D(x,y,z).
 
projectedVerts:Vector.<Number> — Un vettore di numeri, dove ogni gruppo di due numeri rappresenta una coordinata bidimensionale proiettata, ad esempio Point(x,y). Si consiglia di allocare preventivamente il vettore. Il metodo projectVectors() inserisce i valori per ogni punto proiettato.
 
uvts:Vector.<Number> — Un vettore di numeri, dove ogni gruppo di tre numeri rappresenta gli elementi u, v e t dei dati uvt. u e v sono le coordinate della texture per ogni punto proiettato. Il valore t è il valore di profondità della proiezione, la distanza dall'occhio all'oggetto Vector3D nello spazio di visualizzazione o visivo. Si consiglia di allocare il vettore preventivamente specificando i valori u e v. Il metodo projectVectors() inserisce il valore t per ogni punto proiettato.

Elementi API correlati





[ X ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.