class flash.geom.Point
Available on all platforms
The Point object represents a location in a two-dimensional coordinate
* system, where x represents the horizontal axis and y
* represents the vertical axis.
* The following code creates a point at(0,0):
Methods and properties of the following classes use Point objects:
*-
*
- BitmapData *
- DisplayObject *
- DisplayObjectContainer *
- DisplacementMapFilter *
- NativeWindow *
- Matrix *
- Rectangle *
You can use the new Point()
constructor to create a Point
* object.
Class Fields
static function distance(pt1:Point, pt2:Point):Float
Returns the distance between pt1
and pt2
.
*
*
pt1 | The first point. * |
pt2 | The second point. * |
returns | The distance between the first and second points. |
static function interpolate(pt1:Point, pt2:Point, f:Float):Point
Determines a point between two specified points. The parameter
* f
determines where the new interpolated point is located
* relative to the two end points specified by parameters pt1
* and pt2
. The closer the value of the parameter f
* is to 1.0
, the closer the interpolated point is to the first
* point(parameter pt1
). The closer the value of the parameter
* f
is to 0, the closer the interpolated point is to the second
* point(parameter pt2
).
*
*
pt1 | The first point. * |
pt2 | The second point. * |
f | The level of interpolation between the two points. Indicates
* where the new point will be, along the line between
* |
returns | The new, interpolated point. |
static function polar(len:Float, angle:Float):Point
Converts a pair of polar coordinates to a Cartesian point coordinate. * *
len | The length coordinate of the polar pair. * |
angle | The angle, in radians, of the polar pair. * |
returns | The Cartesian point. |
Instance Fields
function new(?x:Float, ?y:Float):Void
Creates a new point. If you pass no parameters to this method, a point is * created at(0,0). * *
x | The horizontal coordinate. * |
y | The vertical coordinate. |
Adds the coordinates of another point to the coordinates of this point to * create a new point. * *
v | The point to be added. * |
returns | The new point. |
function equals(toCompare:Point):Bool
Determines whether two points are equal. Two points are equal if they have * the same x and y values. * *
toCompare | The point to be compared. * |
returns | A value of |
function normalize(thickness:Float):Void
Scales the line segment between(0,0) and the current point to a set * length. * *
thickness | The scaling value. For example, if the current point is (0,5), and you normalize it to 1, the point returned is at(0,1). * |
returns | The normalized point. |
function offset(dx:Float, dy:Float):Void
Offsets the Point object by the specified amount. The value of
* dx
is added to the original value of x to create the
* new x value. The value of dy
is added to the original
* value of y to create the new y value.
*
*
dx | The amount by which to offset the horizontal coordinate, x. |
dy | The amount by which to offset the vertical coordinate, y. |