Point

Pakiet	flash.geom
Klasa	public class Point
Dziedziczenie	Point Object

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Obiekt Point reprezentuje miejsce w dwuwymiarowym układzie współrzędnych, gdzie x oznacza współrzędną poziomą, a y oznacza współrzędną pionową.

Poniższy kod tworzy punkt we współrzędnych (0,0):

var myPoint:Point = new Point();

Obiekty Point są używane w metodach i właściwościach następujących klas:

BitmapData
DisplayObject
DisplayObjectContainer
DisplacementMapFilter
NativeWindow
Matrix
Rectangle

Do utworzenia obiektu Point można użyć konstruktora new Point().

Wyświetl przykłady

Powiązane elementy interfejsu API

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

Właściwości publiczne

Ukryj dziedziczone właściwości publiczne

Pokaż dziedziczone właściwości publiczne

	Właściwość		Zdefiniowane przez
		constructor : Object Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.	Object
		length : Number [tylko do odczytu] Długość odcinka linii od punktu (0,0) do danego punktu.	Point
		x : Number Współrzędna pozioma punktu.	Point
		y : Number Współrzędna pionowa punktu.	Point

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	Metoda		Zdefiniowane przez
		Point(x:Number = 0, y:Number = 0) Tworzy nowy punkt.	Point
		add(v:Point):Point Dodaje współrzędne innego punktu do współrzędnych tego punktu, aby utworzyć nowy punkt.	Point
		clone():Point Tworzy kopię zadanego obiektu typu Point.	Point
		copyFrom(sourcePoint:Point):void Kopiuje wszystkie dane punktu ze źródłowego obiektu Point do wywołującego obiektu Point.	Point
		distance(pt1:Point, pt2:Point):Number [statyczny] Zwraca odległość między pkt1 a pkt2.	Point
		equals(toCompare:Point):Boolean Sprawdza, czy dwa punkty są tożsame.	Point
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		interpolate(pt1:Point, pt2:Point, f:Number):Point [statyczny] Określa punkt pomiędzy dwoma wskazanymi punktami.	Point
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		normalize(thickness:Number):void Skaluje odcinek linii od punktu (0,0) do bieżącego punktu do zadanej długości.	Point
		offset(dx:Number, dy:Number):void Przesuwa obiekt Point o zadaną wielkość.	Point
		polar(len:Number, angle:Number):Point [statyczny] Konwertuje parę współrzędnych biegunowych na współrzędne kartezjańskie.	Point
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		setTo(xa:Number, ya:Number):void Ustawia określone wartości elementów obiektu Point.	Point
		subtract(v:Point):Point Odejmuje współrzędne innego punktu od współrzędnych tego punktu, aby utworzyć nowy punkt.	Point
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toString():String Zwraca ciąg zawierający wartości współrzędnych x i y.	Point
		valueOf():Object Zwraca pierwotną wartość dla określonego obiektu.	Object

Szczegół właściwości

length

właściwość

length:Number [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Długość odcinka linii od punktu (0,0) do danego punktu.

Implementacja
public function get length():Number

Powiązane elementy interfejsu API

Point.polar()

x

właściwość

public var x:Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Współrzędna pozioma punktu. Wartością domyślną jest 0.

y

właściwość

public var y:Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Współrzędna pionowa punktu. Wartością domyślną jest 0.

Konstruktor Szczegół

()

Konstruktor

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

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Tworzy nowy punkt. Jeśli do metody nie zostaną przekazane żadne parametry, tworzony jest punkt o współrzędnych (0,0).

Parametry

	`x:Number` (default = `0`) — Współrzędna pozioma.

	`y:Number` (default = `0`) — Współrzędna pionowa.

Szczegół metody

add

()

metoda

public function add(v:Point):Point

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Dodaje współrzędne innego punktu do współrzędnych tego punktu, aby utworzyć nowy punkt.

Parametry

v:Point — Punkt, który ma być dodany.

Zwraca

Point — Nowy punkt.

clone

()

metoda

public function clone():Point

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Tworzy kopię zadanego obiektu typu Point.

Zwraca

Point — Nowy obiekt Point.

copyFrom

()

metoda

public function copyFrom(sourcePoint:Point):void

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11, AIR 3.0, Flash Lite 4

Kopiuje wszystkie dane punktu ze źródłowego obiektu Point do wywołującego obiektu Point.

Parametry

sourcePoint:Point — Obiekt Point, z którego należy skopiować dane.

distance

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca odległość między punktami pt1 i pt2.

Parametry

	`pt1:Point` — Pierwszy punkt.

	`pt2:Point` — Drugi punkt.

Zwraca

Number — Odległość między pierwszym i drugim punktem.

equals

()

metoda

public function equals(toCompare:Point):Boolean

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Sprawdza, czy dwa punkty są tożsame. Dwa punkty są tożsame, jeśli mają identyczne wartości x i y.

Parametry

toCompare:Point — Punkt, który ma być porównywany.

Zwraca

Boolean — Wartość true, jeśli obiekt jest równy temu obiektowi Point; false, jeśli obiekty nie są równe.

interpolate

()

metoda

public static function interpolate(pt1:Point, pt2:Point, f:Number):Point

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Określa punkt pomiędzy dwoma wskazanymi punktami. Parametr f określa położenie nowego interpolowanego punktu względem dwóch punktów końcowych określonych parametrami pt1 i pt2. Im wartość parametru f jest bliższa 1.0, tym bliżej pierwszego punktu (pt1) znajduje się interpolowany punkt. Im wartość parametru f jest bliższa 0, tym bliżej drugiego punktu (pt2) znajduje się interpolowany punkt.

Parametry

	`pt1:Point` — Pierwszy punkt.

	`pt2:Point` — Drugi punkt.

	`f:Number` — Poziom interpolacji między dwoma punktami. Określa położenie nowego punktu na linii między `pt1` i `pt2`. Jeśli `f`=1, zwracany jest punkt `pt1`; jeśli `f`=0, zwracany jest punkt `pt2`.

Zwraca

Point — Nowy punkt uzyskany w wyniku interpolacji.

normalize

()

metoda

public function normalize(thickness:Number):void

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Skaluje odcinek linii od punktu (0,0) do bieżącego punktu do zadanej długości.

Parametry

thickness:Number — Wartość skalowania. Na przykład jeśli bieżący punkt ma współrzędne (0,5) i zostanie znormalizowany do 1, zwrócony punkt będzie miał współrzędne (0,1).

Powiązane elementy interfejsu API

length

offset

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Przesuwa obiekt Point o zadaną wielkość. Wartość dx jest dodawana do oryginalnej wartości x w celu uzyskania nowej wartości x. Wartość dy jest dodawana do oryginalnej wartości y w celu uzyskania nowej wartości y.

Parametry

	`dx:Number` — Przesunięcie współrzędnej poziomej x.

	`dy:Number` — Przesunięcie współrzędnej pionowej y.

polar

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Konwertuje parę współrzędnych biegunowych na współrzędne kartezjańskie.

Parametry

	`len:Number` — Współrzędna biegunowa długości.

	`angle:Number` — Współrzędna biegunowa kąta w radianach.

Zwraca

Point — Punkt o współrzędnych kartezjańskich.

Powiązane elementy interfejsu API

length
Math.round()

setTo

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11, AIR 3.0, Flash Lite 4

Ustawia określone wartości elementów obiektu Point.

Parametry

	`xa:Number` — Wartości, które należy ustawić dla punktu.

	`ya:Number`

subtract

()

metoda

public function subtract(v:Point):Point

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Odejmuje współrzędne innego punktu od współrzędnych tego punktu, aby utworzyć nowy punkt.

Parametry

v:Point — Punkt, który ma być odjęty.

Zwraca

Point — Nowy punkt.

toString

()

metoda

public function toString():String

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca ciąg zawierający wartości współrzędnych x i y. Ciąg znaków ma postać "(x=x, y=y)", a zatem wywołanie metody toString() dla punktu o współrzędnych 23,17 zwróci ciąg "(x=23, y=17)".

Zwraca

String — Ciąg znaków reprezentujący współrzędne.

Przykłady Sposób korzystania z tego przykładu

PointExample.as

W poniższym przykładzie zastosowano klasę PointExample do utworzenia szeregu nowych obiektów Point w różnych współrzędnych x,y, a następnie użyto metody trace() do wyświetlenia wyników wykonania różnych metod klasy.

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

Informacje prawne | Zasady prywatności online

Point - AS3

Klasy x

length

x

y

Point

add

clone

copyFrom

distance

equals

interpolate

normalize

offset

polar

setTo

subtract

toString