Point

Paquete	flash.geom
Clase	public class Point
Herencia	Point Object

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

El objeto Point representa una ubicación en un sistema de coordenadas bidimensional, donde x representa el eje horizontal e y representa el eje vertical.

Mediante el código siguiente se crea un punto en las coordenadas (0,0):

var myPoint:Point = new Point();

Los métodos y las propiedades de las clases siguientes utilizan objetos Point:

BitmapData
DisplayObject
DisplayObjectContainer
DisplacementMapFilter
NativeWindow
Matrix
Rectangle

Puede utilizar el constructor new Point() para crear un objeto Point.

Ver los ejemplos

Elementos de API relacionados

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

Propiedades públicas

Ocultar propiedades públicas heredadas

Mostrar propiedades públicas heredadas

	Propiedad		Definido por
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object
		length : Number [solo lectura] Longitud del segmento de línea desde (0,0) hasta este punto.	Point
		x : Number Coordenada horizontal del punto.	Point
		y : Number Coordenada vertical del punto.	Point

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		Point(x:Number = 0, y:Number = 0) Crea un nuevo punto.	Point
		add(v:Point):Point Añade las coordenadas de otro punto a las coordenadas de éste para crear un nuevo punto.	Point
		clone():Point Crea una copia de este objeto Point.	Point
		copyFrom(sourcePoint:Point):void Copia todos los datos del punto desde el objeto Point de origen al objeto Point de llamada.	Point
		distance(pt1:Point, pt2:Point):Number [estática] Devuelve la distancia entre pto1 y pto2.	Point
		equals(toCompare:Point):Boolean Determina si dos puntos son iguales.	Point
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		interpolate(pt1:Point, pt2:Point, f:Number):Point [estática] Determina un punto entre dos puntos especificados.	Point
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		normalize(thickness:Number):void Ajusta a una longitud establecida el tamaño del segmento de línea entre (0,0) y el punto actual.	Point
		offset(dx:Number, dy:Number):void Desplaza el objeto Point en la cantidad especificada.	Point
		polar(len:Number, angle:Number):Point [estática] Convierte un par de coordenadas polares en una coordenada cartesiana.	Point
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		setTo(xa:Number, ya:Number):void Define los miembros de Point en los valores especificados	Point
		subtract(v:Point):Point Resta las coordenadas de otro punto de las coordenadas de éste para crear un nuevo punto.	Point
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toString():String Devuelve una cadena que contiene los valores de las coordenadas x e y.	Point
		valueOf():Object Devuelve el valor simple del objeto especificado.	Object

Información sobre propiedades

length

propiedad

length:Number [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Longitud del segmento de línea desde (0,0) hasta este punto.

Implementación
public function get length():Number

Elementos de API relacionados

Point.polar()

x

propiedad

public var x:Number

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Coordenada horizontal del punto. El valor predeterminado es 0.

y

propiedad

public var y:Number

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Coordenada vertical del punto. El valor predeterminado es 0.

Información sobre constructores

()

Información sobre

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

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Crea un nuevo punto. Si no se pasan parámetros a este método, se crea un punto en las coordenadas (0,0).

Parámetros

	`x:Number` (default = `0`) — Coordenada horizontal.

	`y:Number` (default = `0`) — Coordenada vertical.

Información sobre métodos

add

()

método

public function add(v:Point):Point

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Añade las coordenadas de otro punto a las coordenadas de éste para crear un nuevo punto.

Parámetros

v:Point — El punto que se va a añadir.

Valor devuelto

Point — El nuevo punto.

clone

()

método

public function clone():Point

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Crea una copia de este objeto Point.

Valor devuelto

Point — El nuevo objeto Point.

copyFrom

()

método

public function copyFrom(sourcePoint:Point):void

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 11, AIR 3.0, Flash Lite 4

Copia todos los datos del punto desde el objeto Point de origen al objeto Point de llamada.

Parámetros

sourcePoint:Point — El objeto Point desde el que se van a copiar los datos.

distance

()

método

public static function distance(pt1:Point, pt2:Point):Number

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Devuelve la distancia entre pt1 y pt2.

Parámetros

	`pt1:Point` — El primer punto.

	`pt2:Point` — El segundo punto.

Valor devuelto

Number — La distancia entre el primer y el segundo punto.

equals

()

método

public function equals(toCompare:Point):Boolean

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Determina si dos puntos son iguales. Para que se consideren iguales, los dos puntos deben tener los mismos valores x e y.

Parámetros

toCompare:Point — El punto que se va a comparar.

Valor devuelto

Boolean — Un valor true si el objeto equivale a este objeto Point; false si no es igual.

interpolate

()

método

public static function interpolate(pt1:Point, pt2:Point, f:Number):Point

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Determina un punto entre dos puntos especificados. El parámetro f determina la ubicación del nuevo punto interpolado en relación con los dos puntos finales especificados por los parámetros pt1 y pt2. Cuanto más se acerque el valor del parámetro f a 1,0, más cerca estará el punto interpolado del primer punto (parámetro pt1). Cuanto más se acerque el valor del parámetro f a 0, más cerca estará el punto interpolado del segundo punto (parámetro pt2).

Parámetros

	`pt1:Point` — El primer punto.

	`pt2:Point` — El segundo punto.

	`f:Number` — El nivel de interpolación entre dos puntos. Indica la posición del nuevo punto a lo largo de la línea entre `pt1` y `pt2`. Si `f`=1, se devuelve `pt1`; si `f`=0, se devuelve`pt2`.

Valor devuelto

Point — El nuevo punto interpolado.

normalize

()

método

public function normalize(thickness:Number):void

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Ajusta a una longitud establecida el tamaño del segmento de línea entre (0,0) y el punto actual.

Parámetros

thickness:Number — El valor de ajuste a escala. Por ejemplo, si el punto actual se encuentra en las coordenadas (0,5) y se estandariza a 1, el valor que se devuelve es (0,1).

Elementos de API relacionados

length

offset

()

método

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

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Desplaza el objeto Point en la cantidad especificada. El valor de dx se suma al valor original de x para crear un nuevo valor x. El valor de dy se suma al valor original de y para crear un valor y nuevo.

Parámetros

	`dx:Number` — Cantidad que se desplaza la coordenada horizontal, x.

	`dy:Number` — Cantidad que se desplaza la coordenada vertical, y.

polar

()

método

public static function polar(len:Number, angle:Number):Point

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Convierte un par de coordenadas polares en una coordenada cartesiana.

Parámetros

	`len:Number` — La coordenada del par de coordenadas polares que determina la longitud.

	`angle:Number` — El ángulo, en radianes, del par de coordenadas polares.

Valor devuelto

Point — La coordenada cartesiana.

Elementos de API relacionados

length
Math.round()

setTo

()

método

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

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 11, AIR 3.0, Flash Lite 4

Define los miembros de Point en los valores especificados

Parámetros

	`xa:Number` — los valores para establecer el punto.

	`ya:Number`

subtract

()

método

public function subtract(v:Point):Point

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Resta las coordenadas de otro punto de las coordenadas de éste para crear un nuevo punto.

Parámetros

v:Point — El punto que se va a restar.

Valor devuelto

Point — El nuevo punto.

toString

()

método

public function toString():String

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9, Flash Lite 4

Devuelve una cadena que contiene los valores de las coordenadas x e y. La cadena tiene la forma "(x=x, y=y)", por lo que la llamada al método toString() para un punto situado en las coordenadas 23,17 devolvería "(x=23, y=17)".

Valor devuelto

String — Representación de cadena de las coordenadas.

Ejemplos Cómo utilizar este ejemplo

PointExample.as

En el ejemplo siguiente, se utiliza la clase PointExample para crear un número de nuevos objetos Point en distintas coordenadas x,y y, después, se utiliza el métodotrace() para generar los resultados de diversos métodos de la clase.

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

Avisos legales | Política de privacidad en línea

Point - AS3

Paquetesx

Elementos del lenguaje

Apéndices

Paquete flash.geom

length

x

y

Point

add

clone

copyFrom

distance

equals

interpolate

normalize

offset

polar

setTo

subtract

toString