Point

套件	flash.geom
類別	public class Point
繼承	Point Object

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

Point 物件代表二維座標系統中的位置，其中 x 表示水平軸，而 y 表示垂直軸。

下列程式碼將會在 (0,0) 建立一個點：

var myPoint:Point = new Point();

下列類別的方法和屬性會使用 Point 物件：

BitmapData
DisplayObject
DisplayObjectContainer
DisplacementMapFilter
NativeWindow
Matrix
Rectangle

您可以使用 new Point() 建構函式來建立 Point 物件。

檢視範例

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		length : Number [唯讀] 從 (0,0) 到這點的線段的長度。	Point
		x : Number 點的水平座標。	Point
		y : Number 點的垂直座標。	Point

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		Point(x:Number = 0, y:Number = 0) 建立新的點。	Point
		add(v:Point):Point 對這點的座標增加另一點的座標，以建立新點。	Point
		clone():Point 建立此 Point 物件的副本。	Point
		copyFrom(sourcePoint:Point):void 將來源 Point 物件中的所有點資料複製到呼叫的 Point 物件。	Point
		distance(pt1:Point, pt2:Point):Number [靜態] 傳回 pt1 及 pt2 之間的距離。	Point
		equals(toCompare:Point):Boolean 指出兩點是否相等。	Point
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		interpolate(pt1:Point, pt2:Point, f:Number):Point [靜態] 指定兩點之間的一點。	Point
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		normalize(thickness:Number):void 將 (0,0) 與目前點之間的線段縮放為設定的長度。	Point
		offset(dx:Number, dy:Number):void 以指定的量偏移 Point 物件。	Point
		polar(len:Number, angle:Number):Point [靜態] 會將一對極座標轉換為一個迪卡兒點座標。	Point
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		setTo(xa:Number, ya:Number):void 將 Point 的成員設定為指定值	Point
		subtract(v:Point):Point 從這點的座標減掉另一點的座標，以建立新點。	Point
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 會傳回字串，其中含有 x 和 y 座標的值。	Point
		valueOf():Object 會傳回指定之物件的基本值。	Object

屬性詳細資訊

length

屬性

length:Number [唯讀]

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

從 (0,0) 到這點的線段的長度。

實作
public function get length():Number

相關 API 元素

Point.polar()

x

屬性

public var x:Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

點的水平座標。預設值為 0。

y

屬性

public var y:Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

點的垂直座標。預設值為 0。

建構函式詳細資料

()

建構函式

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

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

建立新的點。如果您沒有將參數傳遞給這個方法，則會在 (0,0) 建立一個點。

參數

	`x:Number` (default = `0`) — 水平座標。

	`y:Number` (default = `0`) — 垂直座標。

方法詳細資訊

add

()

方法

public function add(v:Point):Point

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

對這點的座標增加另一點的座標，以建立新點。

參數

v:Point — 要增加的點。

傳回值

Point — 新的點。

clone

()

方法

public function clone():Point

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

建立此 Point 物件的副本。

傳回值

Point — 新的 Point 物件。

copyFrom

()

方法

public function copyFrom(sourcePoint:Point):void

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 11, AIR 3.0, Flash Lite 4

將來源 Point 物件中的所有點資料複製到呼叫的 Point 物件。

參數

sourcePoint:Point — 從其中複製資料的 Point 物件。

distance

()

方法

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

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會傳回 pt1 及 pt2 之間的距離。

參數

	`pt1:Point` — 第一個點。

	`pt2:Point` — 第二個點。

傳回值

Number — 第一個點與第二個點之間的距離。

equals

()

方法

public function equals(toCompare:Point):Boolean

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

指出兩點是否相等。如果兩個點具有相同的 x 及 y 值，就表示它們是相等的。

參數

toCompare:Point — 要進行比較的點。

傳回值

Boolean — 如果物件與此 Point 物件是相等的，則值為 true，否則為 false。

interpolate

()

方法

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

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

指定兩點之間的一點。參數 f 會決定新的漸變點與參數 pt1 和 pt2 指定之兩個端點的相對位置。參數 f 的值越接近 1.0，漸變點就會越接近第一個點 (參數 pt1)。參數 f 的值越接近 0，漸變點就會越接近第二個點 (參數 pt2)。

參數

	`pt1:Point` — 第一個點。

	`pt2:Point` — 第二個點。

	`f:Number` — 兩個點之間的插入漸層層級。指出新的點將在線段上介於 `pt1` 及 `pt2` 之間的位置。如果 `f`=1，就會傳回 `pt1`；如果 `f`=0，就會傳回 `pt2`。

傳回值

Point — 新的漸變點。

normalize

()

方法

public function normalize(thickness:Number):void

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

將 (0,0) 與目前點之間的線段縮放為設定的長度。

參數

thickness:Number — 縮放值。例如，如果目前的點是 (0,5)，而您將它一般化為 1，傳回的點就會位於 (0,1)。

相關 API 元素

length

offset

()

方法

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

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

以指定的量偏移 Point 物件。會將 dx 的值加入至原始的 x 值，以建立新的 x 值。會將 dy 的值加入至原始的 y 值，以建立新的 y 值。

參數

	`dx:Number` — 要偏移水平座標 x 的量。

	`dy:Number` — 要偏移垂直座標 y 的量。

polar

()

方法

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

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會將一對極座標轉換為一個迪卡兒點座標。

參數

	`len:Number` — 一對極座標的長度座標。

	`angle:Number` — 一對極座標的角度，以弧度為單位。

傳回值

Point — 迪卡兒點。

相關 API 元素

length
Math.round()

setTo

()

方法

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

語言版本:

ActionScript 3.0

執行階段版本:

Flash Player 11, AIR 3.0, Flash Lite 4

將 Point 的成員設定為指定值

參數

	`xa:Number` — 用來設定點的值。

	`ya:Number`

subtract

()

方法

public function subtract(v:Point):Point

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

從這點的座標減掉另一點的座標，以建立新點。

參數

v:Point — 要減去的點。

傳回值

Point — 新的點。

toString

()

方法

public function toString():String

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會傳回字串，其中含有 x 和 y 座標的值。此字串的格式為 "(x= x , y= y )" ，所以針對位於 23,17 的點呼叫 toString() 方法就會傳回 "(x=23, y=17)"。

傳回值

String — 座標的字串形式。

範例如何使用本範例

PointExample.as

下列範例將使用 PointExample 類別在各個 x,y 座標上，建立一些新的 Point 物件，然後使用 trace() 方法輸出各種類別方法的結果。

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

法律聲明 | 線上隱私權政策

Point - AS3

類別 x

length

x

y

Point

add

clone

copyFrom

distance

equals

interpolate

normalize

offset

polar

setTo

subtract

toString