Point

パッケージ	flash.geom
クラス	public class Point
継承	Point Object

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

Point オブジェクトは 2 次元の座標系の位置を表します。x は水平方向の軸を表し、y は垂直方向の軸を表します。

次のコードでは、位置 (0,0) に配置されるポイントを作成します。

var myPoint:Point = new Point();

次のクラスのメソッドとプロパティで Point オブジェクトを使用します。

BitmapData
DisplayObject
DisplayObjectContainer
DisplacementMapFilter
NativeWindow
Matrix
Rectangle

Point オブジェクトを作成するには、new 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 2 つのポイントが等しいかどうかを判別します。	Point
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		interpolate(pt1:Point, pt2:Point, f:Number):Point [静的] 2 つの指定されたポイント間にあるポイントを判別します。	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 — データのコピー元となる Rectangle オブジェクトです。

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` — 2 番目のポイントです。

戻り値

Number — 最初のポイントと 2 番目のポイント間の距離です。

equals

()

メソッド

public function equals(toCompare:Point):Boolean

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

2 つのポイントが等しいかどうかを判別します。x 値と y 値が同じ場合、2 つのポイントは等しいことになります。

パラメーター

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

2 つの指定されたポイント間にあるポイントを判別します。パラメーター f はパラメーター pt1 および pt2 で指定された 2 つの端点に対する、新しい補間ポイントの場所を決定します。パラメーター f の値が 1.0 に近づくほど、補間ポイントは最初のポイント（パラメーター pt1）に近づきます。パラメーター f の値が 0 に近づくほど、補間ポイントは 2 番目のポイント（パラメーター pt2）に近づきます。

パラメーター

	`pt1:Point` — 最初のポイントです。

	`pt2:Point` — 2 番目のポイントです。

	`f:Number` — 2 つのポイント間の補間のレベルです。`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 クラスを使用して多数の新しい Point オブジェクトをさまざまな x,y 座標に作成し、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