Point

Пакет	flash.geom
Класс	public class Point
Наследование	Point Object

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Объект Point представляет расположение в двумерной системе координат, где x соответствует горизонтальной оси, а y — вертикальной.

Следующий код позволяет создать точку с координатами (0,0):

var myPoint:Point = new Point();

В методах и свойствах следующих классов используются объекты Point:

BitmapData
DisplayObject
DisplayObjectContainer
DisplacementMapFilter
NativeWindow
Matrix
Прямоугольник

Конструктор new Point() можно использовать для создания объекта Point.

Посмотреть примеры

Связанные элементы API

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

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		length : Number [только для чтения] Длина линии, проходящей через точку (0,0) и эту точку.	Point
		x : Number Горизонтальная координата точки.	Point
		y : Number Вертикальная координата точки.	Point

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		Point(x:Number = 0, y:Number = 0) Создает новую точку.	Point
		add(v:Point):Point Создает новую точку путем добавления координат заданной точки к координатам текущей точки.	Point
		clone():Point Создает копию данного объекта Point.	Point
		copyFrom(sourcePoint:Point):void Копирует все данные точек из исходного объекта Point в вызывающий объект Point.	Point
		distance(pt1:Point, pt2:Point):Number [статические] Возвращает расстояние между точками pt1 и pt2.	Point
		equals(toCompare:Point):Boolean Определяет, равны ли две точки.	Point
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		interpolate(pt1:Point, pt2:Point, f:Number):Point [статические] Определяет точку между двумя заданными точками.	Point
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		normalize(thickness:Number):void Изменяет длину линии между точкой (0,0) и текущей точкой на заданную.	Point
		offset(dx:Number, dy:Number):void Сдвигает объект Point на заданное расстояние.	Point
		polar(len:Number, angle:Number):Point [статические] Преобразует пару полярных координат в декартову точку.	Point
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		setTo(xa:Number, ya:Number):void Задает для членов объекта Point определенные значения	Point
		subtract(v:Point):Point Создает новую точку путем вычитания координат заданной точки из координат текущей точки.	Point
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строку, содержащую значения координат по осям x и y.	Point
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object

Сведения о свойстве

length

свойство

length:Number [только для чтения]

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Длина линии, проходящей через точку (0,0) и эту точку.

Реализация
public function get length():Number

Связанные элементы API

Point.polar()

x

свойство

public var x:Number

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Горизонтальная координата точки. Значением по умолчанию является 0.

y

свойство

public var y:Number

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Вертикальная координата точки. Значением по умолчанию является 0.

Сведения о конструкторе

()

Конструктор

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

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Создает новую точку. Если в этот метод параметры не передаются, создается точка с координатами (0,0).

Параметры

	`x:Number` (default = `0`) — Горизонтальная координата.

	`y:Number` (default = `0`) — Вертикальная координата.

Сведения о методе

add

()

метод

public function add(v:Point):Point

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Создает новую точку путем добавления координат заданной точки к координатам текущей точки.

Параметры

v:Point — Добавляемая точка.

Возвращает

Point — Новая точка.

clone

()

метод

public function clone():Point

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Создает копию данного объекта Point.

Возвращает

Point — Новый объект Point.

copyFrom

()

метод

public function copyFrom(sourcePoint:Point):void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

Flash Player 11, AIR 3.0, Flash Lite 4

Копирует все данные точек из исходного объекта Point в вызывающий объект Point.

Параметры

sourcePoint:Point — Объект Point, из которого следует скопировать данные.

distance

()

метод

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

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Возвращает расстояние между точками pt1 и pt2.

Параметры

	`pt1:Point` — Первая точка.

	`pt2:Point` — Вторая точка.

Возвращает

Number — Расстояние между первой и второй точками.

equals

()

метод

public function equals(toCompare:Point):Boolean

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Определяет, равны ли две точки. Две точки равны, если они имеют одинаковые значения x и y.

Параметры

toCompare:Point — Сравниваемая точка.

Возвращает

Boolean — Возвращается значение true, если объект равен данному объекту Point; false, если не равен.

interpolate

()

метод

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

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Определяет точку между двумя заданными точками. Параметр f определяет положение новой интерполированной точки относительно двух конечных точек, заданных параметрами pt1 и pt2. Чем ближе значение параметра f к 1,0, тем ближе интерполированная точка расположена к первой точке (параметр pt1). Чем ближе значение параметра f к 0, тем ближе интерполированная точка расположена ко второй точке (параметр pt2).

Параметры

	`pt1:Point` — Первая точка.

	`pt2:Point` — Вторая точка.

	`f:Number` — Уровень интерполяции между двумя точками. Обозначает местонахождения новой точки на линии между значениями `pt1` и `pt2`. Если `f`=1, возвращается `pt1`; если `f`=0, возвращается `pt2`.

Возвращает

Point — Новая интерполированная точка.

normalize

()

метод

public function normalize(thickness:Number):void

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Изменяет длину линии между точкой (0,0) и текущей точкой на заданную.

Параметры

thickness:Number — Значение масштабирования. Например, если для текущей точки заданны координаты (0,5) и выполняется нормализация до значения 1, возвращается точка с координатами (0,1).

Связанные элементы API

length

offset

()

метод

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

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Сдвигает объект Point на заданное расстояние. Значение dx добавляется к исходному значению x для получения нового значения x. Значение dy добавляется к исходному значению y для получения нового значения y.

Параметры

	`dx:Number` — Значение коррекции горизонтальной координаты, x.

	`dy:Number` — Значение коррекции вертикальной координаты, y.

polar

()

метод

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

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Преобразует пару полярных координат в декартову точку.

Параметры

	`len:Number` — Длина координаты полярной пары.

	`angle:Number` — Угол (в радианах) полярной пары.

Возвращает

Point — Точка в декартовой системе координат.

Связанные элементы API

length
Math.round()

setTo

()

метод

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

Язык версии:

ActionScript 3.0

Версии среды выполнения:

Flash Player 11, AIR 3.0, Flash Lite 4

Задает для членов объекта Point определенные значения

Параметры

	`xa:Number` — значения, которые следует задать для точки.

	`ya:Number`

subtract

()

метод

public function subtract(v:Point):Point

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Создает новую точку путем вычитания координат заданной точки из координат текущей точки.

Параметры

v:Point — Вычитаемая точка.

Возвращает

Point — Новая точка.

toString

()

метод

public function toString():String

Язык версии:

ActionScript 3.0

Версии среды выполнения:

AIR 1.0, Flash Player 9, Flash Lite 4

Возвращает строку, содержащую значения координат по осям x и y. Строка записана в следующем виде (x=x, y=y), поэтому при вызове метода toString() для точки с координатами 23,17 будет возвращено значение (x=23, y=17).

Возвращает

String — Строковое представление координат.

Примеры Использование этого примера

PointExample.as

В следующем примере класс PointExample используется для создания нескольких новых объектов Point с различными координатами x,y, а затем метод trace() используется для вывода результатов различных методов класса.

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

Юридическая информация | Политика конфиденциальности онлайн

Point - AS3

Классы x

length

x

y

Point

add

clone

copyFrom

distance

equals

interpolate

normalize

offset

polar

setTo

subtract

toString