Pacchettoflash.geom
Classepublic class Point
EreditarietàPoint Inheritance Object

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

L'oggetto Point rappresenta una posizione in un sistema di coordinate bidimensionale in cui x rappresenta l'asse orizzontale e y l'asse verticale.

Il codice seguente crea un punto in corrispondenza di (0,0):

var myPoint:Point = new Point();

Gli oggetti Point vengono utilizzati dai metodi e dalle proprietà delle classi seguenti:

Per creare un oggetto Point si può utilizzare la funzione di costruzione new Point().

Vedere gli esempi

Vedere anche

flash.display.BitmapData
flash.display.DisplayObject
flash.display.DisplayObjectContainer
flash.filters.DisplacementMapFilter
flash.geom.Matrix
flash.geom.Rectangle
Uso degli oggetti Point

Proprietà pubbliche
 ProprietàDefinito da
 Inheritedconstructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  length: Number
[sola lettura] La lunghezza del segmento di linea compreso tra (0,0) e questo punto.
Point
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
  x: Number
La coordinata orizzontale del punto.
Point
  y: Number
La coordinata verticale del punto.
Point
Metodi pubblici
 MetodoDefinito da
  
Point(x:Number = 0, y:Number = 0)
Crea un nuovo punto.
Point
  
add(v:Point):Point
Aggiunge le coordinate di un altro punto a quelle di questo punto in modo da creare un nuovo punto.
Point
  
clone():Point
Crea una copia di questo oggetto Point.
Point
  
distance(pt1:Point, pt2:Point):Number
[statico] Restituisce la distanza tra pt1 e pt2.
Point
  
equals(toCompare:Point):Boolean
Determina se due punti sono uguali.
Point
 Inherited
hasOwnProperty(name:String):Boolean
Indica se per un oggetto è definita una proprietà specifica.
Object
  
interpolate(pt1:Point, pt2:Point, f:Number):Point
[statico] Determina un punto tra due punti specificati.
Point
 Inherited
isPrototypeOf(theClass:Object):Boolean
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
  
normalize(thickness:Number):void
Modifica in scala il segmento di linea compreso tra (0,0) e il punto corrente in base a una lunghezza prestabilita.
Point
  
offset(dx:Number, dy:Number):void
Sposta l'oggetto Point della distanza specificata.
Point
  
polar(len:Number, angle:Number):Point
[statico] Converte una coppia di coordinate polari nella coordinata di un punto cartesiano.
Point
 Inherited
propertyIsEnumerable(name:String):Boolean
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
  
subtract(v:Point):Point
Sottrae le coordinate di un altro punto da quelle di questo punto in modo da creare un nuovo punto.
Point
  
toString():String
Restituisce una stringa contenente i valori delle coordinate x e y.
Point
 Inherited
valueOf():Object
Restituisce il valore di base dell'oggetto specificato.
Object
Descrizione delle proprietà
lengthproprietà
length:Number  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

La lunghezza del segmento di linea compreso tra (0,0) e questo punto.


Implementazione
    public function get length():Number

Vedere anche

Point.polar()
xproprietà 
public var x:Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

La coordinata orizzontale del punto. Il valore predefinito è 0.

Vedere anche

Uso degli oggetti Point
yproprietà 
public var y:Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

La coordinata verticale del punto. Il valore predefinito è 0.

Vedere anche

Uso degli oggetti Point
Descrizione della funzione di costruzione
Point()Funzione di costruzione
public function Point(x:Number = 0, y:Number = 0)

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Crea un nuovo punto. Se non si passano parametri a questo metodo, il punto viene creato in corrispondenza di (0,0).

Parametri
x:Number (default = 0) — La coordinata orizzontale.
 
y:Number (default = 0) — La coordinata verticale.
Descrizione dei metodi
add()metodo
public function add(v:Point):Point

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Aggiunge le coordinate di un altro punto a quelle di questo punto in modo da creare un nuovo punto.

Parametri

v:Point — Il punto da aggiungere.

Restituisce
Point — Il nuovo punto.
clone()metodo 
public function clone():Point

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Crea una copia di questo oggetto Point.

Restituisce
Point — Il nuovo oggetto Point.
distance()metodo 
public static function distance(pt1:Point, pt2:Point):Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Restituisce la distanza tra pt1 e pt2.

Parametri

pt1:Point — Il primo punto.
 
pt2:Point — Il secondo punto.

Restituisce
Number — La distanza tra il primo e il secondo punto.

Vedere anche

Uso degli oggetti Point
equals()metodo 
public function equals(toCompare:Point):Boolean

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Determina se due punti sono uguali. Due punti sono uguali se hanno gli stessi valori x e y.

Parametri

toCompare:Point — Il punto da confrontare.

Restituisce
Boolean — Un valore true se l'oggetto è uguale all'oggetto Point; false se non è uguale.
interpolate()metodo 
public static function interpolate(pt1:Point, pt2:Point, f:Number):Point

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Determina un punto tra due punti specificati. Il parametro f determina la posizione del nuovo punto interpolato rispetto ai due punti finali specificati dai parametri pt1 e pt2. Più il valore del parametro f si avvicina a 1.0, più il punto interpolato è vicino al primo punto (parametro pt1). Più il valore del parametro f si avvicina a 0, più il punto interpolato è vicino al secondo punto (parametro pt2).

Parametri

pt1:Point — Il primo punto.
 
pt2:Point — Il secondo punto.
 
f:Number — Il livello di interpolazione tra i due punti. Indica la posizione del nuovo punto lungo la linea tra pt1 e pt2. Se f=1, viene restituito pt1; se f=0, viene restituito pt2.

Restituisce
Point — Il nuovo punto interpolato.
normalize()metodo 
public function normalize(thickness:Number):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Modifica in scala il segmento di linea compreso tra (0,0) e il punto corrente in base a una lunghezza prestabilita.

Parametri

thickness:Number — Il valore di scala. Ad esempio, se il punto corrente è (0,5) e viene normalizzato a 1, il punto restituito è (0,1).

Vedere anche

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

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Sposta l'oggetto Point della distanza specificata. Il valore di dx viene aggiunto al valore originale di x per creare il nuovo valore x. Il valore di dy viene aggiunto al valore originale di y per creare il nuovo valore y.

Parametri

dx:Number — Il valore utilizzato per l'offset della coordinata orizzontale, x.
 
dy:Number — Il valore utilizzato per l'offset della coordinata verticale, y.

polar()metodo 
public static function polar(len:Number, angle:Number):Point

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Converte una coppia di coordinate polari nella coordinata di un punto cartesiano.

Parametri

len:Number — La coordinata della lunghezza della coppia polare.
 
angle:Number — L'angolo, espresso in radianti, della coppia polare.

Restituisce
Point — Il punto cartesiano.

Vedere anche

length
Math.round()
Uso degli oggetti Point
subtract()metodo 
public function subtract(v:Point):Point

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Sottrae le coordinate di un altro punto da quelle di questo punto in modo da creare un nuovo punto.

Parametri

v:Point — Il punto da sottrarre.

Restituisce
Point — Il nuovo punto.
toString()metodo 
public function toString():String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Restituisce una stringa contenente i valori delle coordinate x e y. Poiché la stringa è nel formato "(x= x, y= y)", se si chiama il metodo toString() per un punto in corrispondenza di 23,17, viene restituito "(x=23, y=17)".

Restituisce
String — La rappresentazione sotto forma di stringa delle coordinate.
Esempi Come utilizzare gli esempi
PointExample.as

Nell'esempio seguente viene utilizzata la classe PointExample per creare numerosi nuovi oggetti Point in corrispondenza di diverse coordinate x, y, quindi viene utilizzato il metodo trace() per produrre i risultati di vari metodi della 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. All rights reserved.
Fri Oct 12 2007, 3:14 AM GMT-07:00

 

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/geom/Point.html