Класс: Phaser.Point
Конструктор
new Point(x, y)
Объект Point представляет расположение в двумерной системе координат, где x представляет горизонтальную ось, а y — вертикальную ось.
Следующий код создает точку в (0,0):var myPoint = new Phaser.Point();
Вы также можете использовать их как 2D-векторы, и в этом классе вы найдете различные методы, связанные с векторами.
Параметры
| Имя | Тип | Аргумент | Значение по умолчанию | Описание |
|---|---|---|---|---|
x | число | <необязательно> | 0 | Горизонтальное положение этой точки. |
y | число | <необязательно> | 0 | Вертикальное положение этой точки. |
- Исходный код: geom/Point.js (Строка 18)
Свойства
- Исходный код: geom/Point.js (Строка 37)
- Исходный код: geom/Point.js (Строка 26)
- Исходный код: geom/Point.js (Строка 31)
[только для чтения] type : число
Постоянный тип этого объекта.
x : число
Значение x точки.
y : число
Значение y точки.
Методы
- Source code: geom/Point.js (Line 491)
- Source code: geom/Point.js (Line 585)
- Source code: geom/Point.js (Line 832)
- Source code: geom/Point.js (Line 684)
- Source code: geom/Point.js (Line 551)
- Source code: geom/Point.js (Line 571)
<static> add(a, b, out) → {Phaser.Point}
Добавляет координаты двух точек, чтобы создать новую точку.
Parameters
| Name | Type | Argument | Description |
|---|---|---|---|
a | Phaser.Point | Первый объект Point. | |
b | Phaser.Point | Второй объект Point. | |
out | Phaser.Point | <optional> | Необязательный объект Point для хранения значения. Если не указан, будет создан новый объект Point. |
Returns
Новый объект Point.
<static> angle(a, b) → {number}
Возвращает угол между двумя объектами Point.
Parameters
| Name | Type | Description |
|---|---|---|
a | Phaser.Point | Первый объект Point. |
b | Phaser.Point | Второй объект Point. |
Returns
Угол между двумя точками.
<static> centroid(points, out) → {Phaser.Point}
Вычисляет центр масс (или середину) из массива точек. Если задана только одна точка, возвращается эта точка.
Parameters
| Name | Type | Argument | Description |
|---|---|---|---|
points | Array.<Phaser.Point> | Массив одной или нескольких точек. | |
out | Phaser.Point | <optional> | Необязательный объект Point для хранения значения. Если не указан, будет создан новый объект Point. |
Returns
Новый объект Point.
<static> distance(a, b, round) → {number}
Возвращает евклидово расстояние от этого объекта Point до заданного объекта (может быть объектом Circle, Point или чем-либо с x/y свойствами).
Parameters
| Name | Type | Argument | Default | Description |
|---|---|---|---|---|
a | object | Объект назначения. Должен иметь видимые свойства x и y, которые представляют центр объекта. | ||
b | object | Объект назначения. Должен иметь видимые свойства x и y, которые представляют центр объекта. | ||
round | boolean | <optional> | false | Округлить расстояние до ближайшего целого числа. |
Returns
Расстояние между этим объектом Point и целевым объектом Point.
<static> divide(a, b, out) → {Phaser.Point}
Делит координаты двух точек, чтобы создать новую точку.
Parameters
| Name | Type | Argument | Description |
|---|---|---|---|
a | Phaser.Point | Первый объект Point. | |
b | Phaser.Point | Второй объект Point. | |
out | Phaser.Point | <optional> | Необязательный объект Point для хранения значения. Если не указан, будет создан новый объект Point. |
Returns
Новый объект Point.
<static> equals(a, b) → {boolean}
Определяет, равны ли два заданных объекта Point. Они считаются равными, если имеют одинаковые значения x и y.
Parameters
| Name | Type | Description |
|---|---|---|
a | Phaser.Point | Первый объект Point. |
b | Phaser.Point | Второй объект Point. |
Returns
Значение true, если точки равны, в противном случае false.
<static> interpolate(a, b, f, out) → {Phaser.Point}
Интерполирует две заданные точки на основе значения f (между 0 и 1) и возвращает новую точку.
Parameters
- Исходный код: geom/Point.js (Строка 634)
- Исходный код: geom/Point.js (Строка 531)
- Исходный код: geom/Point.js (Строка 616)
- Исходный код: geom/Point.js (Строка 600)
- Исходный код: geom/Point.js (Строка 764)
- Исходный код: geom/Point.js (Строка 748)
| Имя | Тип | Аргумент | Описание |
|---|---|---|---|
a | Phaser.Point | Первый объект Point. | |
b | Phaser.Point | Второй объект Point. | |
f | число | Уровень интерполяции между двумя точками. Указывает, где будет расположена новая точка на прямой между pt1 и pt2. Если f=1, возвращается pt1; если f=0, возвращается pt2. | |
out | Phaser.Point | <необязательно> | Необязательный объект Point для хранения значения. Если не указан, будет создан новый объект Point. |
Возвращаемое значение
Новый объект Point.
<статический> multiply(a, b, out) → {Phaser.Point}
Умножает координаты двух точек для создания новой точки.
Параметры
| Имя | Тип | Аргумент | Описание |
|---|---|---|---|
a | Phaser.Point | Первый объект Point. | |
b | Phaser.Point | Второй объект Point. | |
out | Phaser.Point | <необязательно> | Необязательный объект Point для хранения значения. Если не указан, будет создан новый объект Point. |
Возвращаемое значение
Новый объект Point.
<статический> multiplyAdd(a, b, s, out) → {Phaser.Point}
Складывает две 2D точки и умножает результат на заданный скаляр.
Параметры
| Имя | Тип | Аргумент | Описание |
|---|---|---|---|
a | Phaser.Point | Первый объект Point. | |
b | Phaser.Point | Второй объект Point. | |
s | число | Значение масштабирования. | |
out | Phaser.Point | <необязательно> | Необязательный объект Point для хранения значения. Если не указан, будет создан новый объект Point. |
Возвращаемое значение
Новый объект Point.
<статический> negative(a, out) → {Phaser.Point}
Создаёт точку с отрицательными координатами.
Параметры
| Имя | Тип | Аргумент | Описание |
|---|---|---|---|
a | Phaser.Point | Первый объект Point. | |
out | Phaser.Point | <необязательно> | Необязательный объект Point для хранения значения. Если не указан, будет создан новый объект Point. |
Возвращаемое значение
Новый объект Point.
<статический> normalize(a, out) → {Phaser.Point}
Нормализует (делает единичной длины) точку.
Параметры
| Имя | Тип | Аргумент | Описание |
|---|---|---|---|
a | Phaser.Point | Объект Point. | |
out | Phaser.Point | <необязательно> | Необязательный объект Point для хранения значения. Если не указан, будет создан новый объект Point. |
Возвращаемое значение
Новый объект Point.
<статический> normalRightHand(a, out) → {Phaser.Point}
Нормализует точку по правилу правой руки (делает единичной длины).
Параметры
| Имя | Тип | Аргумент | Описание |
|---|---|---|---|
a | Phaser.Point | Объект Point. | |
out | Phaser.Point | <необязательно> | Необязательный объект Point для хранения значения. Если не указан, будет создан новый объект Point. |
Возвращаемое значение
Новый объект Point.
<статический> parse(obj, xProp, yProp) → {Phaser.Point}
Парсит объект на предмет свойств x и/или y и возвращает новую Phaser.Point с соответствующими значениями.
Если объект не содержит этих свойств, возвращается Point с x/y равными нулю.
Параметры
- Исходный код: geom/Point.js (Строка 873)
- Исходный код: geom/Point.js (Строка 652)
- Исходный код: geom/Point.js (Строка 700)
- Исходный код: geom/Point.js (Строка 724)
- Исходный код: geom/Point.js (Строка 787)
- Исходный код: geom/Point.js (Строка 668)
| Имя | Тип | Аргумент | Значение по умолчанию | Описание |
|---|---|---|---|---|
obj | object | Объект для разбора. | ||
xProp | string | <optional> | 'x' | Свойство для установки значения Point.x. |
yProp | string | <optional> | 'y' | Свойство для установки значения Point.y. |
Возвращаемое значение
Новый объект Point.
<static> perp(a, out) → {Phaser.Point}
Возвращает вектор, перпендикулярный исходному (на 90 градусов).
Параметры
| Имя | Тип | Аргумент | Описание |
|---|---|---|---|
a | Phaser.Point | Объект Point. | |
out | Phaser.Point | <optional> | Необязательный объект Point для хранения значения. Если не указан, создаётся новый объект Point. |
Возвращаемое значение
Новый объект Point.
<static> project(a, b, out) → {Phaser.Point}
Проектирует два объекта Point на другой объект Point.
Параметры
| Имя | Тип | Аргумент | Описание |
|---|---|---|---|
a | Phaser.Point | Первый объект Point. | |
b | Phaser.Point | Второй объект Point. | |
out | Phaser.Point | <optional> | Необязательный объект Point для хранения значения. Если не указан, создаётся новый объект Point. |
Возвращаемое значение
Новый объект Point.
<static> projectUnit(a, b, out) → {Phaser.Point}
Проектирует два объекта Point на точку единичной длины.
Параметры
| Имя | Тип | Аргумент | Описание |
|---|---|---|---|
a | Phaser.Point | Первый объект Point. | |
b | Phaser.Point | Второй объект Point. | |
out | Phaser.Point | <optional> | Необязательный объект Point для хранения значения. Если не указан, создаётся новый объект Point. |
Возвращаемое значение
Новый объект Point.
<static> rotate(a, x, y, angle, asDegrees, distance) → {Phaser.Point}
Поворачивает объект Point или любой объект с доступными свойствами x/y вокруг заданных координат на указанный угол.
Если угол между точкой и координатами был 45 градусов, а аргумент угла — 45 градусов, то результирующий угол будет 90 градусов, так как аргумент угла добавляется к текущему углу.
Расстояние позволяет задать ограничение расстояния между точкой и координатами при повороте. Если оно не задано, используется расстояние между двумя точками.
Параметры
| Имя | Тип | Аргумент | Значение по умолчанию | Описание |
|---|---|---|---|---|
a | Phaser.Point | Объект Point для поворота. | ||
x | number | Координата x точки привязки. | ||
y | number | Координата y точки привязки. | ||
angle | number | Угол в радианах (если asDegrees не true) для поворота Point. | ||
asDegrees | boolean | <optional> | false | Угол в радианах (false) или градусах (true)? |
distance | number | <optional> | Необязательное ограничение расстояния между точкой и точкой привязки. |
Возвращаемое значение
Изменённый объект Point.
<static> rperp(a, out) → {Phaser.Point}
Возвращает вектор, перпендикулярный исходному (на -90 градусов).
Параметры
| Имя | Тип | Аргумент | Описание |
|---|---|---|---|
a | Phaser.Point | Объект Point. | |
out | Phaser.Point | <optional> | Необязательный объект Point для хранения значения. Если не указан, создаётся новый объект Point. |
Возвращаемое значение
Новый объект Point.
<static> subtract(a, b, out) → {Phaser.Point}
- Source code: geom/Point.js (Line 511)
- Source code: geom/Point.js (Line 106)
- Source code: geom/Point.js (Line 281)
- Source code: geom/Point.js (Line 463)
- Source code: geom/Point.js (Line 200)
- Source code: geom/Point.js (Line 170)
- Source code: geom/Point.js (Line 185)
- Source code: geom/Point.js (Line 216)
- Source code: geom/Point.js (Line 43)
Вычитает координаты двух точек для создания новой точки.
Parameters
| Name | Type | Argument | Description |
|---|---|---|---|
a | Phaser.Point | Первый объект Point. | |
b | Phaser.Point | Второй объект Point. | |
out | Phaser.Point | <optional> | Необязательный объект Point для хранения значения. Если не указан, будет создан новый объект Point. |
Returns
Новый объект Point.
add(x, y) → {Phaser.Point}
Добавляет заданные значения x и y к этой точке.
Parameters
| Name | Type | Description |
|---|---|---|
x | number | Значение, которое нужно добавить к Point.x. |
y | number | Значение, которое нужно добавить к Point.y. |
Returns
Этот объект Point. Полезно для объединения вызовов методов.
angle(a, asDegrees) → {number}
Возвращает угол между этим объектом Point и другим объектом со свойствами public x и y.
Parameters
| Name | Type | Argument | Default | Description |
|---|---|---|---|---|
a | Phaser.Point | any | Объект, от которого нужно получить угол до этой точки. | ||
asDegrees | boolean | <optional> | false | Указанный угол в радианах (false) или градусах (true)? |
Returns
Угол между двумя объектами.
ceil() → {Phaser.Point}
Math.ceil() для обоих свойств x и y этой точки.
Returns
Этот объект Point.
clamp(min, max) → {Phaser.Point}
Зажимает значения этого объекта Point в диапазоне между заданными min и max.
Parameters
| Name | Type | Description |
|---|---|---|
min | number | Минимальное значение для зажима этой точки. |
max | number | Максимальное значение для зажима этой точки. |
Returns
Этот объект Point.
clampX(min, max) → {Phaser.Point}
Зажимает значение x этой точки в диапазоне между заданными min и max.
Parameters
| Name | Type | Description |
|---|---|---|
min | number | Минимальное значение для зажима этой точки. |
max | number | Максимальное значение для зажима этой точки. |
Returns
Этот объект Point.
clampY(min, max) → {Phaser.Point}
Зажимает значение y этой точки в диапазоне между заданными min и max.
Parameters
| Name | Type | Description |
|---|---|---|
min | number | Минимальное значение для зажима этой точки. |
max | number | Максимальное значение для зажима этой точки. |
Returns
Этот объект Point.
clone(output) → {Phaser.Point}
Создает копию данной точки.
Parameters
| Name | Type | Argument | Description |
|---|---|---|---|
output | Phaser.Point | <optional> | Необязательный объект Point. Если указан, значения будут установлены в этот объект, в противном случае будет создан и возвращен совершенно новый объект Point. |
Returns
Новый объект Point.
copyFrom(source) → {Phaser.Point}
Копирует свойства x и y из любого заданного объекта в эту точку.
Parameters
| Name | Type | Description |
|---|---|---|
source | any | Объект для копирования. |
Returns
Этот объект Point.
copyTo(dest) → {object}
- Исходный код: geom/Point.js (Строка 238)
- Исходный код: geom/Point.js (Строка 402)
- Исходный код: geom/Point.js (Строка 254)
- Исходный код: geom/Point.js (Строка 154)
- Исходный код: geom/Point.js (Строка 389)
- Исходный код: geom/Point.js (Строка 268)
- Исходный код: geom/Point.js (Строка 451)
- Исходный код: geom/Point.js (Строка 321)
- Исходный код: geom/Point.js (Строка 333)
- Исходный код: geom/Point.js (Строка 56)
- Исходный код: geom/Point.js (Строка 377)
Копирует свойства x и y из этого объекта Point в любой заданный объект.
Параметры
| Имя | Тип | Описание |
|---|---|---|
dest | любой | Объект, в который нужно скопировать. |
Возвращает
Объект dest.
cross(a) → {число}
Векторное произведение этого и другого объекта Point.
Параметры
| Имя | Тип | Описание |
|---|---|---|
a | Phaser.Point | Объект Point, с которым нужно вычислить векторное произведение. |
Возвращает
Результат.
distance(dest, round) → {число}
Возвращает расстояние между этим объектом Point и заданным объектом (может быть Circle, Point или чем-то с свойствами x/y)
Параметры
| Имя | Тип | Аргумент | Описание |
|---|---|---|---|
dest | объект | Целевой объект. Должен иметь видимые свойства x и y, представляющие центр объекта. | |
round | boolean | <необязательно> | Округлить расстояние до ближайшего целого числа (по умолчанию false). |
Возвращает
Расстояние между этим объектом Point и объектом Point назначения.
divide(x, y) → {Phaser.Point}
Делит Point.x и Point.y на заданные значения x и y.
Параметры
| Имя | Тип | Описание |
|---|---|---|
x | число | Значение для деления Point.x. |
y | число | Значение для деления Point.x. |
Возвращает
Этот объект Point. Полезно для цепочки вызовов методов.
dot(a) → {число}
Скалярное произведение этого и другого объекта Point.
Параметры
| Имя | Тип | Описание |
|---|---|---|
a | Phaser.Point | Объект Point, с которым нужно вычислить скалярное произведение. |
Возвращает
Результат.
equals(a) → {boolean}
Определяет, равны ли значения x/y заданных объектов этому объекту Point.
Параметры
| Имя | Тип | Описание |
|---|---|---|
a | Phaser.Point | любой | Объект для сравнения с этим объектом Point. |
Возвращает
Значение true, если точки x и y равны, в противном случае false.
floor() → {Phaser.Point}
Функция Math.floor() для свойств x и y этого объекта Point.
Возвращает
Этот объект Point.
getMagnitude() → {число}
Вычисляет длину объекта Point.
Возвращает
Длина объекта Point.
getMagnitudeSq() → {число}
Вычисляет квадрат длины объекта Point.
Возвращает
Квадрат длины объекта Point.
invert() → {Phaser.Point}
Инвертирует значения x и y этого объекта Point.
Возвращает
Этот объект Point.
isZero() → {boolean}
Определяет, находится ли эта точка в координатах 0,0.
Возвращает
True, если эта точка 0,0, иначе false.
multiply(x, y) → {Phaser.Point}
Умножает Point.x и Point.y на заданные значения x и y. Иногда известно как Scale.
Параметры
| Имя | Тип | Описание |
|---|---|---|
x | число | Значение для умножения Point.x. |
y | число | Значение для умножения Point.x. |
Возвращает
Этот объект Point. Полезно для цепочки вызовов методов.
- Source code: geom/Point.js (Line 138)
- Source code: geom/Point.js (Line 358)
- Source code: geom/Point.js (Line 439)
- Source code: geom/Point.js (Line 415)
- Source code: geom/Point.js (Line 304)
- Source code: geom/Point.js (Line 427)
- Source code: geom/Point.js (Line 87)
- Source code: geom/Point.js (Line 345)
- Source code: geom/Point.js (Line 68)
- Source code: geom/Point.js (Line 122)
normalize() → {Phaser.Point}
Изменяет объект Point таким образом, что его длина равна 1, но направление сохраняется.
Возвращает
Этот объект Point.
normalRightHand() → {Phaser.Point}
Нормализация (приведение к единичной длине) этого объекта Point по правилу правой руки.
Возвращает
Этот объект Point.
perp() → {Phaser.Point}
Делает этот объект Point перпендикулярным (поворот на 90 градусов).
Возвращает
Этот объект Point.
rotate(x, y, angle, asDegrees, distance) → {Phaser.Point}
Поворачивает этот объект Point вокруг заданных координат x/y на указанный угол.
Параметры
| Имя | Тип | Аргумент | По умолчанию | Описание |
|---|---|---|---|---|
x | number | Координата x точки привязки. | ||
y | number | Координата y точки привязки. | ||
angle | number | Угол в радианах (если asDegrees не true) на который нужно повернуть Point. | ||
asDegrees | boolean | <optional> | false | Задан угол в радианах (false) или градусах (true)? |
distance | number | <optional> | Необязательное ограничение расстояния между Point и точкой привязки. |
Возвращает
Измененный объект point.
rperp() → {Phaser.Point}
Делает этот объект Point перпендикулярным (-90 градусов поворот).
Возвращает
Этот объект Point.
set(x, y) → {Phaser.Point}
Устанавливает значения x и y этого объекта Point на заданные значения.
Если вы опустите значение y, то значение x будет применено к обоим, например:Point.set(2) — то же самое, что и Point.set(2, 2)
Параметры
| Имя | Тип | Аргумент | Описание |
|---|---|---|---|
x | number | Горизонтальное значение этой точки. | |
y | number | <optional> | Вертикальное значение этой точки. Если не указано, используется значение x. |
Возвращает
Этот объект Point. Полезно для цепочки вызовов методов.
setMagnitude(magnitude) → {Phaser.Point}
Изменяет длину объекта Point без изменения направления.
Параметры
| Имя | Тип | Описание |
|---|---|---|
magnitude | number | Желаемая величина результирующего объекта Point. |
Возвращает
Этот объект Point.
setTo(x, y) → {Phaser.Point}
Устанавливает значения x и y этого объекта Point на заданные значения.
Если вы опустите значение y, то значение x будет применено к обоим, например:Point.setTo(2) — то же самое, что и Point.setTo(2, 2)
Параметры
| Имя | Тип | Аргумент | Описание |
|---|---|---|---|
x | number | Горизонтальное значение этой точки. | |
y | number | <optional> | Вертикальное значение этой точки. Если не указано, используется значение x. |
Возвращает
Этот объект Point. Полезно для цепочки вызовов методов.
subtract(x, y) → {Phaser.Point}
Вычитает заданные значения x и y из этого объекта Point.
Параметры
| Имя | Тип | Описание |
|---|---|---|
x | number | Значение, вычитаемое из Point.x. |
y | number | Значение, вычитаемое из Point.y. |
Возвращает
Этот объект Point. Полезно для цепочки вызовов методов.
toString() → {string}
- Исходный код: geom/Point.js (Строка 475)
Возвращает строковое представление этого объекта.
Возвращает
Строковое представление экземпляра.
© 2016 Richard Davey, Photon Storm Ltd.
Licensed under the MIT License.
http://phaser.io/docs/2.6.2/Phaser.Point.html