パッケージflash.geom
public class Point
継承Point Inheritance Object

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

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

var myPoint:Point = new Point();

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

Point オブジェクトを作成するには、new Point() コンストラクタを使用します。

例の表示

関連項目

flash.display.BitmapData
flash.display.DisplayObject
flash.display.DisplayObjectContainer
flash.filters.DisplacementMapFilter
flash.geom.Matrix
flash.geom.Rectangle
Point オブジェクトの使用


パブリックプロパティ
 プロパティ定義
 Inheritedconstructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  length : Number
[read-only] (0,0) からこのポイントまでの線のセグメントの長さです。
Point
 Inheritedprototype : Object
[static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
  x : Number
ポイントの水平座標です。
Point
  y : Number
ポイントの垂直座標です。
Point
パブリックメソッド
 メソッド定義
  Point(x:Number = 0, y:Number = 0)
新しいポイントを作成します。
Point
  add(v:Point):Point
このポイントの座標に他のポイントの座標を加算して、新しいポイントを作成します。
Point
  clone():Point
この Point オブジェクトのコピーを作成します。
Point
  distance(pt1:Point, pt2:Point):Number
[static] pt1pt2 との距離を返します。
Point
  equals(toCompare:Point):Boolean
2 つのポイントが等しいかどうかを判別します。
Point
 InheritedhasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
  interpolate(pt1:Point, pt2:Point, f:Number):Point
[static] 2 つの指定されたポイント間にあるポイントを判別します。
Point
 InheritedisPrototypeOf(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
[static] 極座標ペアを直交点座標に変換します。
Point
 InheritedpropertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙可能かどうかを示します。
Object
 InheritedsetPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
  subtract(v:Point):Point
このポイントの座標から他のポイントの座標を減算して、新しいポイントを作成します。
Point
  toString():String
x 座標の値と y 座標の値を格納するストリングを返します。
Point
 InheritedvalueOf():Object
指定されたオブジェクトのプリミティブ値を返します。
Object
プロパティの詳細
lengthプロパティ
length:Number  [read-only]

(0,0) からこのポイントまでの線のセグメントの長さです。

実装
    public function get length():Number

関連項目

xプロパティ 
public var x:Number

ポイントの水平座標です。デフォルト値は 0 です。

関連項目

yプロパティ 
public var y:Number

ポイントの垂直座標です。デフォルト値は 0 です。

関連項目

コンストラクタの詳細
Point()コンストラクタ
public 関数 Point(x:Number = 0, y:Number = 0)

新しいポイントを作成します。このメソッドのパラメータを渡さなければ、(0,0) にポイントが作成されます。

パラメータ
x:Number (default = 0) — 水平座標です。
 
y:Number (default = 0) — 垂直座標です。
メソッドの詳細
add()メソッド
public function add(v:Point):Point

このポイントの座標に他のポイントの座標を加算して、新しいポイントを作成します。

パラメータ
v:Point — 追加するポイントです。

戻り値
Point — 新しいポイントです。
clone()メソッド 
public function clone():Point

この Point オブジェクトのコピーを作成します。

戻り値
Point — 新しい Point オブジェクトです。
distance()メソッド 
public static function distance(pt1:Point, pt2:Point):Number

pt1pt2 との距離を返します。

パラメータ
pt1:Point — 最初のポイントです。
 
pt2:Point — 2 番目のポイントです。

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

関連項目

equals()メソッド 
public function equals(toCompare:Point):Boolean

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

パラメータ
toCompare:Point — 比較するポイントです。

戻り値
Boolean — オブジェクトがこの Point オブジェクトと等しい場合は true を返します。等しくない場合は false を返します。
interpolate()メソッド 
public static function interpolate(pt1:Point, pt2:Point, f:Number):Point

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

パラメータ
pt1:Point — 最初のポイントです。
 
pt2:Point — 2 番目のポイントです。
 
f:Number — 2 つのポイント間の補間のレベルです。pt1pt2 間の線に沿って新しいポイントがある位置を示します。f=1 の場合は pt1 が返されます。f=0 の場合は pt2 が返されます。

戻り値
Point — 新しい補間ポイントです。
normalize()メソッド 
public function normalize(thickness:Number):void

(0,0) と現在のポイント間の線のセグメントを設定された長さに拡大・縮小します。

パラメータ
thickness:Number — 拡大・縮小値です。たとえば、現在のポイントが (0,5) で、1 に正規化すると、返されるポイントは (0,1) になります。

関連項目

offset()メソッド 
public function offset(dx:Number, dy:Number):void

Point オブジェクトを指定された量だけオフセットします。dx の値を x の元の値に加算して、新しい x 値を作成します。dy の値を y の元の値に加算して、新しい y 値を作成します。

パラメータ
dx:Number — 水平座標 x をオフセットする量です。
 
dy:Number — 垂直座標 y をオフセットする量です。
polar()メソッド 
public static function polar(len:Number, angle:Number):Point

極座標ペアを直交点座標に変換します。

パラメータ
len:Number — 極座標ペアの長さ座標です。
 
angle:Number — 極座標ペアの角度 (ラジアン単位) です。

戻り値
Point — 直交ポイントです。

関連項目

subtract()メソッド 
public function subtract(v:Point):Point

このポイントの座標から他のポイントの座標を減算して、新しいポイントを作成します。

パラメータ
v:Point — 減算するポイントです。

戻り値
Point — 新しいポイントです。
toString()メソッド 
public function toString():String

x 座標の値と y 座標の値を格納するストリングを返します。 ストリングの形式は "(x=x, y=y)" であるため、23,17 にあるポイントに対する toString() メソッドでは、"(x=23, y=17)" が返されます。

戻り値
String — 座標のストリング表現です。

次の例では、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°
        trace(Point.polar(4, angle)) // (x=3.464101615137755, y=1.9999999999999998)   
        }
    }
}




 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/2_jp/langref/flash/geom/Point.html