Paqueteflash.geom
Clasepublic class Point
HerenciaPoint Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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:

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

Ver los ejemplos

Véase también

flash.display.BitmapData
flash.display.DisplayObject
flash.display.DisplayObjectContainer
flash.filters.DisplacementMapFilter
flash.geom.Matrix
flash.geom.Rectangle
Utilización de objetos Point

Propiedades públicas
 PropiedadDefinido por
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  length : Number
[read-only] Longitud del segmento de línea desde (0,0) hasta este punto.
Point
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
  x : Number
Coordenada horizontal del punto.
Point
  y : Number
Coordenada vertical del punto.
Point
Métodos públicos
 MétodoDefinido 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
  
distance(pt1:Point, pt2:Point):Number
[static] Devuelve la distancia entre pto1 y pto2.
Point
  
equals(toCompare:Point):Boolean
Determina si dos puntos son iguales.
Point
 Inherited
hasOwnProperty(name:String):Boolean
Indica si un objeto tiene definida una propiedad especificada.
Object
  
interpolate(pt1:Point, pt2:Point, f:Number):Point
[static] Determina un punto entre dos puntos especificados.
Point
 Inherited
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
[static] Convierte un par de coordenadas polares en una coordenada cartesiana.
Point
 Inherited
propertyIsEnumerable(name:String):Boolean
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
  
subtract(v:Point):Point
Resta las coordenadas de otro punto de las coordenadas de éste para crear un nuevo punto.
Point
  
toString():String
Devuelve una cadena que contiene los valores de las coordenadas x e y.
Point
 Inherited
valueOf():Object
Devuelve el valor simple del objeto especificado.
Object
Información sobre propiedades
lengthpropiedad
length:Number  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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


Implementación
    public function get length():Number

Véase también

Point.polar()
xpropiedad 
public var x:Number

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Coordenada horizontal del punto. El valor predeterminado es 0.

Véase también

Utilización de objetos Point
ypropiedad 
public var y:Number

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Coordenada vertical del punto. El valor predeterminado es 0.

Véase también

Utilización de objetos Point
Información sobre constructores
Point()constructor
public function Point(x:Number = 0, y:Number = 0)

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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
Versión del reproductor: Flash Player 9

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
Versión del reproductor: Flash Player 9

Crea una copia de este objeto Point.

Valor devuelto
Point — El nuevo objeto Point.
distance()método 
public static function distance(pt1:Point, pt2:Point):Number

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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.

Véase también

Utilización de objetos Point
equals()método 
public function equals(toCompare:Point):Boolean

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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
Versión del reproductor: Flash Player 9

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

Valor devuelto
Point — El nuevo punto interpolado.
normalize()método 
public function normalize(thickness:Number):void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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

Véase también

length
offset()método 
public function offset(dx:Number, dy:Number):void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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
Versión del reproductor: Flash Player 9

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.

Véase también

length
Math.round()
Utilización de objetos Point
subtract()método 
public function subtract(v:Point):Point

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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
Versión del reproductor: Flash Player 9

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 los ejemplos
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°
        trace(Point.polar(4, angle)) // (x=3.464101615137755, y=1.9999999999999998)
        }
    }
}



© 2004-2007 Adobe Systems Incorporated. Todos los derechos reservados.
Fri Oct 12 2007, 2:30 AM GMT-07:00

 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/geom/Point.html