Point

Pacote	flash.geom
Classe	public class Point
Herança	Point Object

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

O objeto Point representa uma localização em um sistema de coordenadas bidimensional, em que x representa o eixo horizontal e y representa o eixo vertical.

O código a seguir cria um ponto em (0,0):

var myPoint:Point = new Point();

Os métodos e propriedades das classes a seguir usam os objetos Point:

BitmapData
DisplayObject
DisplayObjectContainer
DisplacementMapFilter
NativeWindow
Matrix
Retângulo

É possível usar o construtor new Point() para criar um objeto Point.

Veja os exemplos

Elementos da API relacionados

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

Propriedades públicas

Ocultar propriedades públicas herdadas

Mostrar propriedades públicas herdadas

	Propriedade		Definido por
		constructor : Object Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.	Object
		length : Number [somente leitura] Comprimento do segmento de linha de (0,0) até este ponto.	Point
		x : Number Coordenada horizontal do ponto.	Point
		y : Number Coordenada vertical do ponto.	Point

Métodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	Método		Definido por
		Point(x:Number = 0, y:Number = 0) Cria um novo ponto.	Point
		add(v:Point):Point Adiciona as coordenadas de outro ponto às coordenadas deste ponto a fim de criar um novo ponto.	Point
		clone():Point Cria uma cópia deste objeto Point.	Point
		copyFrom(sourcePoint:Point):void Copia todos dos dados de ponto do objeto de origem de Point para o objeto de chamada de Ponto.	Point
		distance(pt1:Point, pt2:Point):Number [estático] Retorna a distância entre pt1 e pt2.	Point
		equals(toCompare:Point):Boolean Determina se dois pontos são iguais.	Point
		hasOwnProperty(name:String):Boolean Indica se um objeto tem uma propriedade especificada definida.	Object
		interpolate(pt1:Point, pt2:Point, f:Number):Point [estático] Determina um ponto entre dois pontos especificados.	Point
		isPrototypeOf(theClass:Object):Boolean Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.	Object
		normalize(thickness:Number):void Dimensiona o segmento de linha entre (0,0) e o ponto atual até um comprimento definido.	Point
		offset(dx:Number, dy:Number):void Desloca o objeto Point pela intensidade especificada.	Point
		polar(len:Number, angle:Number):Point [estático] Converte um par de coordenadas polares em uma coordenada de pontos cartesianos.	Point
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e é enumerável.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Define a disponibilidade de uma propriedade dinâmica para operações de repetição.	Object
		setTo(xa:Number, ya:Number):void Estabelece os integrantes do Point para os valores especificados	Point
		subtract(v:Point):Point Subtrai as coordenadas de outro ponto das coordenadas deste ponto a fim de criar um novo ponto.	Point
		toLocaleString():String Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.	Object
		toString():String Retorna uma string que contém os valores das coordenadas x e y.	Point
		valueOf():Object Retorna o valor primitivo do objeto especificado.	Object

Detalhes da propriedade

length

propriedade

length:Number [somente leitura]

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Comprimento do segmento de linha de (0,0) até este ponto.

Implementação
public function get length():Number

Elementos da API relacionados

Point.polar()

x

propriedade

public var x:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Coordenada horizontal do ponto. O valor padrão é 0.

y

propriedade

public var y:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Coordenada vertical do ponto. O valor padrão é 0.

Detalhes do construtor

()

Construtor

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

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Cria um novo ponto. Se você não transmitir nenhum parâmetro a este método, será criado um ponto em (0,0).

Parâmetros

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

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

Detalhes do método

add

()

método

public function add(v:Point):Point

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Adiciona as coordenadas de outro ponto às coordenadas deste ponto a fim de criar um novo ponto.

Parâmetros

v:Point — Ponto a ser adicionado.

Retorna

Point — Novo ponto.

clone

()

método

public function clone():Point

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Cria uma cópia deste objeto Point.

Retorna

Point — Novo objeto Point.

copyFrom

()

método

public function copyFrom(sourcePoint:Point):void

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 11, AIR 3.0, Flash Lite 4

Copia todos dos dados de ponto do objeto de origem de Point para o objeto de chamada de Ponto.

Parâmetros

sourcePoint:Point — O objeto de Point a partir do qual os dados são copiados.

distance

()

método

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

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Retorna a distância entre pt1 e pt2.

Parâmetros

	`pt1:Point` — Primeiro ponto.

	`pt2:Point` — Segundo ponto.

Retorna

Number — Distância entre o primeiro e o segundo pontos.

equals

()

método

public function equals(toCompare:Point):Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Determina se dois pontos são iguais. Os dois pontos serão iguais se tiverem os mesmos valores x e y.

Parâmetros

toCompare:Point — Ponto a ser comparado.

Retorna

Boolean — Valor true se o objeto for igual a este objeto Point; false se não for.

interpolate

()

método

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

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Determina um ponto entre dois pontos especificados. O parâmetro f determina onde o novo ponto interpolado está localizado com relação aos dois pontos finais especificados pelos parâmetros pt1 e pt2. Quanto mais próximo o valor do parâmetro f estiver de 1.0, mais próximo o ponto interpolado estará do primeiro ponto (parâmetro pt1). Quanto mais próximo o valor do parâmetro f estiver de 0, mais próximo o ponto interpolado estará do segundo ponto (parâmetro pt2).

Parâmetros

	`pt1:Point` — Primeiro ponto.

	`pt2:Point` — Segundo ponto.

	`f:Number` — Nível de interpolação entre os dois pontos. Indica se o novo ponto ficará ao longo da linha entre `pt1` e `pt2`. Se for `f`=1, `pt1` é retornado; se for `f`=0, `pt2` é retornado.

Retorna

Point — Novo ponto interpolado.

normalize

()

método

public function normalize(thickness:Number):void

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Dimensiona o segmento de linha entre (0,0) e o ponto atual até um comprimento definido.

Parâmetros

thickness:Number — Valor de dimensionamento. Por exemplo, se o ponto atual for (0,5), e você normalizá-lo para 1, o ponto retornado estará em (0,1).

Elementos da API relacionados

length

offset

()

método

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

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Desloca o objeto Point pela intensidade especificada. O valor de dx é adicionado ao valor original de x para criar o novo valor x. O valor de dy é adicionado ao valor original de y para criar o novo valor y.

Parâmetros

	`dx:Number` — Intensidade pela qual deslocar a coordenada horizontal, x.

	`dy:Number` — Intensidade pela qual deslocar a coordenada vertical, y.

polar

()

método

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

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Converte um par de coordenadas polares em uma coordenada de pontos cartesianos.

Parâmetros

	`len:Number` — Coordenada de comprimento do par polar.

	`angle:Number` — Ângulo, em radianos, do par polar.

Retorna

Point — Ponto cartesiano.

Elementos da API relacionados

length
Math.round()

setTo

()

método

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

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 11, AIR 3.0, Flash Lite 4

Estabelece os integrantes do Point para os valores especificados

Parâmetros

	`xa:Number` — os valores para estabelecer o ponto.

	`ya:Number`

subtract

()

método

public function subtract(v:Point):Point

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Subtrai as coordenadas de outro ponto das coordenadas deste ponto a fim de criar um novo ponto.

Parâmetros

v:Point — Ponto a ser subtraído.

Retorna

Point — Novo ponto.

toString

()

método

public function toString():String

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Retorna uma string que contém os valores das coordenadas x e y. A string tem a forma "(x=x, y=y)", assim, chamar o método toString() para um ponto em 23,17 retornaria "(x=23, y=17)".

Retorna

String — Representação da string das coordenadas.

Exemplos Como usar este exemplo

PointExample.as

O exemplo a seguir usa a classe PointExample para criar um número de novos objetos Point em várias coordenadas x,y e depois usa o método trace() para criar os resultados de vários métodos de classe.

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

Aspectos jurídicos | Política de privacidade on-line

Point - AS3

Pacotesx

Elementos de linguagem

Apêndices

Pacote flash.geom

length

x

y

Point

add

clone

copyFrom

distance

equals

interpolate

normalize

offset

polar

setTo

subtract

toString