Packageflash.geom
Classpublic class Point
InheritancePoint Inheritance Object

Language version: ActionScript 3.0
Runtime version: 

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

var myPoint:Point = new Point();
var myPoint = new Point();

Methods and properties of the following classes use Point objects:

You can use the new Point() constructor to create a Point object.

View the examples.

See also

flash.display.BitmapData
flash.display.DisplayObject
flash.display.DisplayObjectContainer
flash.filters.DisplacementMapFilter
flash.geom.Matrix
flash.display.NativeWindow
flash.geom.Rectangle


Public Properties
 PropertyDefined by
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
  length : Number
[read-only] The length of the line segment from (0,0) to this point.
Point
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
  x : Number
The horizontal coordinate of the point.
Point
  y : Number
The vertical coordinate of the point.
Point
Public Methods
 MethodDefined by
  
Point(x:Number = 0, y:Number = 0)
Creates a new point.
Point
  
Adds the coordinates of another point to the coordinates of this point to create a new point.
Point
  
Adds the coordinates of another point to the coordinates of this point to create a new point.
Point
  
Creates a copy of this Point object.
Point
  
copyFrom(sourcePoint:Point):void
Copies all of the point data from the source Point object into the calling Point object.
Point
  
[static] Returns the distance between pt1 and pt2.
Point
  
equals(toCompare:Point):Boolean
Determines whether two points are equal.
Point
 Inherited
Indicates whether an object has a specified property defined.
Object
  
[static] Determines a point between two specified points.
Point
  
[static] Determines a point between two specified points.
Point
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
  
normalize(thickness:Number):void
Scales the line segment between (0,0) and the current point to a set length.
Point
  
Offsets the Point object by the specified amount.
Point
  
polar(len:Number, angle:Number):Point
[static] Converts a pair of polar coordinates to a Cartesian point coordinate.
Point
  
polarToOutput(len:Number, angle:Number, output:Point):Point
[static] Converts a pair of polar coordinates to a Cartesian point coordinate.
Point
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
  
Sets the members of Point to the specified values
Point
  
Subtracts the coordinates of another point from the coordinates of this point to create a new point.
Point
  
Subtracts the coordinates of another point from the coordinates of this point to create a new point.
Point
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
  
Returns a string that contains the values of the x and y coordinates.
Point
 Inherited
Returns the primitive value of the specified object.
Object
Property detail
lengthproperty
length:Number  [read-only]

Language version: ActionScript 3.0
Runtime version: 

The length of the line segment from (0,0) to this point.

Implementation
    public function get length():Number

See also

xproperty 
public var x:Number

Language version: ActionScript 3.0
Runtime version: 

The horizontal coordinate of the point. The default value is 0.

yproperty 
public var y:Number

Language version: ActionScript 3.0
Runtime version: 

The vertical coordinate of the point. The default value is 0.

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

Language version: ActionScript 3.0
Runtime version: 

Creates a new point. If you pass no parameters to this method, a point is created at (0,0).

Parameters
x:Number (default = 0) — The horizontal coordinate.
 
y:Number (default = 0) — The vertical coordinate.
Method detail
add()method
public function add(v:Point):Point

Language version: ActionScript 3.0
Runtime version: 

Adds the coordinates of another point to the coordinates of this point to create a new point.

Parameters
v:Point — The point to be added.

Returns
Point — The new point (or the object passed in as the output parameter, if not null).
addToOutput()method 
public function addToOutput(v:Point, output:Point):Point

Language version: ActionScript 3.0
Runtime version: AIR 33.1

Adds the coordinates of another point to the coordinates of this point to create a new point.

Parameters
v:Point — The point to be added.
 
output:Point — An optional point to be used for the result of the operation.

Returns
Point — The new point (or the object passed in as the output parameter, if not null).
clone()method 
public function clone():Point

Language version: ActionScript 3.0
Runtime version: 

Creates a copy of this Point object.

Returns
Point — The new Point object.
copyFrom()method 
public function copyFrom(sourcePoint:Point):void

Language version: ActionScript 3.0
Runtime version: AIR 3.0

Copies all of the point data from the source Point object into the calling Point object.

Parameters
sourcePoint:Point — The Point object from which to copy the data.
distance()method 
public static function distance(pt1:Point, pt2:Point):Number

Language version: ActionScript 3.0
Runtime version: 

Returns the distance between pt1 and pt2.

Parameters
pt1:Point — The first point.
 
pt2:Point — The second point.

Returns
Number — The distance between the first and second points.
equals()method 
public function equals(toCompare:Point):Boolean

Language version: ActionScript 3.0
Runtime version: 

Determines whether two points are equal. Two points are equal if they have the same x and y values.

Parameters
toCompare:Point — The point to be compared.

Returns
Boolean — A value of true if the object is equal to this Point object; false if it is not equal.
interpolate()method 
public static function interpolate(pt1:Point, pt2:Point, f:Number):Point

Language version: ActionScript 3.0
Runtime version: 

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

Parameters
pt1:Point — The first point.
 
pt2:Point — The second point.
 
f:Number — The level of interpolation between the two points. Indicates where the new point will be, along the line between pt1 and pt2. If f=1, pt1 is returned; if f=0, pt2 is returned.

Returns
Point — The new, interpolated point.
interpolateToOutput()method 
public static function interpolateToOutput(pt1:Point, pt2:Point, f:Number, output:Point):Point

Language version: ActionScript 3.0
Runtime version: AIR 33.1

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

Parameters
pt1:Point — The first point.
 
pt2:Point — The second point.
 
f:Number — The level of interpolation between the two points. Indicates where the new point will be, along the line between pt1 and pt2. If f=1, pt1 is returned; if f=0, pt2 is returned.
 
output:Point — An optional point to be used for the result of the operation.

Returns
Point — The new, interpolated point.
normalize()method 
public function normalize(thickness:Number):void

Language version: ActionScript 3.0
Runtime version: 

Scales the line segment between (0,0) and the current point to a set length.

Parameters
thickness:Number — 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).

See also

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

Language version: ActionScript 3.0
Runtime version: 

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.

Parameters
dx:Number — The amount by which to offset the horizontal coordinate, x.
 
dy:Number — The amount by which to offset the vertical coordinate, y.
polar()method 
public static function polar(len:Number, angle:Number):Point

Language version: ActionScript 3.0
Runtime version: 

Converts a pair of polar coordinates to a Cartesian point coordinate.

Parameters
len:Number — The length coordinate of the polar pair.
 
angle:Number — The angle, in radians, of the polar pair.

Returns
Point — The Cartesian point.

See also

polarToOutput()method 
public static function polarToOutput(len:Number, angle:Number, output:Point):Point

Language version: ActionScript 3.0
Runtime version: AIR 33.1

Converts a pair of polar coordinates to a Cartesian point coordinate.

Parameters
len:Number — The length coordinate of the polar pair.
 
angle:Number — The angle, in radians, of the polar pair.
 
output:Point — An optional point to be used for the result of the operation.

Returns
Point — The Cartesian point.

See also

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

Language version: ActionScript 3.0
Runtime version: AIR 3.0

Sets the members of Point to the specified values

Parameters
xa:Number — the values to set the point to.
 
ya:Number
subtract()method 
public function subtract(v:Point):Point

Language version: ActionScript 3.0
Runtime version: 

Subtracts the coordinates of another point from the coordinates of this point to create a new point.

Parameters
v:Point — The point to be subtracted.

Returns
Point — The new point.
subtractToOutput()method 
public function subtractToOutput(v:Point, output:Point):Point

Language version: ActionScript 3.0
Runtime version: AIR 33.1

Subtracts the coordinates of another point from the coordinates of this point to create a new point.

Parameters
v:Point — The point to be subtracted.
 
output:Point — An optional point to be used for the result of the operation.

Returns
Point — The new point.
toString()method 
public function toString():String

Language version: ActionScript 3.0
Runtime version: 

Returns a string that contains the values of the x and y coordinates. The string has the form "(x=x, y=y)", so calling the toString() method for a point at 23,17 would return "(x=23, y=17)".

Returns
String — The string representation of the coordinates.
Examples
examples\PointExample
The following example uses the PointExample class to create a number of new Point objects at various x,y coordinates and then uses the trace() method to output the results of various class methods.
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)   
		}
	}
}