Packageflash.geom
Classepublic class Point
HéritagePoint Inheritance Object

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

L'objet Point représente un emplacement dans un système de coordonnées à deux dimensions où x est l'axe horizontal et y l'axe vertical.

Le code suivant crée un point à (0,0) :

var myPoint:Point = new Point();

Les méthodes et propriétés des classes suivantes utilisent des objets Point :

Vous pouvez utiliser le constructeur new Point() pour créer un objet Point.

Consulter les exemples

Voir aussi

flash.display.BitmapData
flash.display.DisplayObject
flash.display.DisplayObjectContainer
flash.filters.DisplacementMapFilter
flash.geom.Matrix
flash.geom.Rectangle
Utilisation des objets Point

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
  length : Number
[lecture-seule] La longueur du segment de ligne de (0,0) à ce point.
Point
 Inheritedprototype : Object
[static] Référence à l’objet prototype d’un objet de classe ou fonction.
Object
  x : Number
Les coordonnées horizontales du point.
Point
  y : Number
Les coordonnées verticales du point.
Point
Méthodes publiques
 MéthodeDéfini par
  
Point(x:Number = 0, y:Number = 0)
Crée un nouveau point.
Point
  
add(v:Point):Point
Ajoute les coordonnées d’un autre point à celles de ce point pour créer un nouveau point.
Point
  
clone():Point
Crée une copie de cet objet Point.
Point
  
distance(pt1:Point, pt2:Point):Number
[static] Renvoie la distance entre pt1 et pt2.
Point
  
equals(toCompare:Point):Boolean
Détermine si deux points sont égaux.
Point
 Inherited
hasOwnProperty(name:String):Boolean
Indique si la propriété spécifiée d'un objet est définie.
Object
  
interpolate(pt1:Point, pt2:Point, f:Number):Point
[static] Détermine un point entre deux points spécifiés.
Point
 Inherited
isPrototypeOf(theClass:Object):Boolean
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
  
normalize(thickness:Number):void
Met à l’échelle le segment de ligne entre (0,0) et le point actuel en fonction d’une longueur définie.
Point
  
offset(dx:Number, dy:Number):void
Décale l’objet Point de la quantité spécifiée.
Point
  
polar(len:Number, angle:Number):Point
[static] Convertit une paire de coordonnées polaires en coordonnées cartésiennes.
Point
 Inherited
propertyIsEnumerable(name:String):Boolean
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
  
subtract(v:Point):Point
Soustrait les coordonnées d’un autre point à celles de ce point pour créer un nouveau point.
Point
  
toString():String
Renvoie une chaîne qui contient les valeurs des coordonnées x et y.
Point
 Inherited
valueOf():Object
Renvoie la valeur primitive de l'objet spécifié.
Object
Détails des propriétés
lengthpropriété
length:Number  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

La longueur du segment de ligne de (0,0) à ce point.


Implémentation
    public function get length():Number

Voir aussi

Point.polar()
xpropriété 
public var x:Number

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Les coordonnées horizontales du point. La valeur par défaut est 0.

Voir aussi

Utilisation des objets Point
ypropriété 
public var y:Number

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Les coordonnées verticales du point. La valeur par défaut est 0.

Voir aussi

Utilisation des objets Point
Détails du constructeur
Point()Constructeur
public function Point(x:Number = 0, y:Number = 0)

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Crée un nouveau point. Si vous ne transmettez pas de paramètres à cette méthode, un point est créé aux coordonnées (0,0).

Paramètres
x:Number (default = 0) — Coordonnée horizontale.
 
y:Number (default = 0) — Coordonnée verticale.
Détails des méthodes
add()méthode
public function add(v:Point):Point

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Ajoute les coordonnées d’un autre point à celles de ce point pour créer un nouveau point.

Paramètres

v:Point — Le point à ajouter.

Valeur renvoyée
Point — Le nouveau point.
clone()méthode 
public function clone():Point

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Crée une copie de cet objet Point.

Valeur renvoyée
Point — Nouvel objet Point.
distance()méthode 
public static function distance(pt1:Point, pt2:Point):Number

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Renvoie la distance entre pt1 et pt2.

Paramètres

pt1:Point — Le premier point.
 
pt2:Point — Le second point.

Valeur renvoyée
Number — Distance entre le premier et le second point.

Voir aussi

Utilisation des objets Point
equals()méthode 
public function equals(toCompare:Point):Boolean

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Détermine si deux points sont égaux. Deux points sont considérés comme égaux s'ils ont les mêmes valeurs x et y.

Paramètres

toCompare:Point — Point à comparer.

Valeur renvoyée
Boolean — Si l'objet est égal à cet objet Point, true est renvoyé ; false est renvoyé dans le cas contraire.
interpolate()méthode 
public static function interpolate(pt1:Point, pt2:Point, f:Number):Point

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Détermine un point entre deux points spécifiés. Le paramètre f détermine l’emplacement du nouveau point interpolé par rapport aux deux points d'extrémité spécifiés par les paramètres pt1 et pt2. Plus la valeur du paramètre f est proche de 1.0, plus le point interpolé est proche du premier point (paramètre pt1). Plus la valeur du paramètre f est proche de 0, plus le point interpolé est proche du second point (paramètre pt2).

Paramètres

pt1:Point — Le premier point.
 
pt2:Point — Le second point.
 
f:Number — Niveau d'interpolation entre les deux points. Indique l'emplacement du nouveau point sur la ligne reliant pt1 et pt2. Si f=1, pt1 est renvoyé ; si f=0, pt2 est renvoyé.

Valeur renvoyée
Point — Nouveau point, interpolé.
normalize()méthode 
public function normalize(thickness:Number):void

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Met à l’échelle le segment de ligne entre (0,0) et le point actuel en fonction d’une longueur définie.

Paramètres

thickness:Number — Valeur de redimensionnement. Si, par exemple, le point actuel se trouve à (0,5) et que vous le normalisez à 1, les coordonnées du point renvoyé sont (0,1).

Voir aussi

length
offset()méthode 
public function offset(dx:Number, dy:Number):void

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Décale l’objet Point de la quantité spécifiée. La valeur de dx est ajoutée à la valeur d'origine de x pour créer la nouvelle valeur de x. La valeur de dy est ajoutée à la valeur d'origine de y pour créer la nouvelle valeur de y.

Paramètres

dx:Number — Valeur de décalage pour la coordonnée horizontale, x.
 
dy:Number — Valeur de décalage pour la coordonnée verticale, y.

polar()méthode 
public static function polar(len:Number, angle:Number):Point

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Convertit une paire de coordonnées polaires en coordonnées cartésiennes.

Paramètres

len:Number — Coordonnée de longueur de la paire polaire.
 
angle:Number — Angle, en radians, de la paire polaire.

Valeur renvoyée
Point — Point cartésien.

Voir aussi

length
Math.round()
Utilisation des objets Point
subtract()méthode 
public function subtract(v:Point):Point

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Soustrait les coordonnées d’un autre point à celles de ce point pour créer un nouveau point.

Paramètres

v:Point — Point à soustraire.

Valeur renvoyée
Point — Le nouveau point.
toString()méthode 
public function toString():String

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Renvoie une chaîne qui contient les valeurs des coordonnées x et y. La chaîne se présente au format "(x=x, y=y)" ; par conséquent, l’appel de la méthode toString() pour un point se trouvant à 23,17 renvoie "(x=23, y=17)".

Valeur renvoyée
String — Représentation sous forme de chaîne des coordonnées.
Exemples Utilisation des exemples
PointExample.as

L'exemple suivant utilise la classe PointExample pour créer un nombre de nouveaux objets Point à différentes coordonnées x,y, puis il utilise la méthode trace() pour produire les résultats de diverses méthodes de classe. 
package {
    import flash.display.Sprite;
    import flash.geom.Point;

    public class PointExample extends Sprite {

        public function PointExample() {
        var point1:Point = new Point();
        trace(point1);  // (x=0, y=0)
        
        var point2:Point = new Point(6, 8);
        trace(point2); // (x=6, y=8)
        
        trace(Point.interpolate(point1, point2, 0.5)); // (x=3, y=4)
        
        trace(Point.distance(point1, point2)); // 10
        
        trace(point1.add(point2)); // (x=6, y=8)
        
        var point3:Point = point2.clone();
        trace(point2.equals(point3)); // true
        
        point3.normalize(2.5);
        trace(point3); // (x=1.5, y=2)
        
        trace(point2.subtract(point3)); // (x=4.5, y=6)
        
        trace(point1.offset(2, 3)); // 
        
        var angle:Number = Math.PI * 2 * (30 / 360); // 30°
        trace(Point.polar(4, angle)) // (x=3.464101615137755, y=1.9999999999999998)   
        }
    }
}



© 2004-2007 Adobe Systems Incorporated. Tous droits réservés.
Fri Oct 12 2007, 2:53 AM GMT-07:00

 

M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire

Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/flash/geom/Point.html