| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Point オブジェクトは 2 次元の座標系の位置を表します。
x は水平方向の軸を表し、
y は垂直方向の軸を表します。
次のコードでは、位置 (0,0) に配置されるポイントを作成します。
var myPoint:Point = new Point();
次のクラスのメソッドとプロパティで Point オブジェクトを使用します。
- BitmapData
- DisplayObject
- DisplayObjectContainer
- DisplacementMapFilter
- NativeWindow
- Matrix
- Rectangle
Point オブジェクトを作成するには、new Point() コンストラクタを使用します。
例を表示
length:Number [読み取り専用]
| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
(0,0) からこのポイントまでの線のセグメントの長さです。
実装 public function get length():Number関連項目
public var x:Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
ポイントの水平座標。デフォルト値は 0 です。
関連項目
public var y:Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
ポイントの垂直座標。デフォルト値は 0 です。
関連項目
public function Point(x:Number = 0, y:Number = 0)| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
新しいポイントを作成します。パラメータを渡さずにこのメソッドを呼び出すと、(0,0) にポイントが作成されます。
パラメータ | x:Number (default = 0) — 水平座標です。
|
| |
| y:Number (default = 0) — 垂直座標です。
|
public function add(v:Point):Point| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
このポイントの座標に他のポイントの座標を加算して、新しいポイントを作成します。
パラメータ
戻り値 public function clone():Point| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
この Point オブジェクトのコピーを作成します。
戻り値 | Point — 新しい Point オブジェクトです。
|
public static function distance(pt1:Point, pt2:Point):Number| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
pt1 と pt2 との距離を返します。
パラメータ
戻り値 | Number — 最初のポイントと 2 番目のポイント間の距離です。
|
関連項目
public function equals(toCompare:Point):Boolean| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
2 つのポイントが等しいかどうかを判別します。x 値と y 値が同じ場合、2 つのポイントは等しいことになります。
パラメータ
| toCompare:Point — 比較するポイントです。
|
戻り値 | Boolean — オブジェクトがこの Point オブジェクトと等しい場合は true を返します。等しくない場合は false を返します。
|
public static function interpolate(pt1:Point, pt2:Point, f:Number):Point| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
2 つの指定されたポイント間にあるポイントを判別します。パラメータ f はパラメータ pt1 および pt2 で指定された 2 つの端点に対する、新しい補間ポイントの場所を決定します。パラメータ f の値が 1.0 に近づくほど、補間ポイントは最初のポイント(パラメータ pt1)に近づきます。パラメータ f の値が 0 に近づくほど、補間ポイントは 番目のポイント(パラメータ pt22)に近づきます。
パラメータ
| pt1:Point — 最初のポイントです。
|
| |
| pt2:Point — 2 番目のポイントです。
|
| |
| f:Number — 2 つのポイント間の補間のレベルです。pt1 と pt2 間の線に沿って新しいポイントがある位置を示します。f= の場合は pt11 が返されます。f=0 の場合は pt2 が返されます。
|
戻り値 public function normalize(thickness:Number):void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
(0,0) と現在のポイント間の線のセグメントを設定された長さに拡大 / 縮小します。
パラメータ
| thickness:Number — 拡大 / 縮小値です。例えば、現在のポイントが (0,5) で、1 に正規化すると、返されるポイントは (0,1) になります。
|
関連項目
public function offset(dx:Number, dy:Number):void| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
Point オブジェクトを指定された量だけオフセットします。dx の値を x の元の値に加算して、新しい x 値を作成します。dy の値を y の元の値に加算して、新しい y 値を作成します。
パラメータ
| dx:Number — 水平座標 x をオフセットする量です。
|
| |
| dy:Number — 垂直座標 y をオフセットする量です。
|
public static function polar(len:Number, angle:Number):Point| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
極座標ペアを直交点座標に変換します。
パラメータ
| len:Number — 極座標ペアの長さ座標です。
|
| |
| angle:Number — 極座標ペアの角度(ラジアン単位)です。
|
戻り値関連項目
public function subtract(v:Point):Point| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
このポイントの座標から他のポイントの座標を減算して、新しいポイントを作成します。
パラメータ
戻り値 public function toString():String| 言語バージョン: | ActionScript 3.0 |
| ランタイムバージョン: | AIR 1.0 Flash Player 9 |
x 座標の値と y 座標の値を格納するストリングを返します。ストリングの書式が "(x=x, y=y)" となっているため、23,17 にあるポイントに対して toString() メソッドを呼び出すと、"(x=23, y=17)" という値が返されます。
戻り値 次の例では、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)
}
}
}
© 2009 Adobe Systems Incorporated. All rights reserved.
Thu Mar 19 2009, 08:51 PM -07:00