Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
flash.geom 

Utils3D  - AS3

Packageflash.geom
Classepublic class Utils3D
HéritageUtils3D Inheritance Object

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

La classe Utils3D contient des méthodes statiques qui simplifient l’implémentation de certaines opérations de matrices tridimensionnelles.

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
Méthodes publiques
 MéthodeDéfini par
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.
Object
  
pointTowards(percent:Number, mat:Matrix3D, pos:Vector3D, at:Vector3D = null, up:Vector3D = null):Matrix3D
[statique] Interpole l’orientation d’un objet par rapport à une position.
Utils3D
  
[statique] A l’aide d’un objet de projection Matrix3D, projette un objet Vector3D d’une coordonnée spatiale vers une autre.
Utils3D
  
projectVectors(m:Matrix3D, verts:Vector.<Number>, projectedVerts:Vector.<Number>, uvts:Vector.<Number>):void
[statique] A l’aide d’un objet de projection Matrix3D, projette un vecteur de coordonnées tridimensionnelles (verts) sur un vecteur de coordonnées bidimensionnelles (projectedVerts).
Utils3D
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l’objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
Détails de la méthode

pointTowards

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

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Interpole l’orientation d’un objet par rapport à une position. La méthode pointTowards() combine les fonctionnalités des méthodes Matrix3D.pointAt() et Matrix3D.interpolateTo().

La méthode pointTowards() autorise des modifications en place de l’orientation. Elle décompose la Matrix3D de l’objet d’affichage et remplace les éléments de rotation par ceux qui entraînent une rotation en pourcentage vers la position de la cible. L’objet peut se tourner progressivement vers la cible tout en continuant à se déplacer dans sa propre direction. Les appels consécutifs à la méthode pointTowards() suivis d’une méthode de translation peuvent produire l’animation d’un objet poursuivant une cible en déplacement. Commencez par faire pointer l’objet d’un pour cent vers la cible, puis déplacez progressivement (par incrément) l’objet le long d’un axe.

Paramètres

percent:Number — Nombre compris entre 0 et 1 qui tourne progressivement (par incrément) l’objet vers la cible.
 
mat:Matrix3D — Propriété Matrix3D de l’objet transformé.
 
pos:Vector3D — Position par rapport au monde de l’objet cible. Le terme « par rapport au monde » définit la transformation de l’objet par rapport à l’espace monde et aux coordonnées, dans lequel tous les objets sont positionnés.
 
at:Vector3D (default = null) — Vecteur relatif à l’objet qui définit l’endroit vers lequel pointe l’objet d’affichage. Le terme « relatif à l’objet » définit la transformation de l’objet par rapport à l’espace objet, la propre image de référence de l’objet et son propre système de coordonnées. La valeur par défaut est (0,0,-1).
 
up:Vector3D (default = null) — Vecteur relatif à l’objet qui définit « up » pour l’objet d’affichage. Si l’objet est dessiné tel que regardant vers le bas à partir du point ci-dessus, l’axe +z est son vecteur « up ». Le terme « relatif à l’objet » définit la transformation de l’objet par rapport à l’espace objet, la propre image de référence de l’objet et son propre système de coordonnées. La valeur par défaut est (0,-1,0).

Valeur renvoyée
Matrix3D — Version modifiée de l’objet Matrix3D spécifié dans le second paramètre. Pour transformer l’objet d’affichage à l’aide de la méthode pointTowards(), définissez la propriété Matrix3D de l’objet d’affichage sur l’objet Matrix3D renvoyé.

Eléments de l’API associés

projectVector

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

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

A l’aide d’un objet de projection Matrix3D, projette un objet Vector3D d’une coordonnée spatiale vers une autre. La méthode projectVector() est identique à la méthode Matrix3D.transformVector() si ce n’est que la méthode projectVector() divise les éléments x, y et z de l’objet Vector3D d’origine par la valeur de profondeur de la projection. La valeur de profondeur est la distance qui sépare l’oeil de l’objet Vector3D dans l’espace visuel ou d’affichage. La valeur par défaut de cette distance est celle de l’élément z.

Paramètres

m:Matrix3D — Objet de projection Matrix3D qui implémente la transformation de la projection. Si un objet d’affichage dispose d’un objet PerspectiveProjection, vous pouvez utiliser la méthode perspectiveProjection.toMatrix() pour produire un objet de projection Matrix3D s’appliquant aux enfants de l’objet d’affichage. Pour des projections plus avancées, utilisez la propriété matrix3D.rawData pour créer une matrice de projection personnalisée. Aucune méthode Matrix3D intégrée ne permet de créer un objet de projection Matrix3D.
 
v:Vector3D — Objet Vector3D projeté vers une nouvelle coordonnée spatiale.

Valeur renvoyée
Vector3D — Nouveau Vector3D avec une coordonnée spatiale transformée.

Eléments de l’API associés

projectVectors

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

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

A l’aide d’un objet de projection Matrix3D, projette un vecteur de coordonnées tridimensionnelles (verts) sur un vecteur de coordonnées bidimensionnelles (projectedVerts). L’objet Vector projeté doit être préaffecté avant d’être utilisé comme paramètre.

La méthode projectVectors() définit également la valeur t des données uvt. Il est préférable de préaffecter l’objet Vector détenant les données uvts de chaque jeu de coordonnées d’un objet Vector projeté. De la même façon, spécifiez les valeurs u et v des données uvt. Les données uvt représentent un vecteur de coordonnées normalisées utilisé pour le mappage de la texture. Dans coordonnées UV, (0,0) est le coin supérieur gauche de l’image bitmap et (1,1) le coin inférieur droit.

Cette méthode peut être utilisée en combinaison avec la méthode Graphics.drawTriangles() et la classe GraphicsTrianglePath.

Paramètres

m:Matrix3D — Objet de projection Matrix3D qui implémente la transformation de la projection. Vous pouvez produire un objet de projection Matrix3D à l’aide de la propriété Matrix3D.rawData.
 
verts:Vector.<Number> — Vecteur de nombres, où chaque triplet de nombres représentent les coordonnées x, y et z d’un espace tridimensionnel, tel que Vector3D(x,y,z).
 
projectedVerts:Vector.<Number> — Vecteur de nombres, où chaque paire de nombres représente une coordonnée bidimensionnelle projetée, telle que Point(x,y). Il est préférable de préaffecter l’objet Vector. La méthode projectVectors() remplit les valeurs de chaque point projeté.
 
uvts:Vector.<Number> — Vecteur de nombres, où chaque triplet de nombres représente les éléments u, v et t des données uvt. Les valeurs u et v représentent la coordonnée de texture de chaque point projeté. La valeur t est la valeur de profondeur de la projection, ou distance entre l’oeil et l’objet Vector3D dans l’espace d’affichage ou visuel. Il est préférable de préaffecter le vecteur et de spécifier les valeurs u et v. La méthode projectVectors() renseigne la valeur t de chaque point projeté.

Eléments de l’API associés





[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.