Point

Pacchetto	flash.geom
Classe	public class Point
Ereditarietà	Point Object

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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:

BitmapData
DisplayObject
DisplayObjectContainer
DisplacementMapFilter
NativeWindow
Matrix
Rectangle

Per creare un oggetto Point potete utilizzare la funzione di costruzione new Point().

Vedere gli esempi

Altri esempi

Conversione degli spazi di coordinate
Spostamento di un oggetto di visualizzazione della distanza e inclinazione specificate

Altre informazioni

Uso degli oggetti Point

Elementi API correlati

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

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		constructor : 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
		x : Number La coordinata orizzontale del punto.	Point
		y : Number La coordinata verticale del punto.	Point

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito 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
		copyFrom(sourcePoint:Point):void Copia tutti i dati del punto dall'oggetto Point di origine all'oggetto Point chiamante.	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
		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
		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
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		setTo(xa:Number, ya:Number):void Imposta i membri dell'oggetto Point sui valori specificati.	Point
		subtract(v:Point):Point Sottrae le coordinate di un altro punto da quelle di questo punto in modo da creare un nuovo punto.	Point
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce una stringa contenente i valori delle coordinate x e y.	Point
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object

Descrizione delle proprietà

length

proprietà

length:Number [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Implementazione
public function get length():Number

Elementi API correlati

Point.polar()

x

proprietà

public var x:Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Altri esempi

Uso degli oggetti Point

y

proprietà

public var y:Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Altri esempi

Uso degli oggetti Point

Descrizione della funzione di costruzione

()

Funzione di costruzione

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

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Crea un nuovo punto. Se non passate 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

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Crea una copia di questo oggetto Point.

Restituisce

Point — Il nuovo oggetto Point.

copyFrom

()

metodo

public function copyFrom(sourcePoint:Point):void

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 11, AIR 3.0, Flash Lite 4

Copia tutti i dati del punto dall'oggetto Point di origine all'oggetto Point chiamante.

Parametri

sourcePoint:Point — L'oggetto Point da cui copiare i dati.

distance

()

metodo

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

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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.

Altri esempi

Uso degli oggetti Point

equals

()

metodo

public function equals(toCompare:Point):Boolean

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Elementi API correlati

length

offset

()

metodo

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

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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.

Altri esempi

Uso degli oggetti Point

Elementi API correlati

length
Math.round()

setTo

()

metodo

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

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 11, AIR 3.0, Flash Lite 4

Imposta i membri dell'oggetto Point sui valori specificati.

Parametri

	`xa:Number` — I valori su cui impostare il punto.

	`ya:Number`

subtract

()

metodo

public function subtract(v:Point):Point

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

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 questo esempio

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

Note legali | Informativa sulla privacy online

Point - AS3

Pacchettix

Elementi del linguaggio

Appendici

Pacchetto flash.geom

length

x

y

Point

add

clone

copyFrom

distance

equals

interpolate

normalize

offset

polar

setTo

subtract

toString