Point

Package	flash.geom
Classe	public class Point
Héritage	Point Object

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

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 :

BitmapData
Classe DisplayObject
DisplayObjectContainer
DisplacementMapFilter
NativeWindow
Matrix
Rectangle

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

Consulter les exemples

Plus d’exemples

Translation d’espaces de coordonnées
Déplacement d’un objet d’affichage en fonction d’une distance et d’un angle donnés

Informations complémentaires

Utilisation des objets Point

Eléments de l’API associés

flash.display.BitmapData
flash.display.DisplayObject
flash.display.DisplayObjectContainer
flash.filters.DisplacementMapFilter
flash.geom.Matrix
flash.display.NativeWindow
flash.geom.Rectangle

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		constructor : 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
		x : Number Les coordonnées horizontales du point.	Point
		y : Number Les coordonnées verticales du point.	Point

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Dé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
		copyFrom(sourcePoint:Point):void Copie toutes les données de point de l’objet Point source dans l’objet Point appelant.	Point
		distance(pt1:Point, pt2:Point):Number [statique] Renvoie la distance entre pt1 et pt2.	Point
		equals(toCompare:Point):Boolean Détermine si deux points sont égaux.	Point
		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 [statique] Détermine un point entre deux points spécifiés.	Point
		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 [statique] Convertit une paire de coordonnées polaires en coordonnées cartésiennes.	Point
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		setTo(xa:Number, ya:Number):void Définit les membres du point sur les valeurs spécifiées	Point
		subtract(v:Point):Point Soustrait les coordonnées d’un autre point à celles de ce point pour créer un nouveau point.	Point
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie une chaîne qui contient les valeurs des coordonnées x et y.	Point
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object

Détails de la propriété

length

propriété

length:Number [lecture seule]

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Implémentation
public function get length():Number

Eléments de l’API associés

Point.polar()

x

propriété

public var x:Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Plus d’exemples

Utilisation des objets Point

y

propriété

public var y:Number

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Plus d’exemples

Utilisation des objets Point

Détails du constructeur

()

Constructeur

public function Point(x:Number = 0, y:Number = 0)

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

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 de la méthode

add

()

méthode

public function add(v:Point):Point

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Crée une copie de cet objet Point.

Valeur renvoyée

Point — Nouvel objet Point.

copyFrom

()

méthode

public function copyFrom(sourcePoint:Point):void

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 11, AIR 3.0, Flash Lite 4

Copie toutes les données de point de l’objet Point source dans l’objet Point appelant.

Paramètres

sourcePoint:Point — Objet Point à partir duquel copier les données.

distance

()

méthode

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

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

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.

Plus d’exemples

Utilisation des objets Point

equals

()

méthode

public function equals(toCompare:Point):Boolean

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

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).

Eléments de l’API associés

length

offset

()

méthode

public function offset(dx:Number, dy:Number):void

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

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.

Plus d’exemples

Utilisation des objets Point

Eléments de l’API associés

length
Math.round()

setTo

()

méthode

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

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 11, AIR 3.0, Flash Lite 4

Définit les membres du point sur les valeurs spécifiées

Paramètres

	`xa:Number` — Valeurs sur lesquelles définir le point.

	`ya:Number`

subtract

()

méthode

public function subtract(v:Point):Point

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

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 Comment utiliser cet exemple

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 degrees
        trace(Point.polar(4, angle)) // (x=3.464101615137755, y=1.9999999999999998)   
        }
    }
}

Informations juridiques | Politique de confidentialité en ligne

Point - AS3

Classes x

length

x

y

Point

add

clone

copyFrom

distance

equals

interpolate

normalize

offset

polar

setTo

subtract

toString