Класс Point3D

java.lang.Object

fx.geometry.Point3D

Все реализованные интерфейсы:: Interpolatable<Point3D>

public class Point3D extends Object implements Interpolatable<Point3D>

Геометрическая 3D-точка, обычно представляющая координаты x, y, z. Также может представлять вектор относительной величины с величинами x, y, z.

С:: JavaFX 2.0

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final Point3D`	`ZERO`	Точка или вектор со всеми тремя координатами, установленными в 0.

Краткое описание конструкторов

Конструктор	Описание
`Point3D(double x, double y, double z)`	Создает новый экземпляр `Point3D`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Point3D`	`add(double x, double y, double z)`	Возвращает точку с координатами, добавленными к координатам этой точки.
`Point3D`	`add(Point3D point)`	Возвращает точку с координатами указанной точки, добавленными к координатам этой точки.
`double`	`angle(double x, double y, double z)`	Вычисляет угол (в градусах) между вектором, представленным этой точкой, и указанным вектором.
`double`	`angle(Point3D point)`	Вычисляет угол (в градусах) между вектором, представленным этой точкой, и вектором, представленным указанной точкой.
`double`	`angle(Point3D p1, Point3D p2)`	Вычисляет угол (в градусах) между тремя точками с этой точкой в качестве вершины.
`Point3D`	`crossProduct(double x, double y, double z)`	Вычисляет векторное произведение вектора, представленного этим экземпляром, и указанного вектора.
`Point3D`	`crossProduct(Point3D vector)`	Вычисляет векторное произведение вектора, представленного этим экземпляром, и указанного вектора.
`double`	`distance(double x1, double y1, double z1)`	Вычисляет расстояние между этой точкой и точкой `(x1, y1, z1)`.
`double`	`distance(Point3D point)`	Вычисляет расстояние между этой точкой и указанной `point`.
`double`	`dotProduct(double x, double y, double z)`	Вычисляет скалярное произведение вектора, представленного этим экземпляром, и указанного вектора.
`double`	`dotProduct(Point3D vector)`	Вычисляет скалярное произведение вектора, представленного этим экземпляром, и указанного вектора.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект "равным" этому.
`final double`	`getX()`	Координата x.
`final double`	`getY()`	Координата y.
`final double`	`getZ()`	Координата z.
`int`	`hashCode()`	Возвращает код хэша для этого объекта `Point3D`.
`Point3D`	`interpolate(Point3D endValue, double t)`	Возвращает промежуточное значение между значением этого `Interpolatable` и указанным `endValue` с использованием линейного коэффициента интерполяции `t`, изменяющегося от 0 (включительно) до 1 (включительно).
`double`	`magnitude()`	Вычисляет величину (длину) вектора относительной величины, представленного этим экземпляром.
`Point3D`	`midpoint(double x, double y, double z)`	Возвращает точку, которая находится посередине между этой точкой и указанными координатами.
`Point3D`	`midpoint(Point3D point)`	Возвращает точку, которая находится посередине между этой точкой и указанной точкой.
`Point3D`	`multiply(double factor)`	Возвращает точку с координатами этой точки, умноженными на указанный множитель.
`Point3D`	`normalize()`	Нормализует вектор относительной величины, представленный этим экземпляром.
`Point3D`	`subtract(double x, double y, double z)`	Возвращает точку с координатами, вычтенными из координат этой точки.
`Point3D`	`subtract(Point3D point)`	Возвращает точку с координатами указанной точки, вычтенными из координат этой точки.
`String`	`toString()`	Возвращает строковое представление этого `Point3D`.

Методы, объявленные в классе java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Подробное описание полей

ZERO

public static final Point3D ZERO

Точка или вектор с тремя координатами, установленными в 0.

Подробное описание конструкторов

Point3D

public Point3D(double x, double y, double z)

Создаёт новый экземпляр Point3D.

Параметры:: x - Координата X Point3D; y - Координата Y Point3D; z - Координата Z Point3D

Подробное описание методов

getX

public final double getX()

Координата x.

Тип интерполяции:: линейный
Возвращает:: координату x

getY

public final double getY()

Координата y.

Тип интерполяции:: линейный
Возвращает:: координату y

getZ

public final double getZ()

Координата z.

Тип интерполяции:: линейный
Возвращает:: координату z

distance

public double distance(double x1, double y1, double z1)

Вычисляет расстояние между этой точкой и точкой (x1, y1, z1).

Параметры:: x1 - координата x другой точки; y1 - координата y другой точки; z1 - координата z другой точки
Возвращает:: расстояние между этой точкой и точкой (x1, y1, z1).

distance

public double distance(Point3D point)

Вычисляет расстояние между этой точкой и заданной point.

Параметры:: point - другая точка
Возвращает:: расстояние между этой точкой и заданной point.
Исключения:: NullPointerException - если указанная point равна null

add

public Point3D add(double x, double y, double z)

Возвращает точку с указанными координатами, добавленными к координатам этой точки.

Параметры:: x - добавление координаты X; y - добавление координаты Y; z - добавление координаты Z
Возвращает:: точку с добавленными координатами
С тех пор:: JavaFX 8.0

add

public Point3D add(Point3D point)

Возвращает точку с координатами указанной точки, добавленными к координатам этой точки.

Параметры:: point - точка, координаты которой должны быть добавлены
Возвращает:: точку с добавленными координатами
Исключения:: NullPointerException - если указанная point равна null
С тех пор:: JavaFX 8.0

subtract

public Point3D subtract(double x, double y, double z)

Возвращает точку с указанными координатами, вычтенными из координат этой точки.

Параметры:: x - вычитание координаты X; y - вычитание координаты Y; z - вычитание координаты Z
Возвращает:: точку с вычтенными координатами
С тех пор:: JavaFX 8.0

subtract

public Point3D subtract(Point3D point)

Возвращает точку с координатами указанной точки, вычтенными из координат этой точки.

Параметры:: point - точка, координаты которой должны быть вычтены
Возвращает:: точку с вычтенными координатами
Исключения:: NullPointerException - если указанная point равна null
С тех пор:: JavaFX 8.0

multiply

public Point3D multiply(double factor)

Возвращает точку с координатами этой точки, умноженными на указанный множитель

Параметры:: factor - множитель, умножающий координаты
Возвращает:: точку с умноженными координатами
С тех пор:: JavaFX 8.0

normalize

public Point3D normalize()

Нормализует вектор относительной величины, представленный этим экземпляром. Возвращает вектор с тем же направлением и величиной, равной 1. Если это нулевой вектор, возвращается нулевой вектор.

Возвращает:: нормализованный вектор, представленный экземпляром Point3D
С тех пор:: JavaFX 8.0

midpoint

public Point3D midpoint(double x, double y, double z)

Возвращает точку, которая находится посередине между этой точкой и заданными координатами.

Параметры:: x - координата X второй конечной точки; y - координата Y второй конечной точки; z - координата Z второй конечной точки
Возвращает:: точку посередине
С тех пор:: JavaFX 8.0

midpoint

public Point3D midpoint(Point3D point)

Возвращает точку, которая находится посередине между этой точкой и указанной точкой.

Параметры:: point - другая конечная точка
Возвращает:: точку посередине
Исключения:: NullPointerException - если указанная point равна null
С тех пор:: JavaFX 8.0

angle

public double angle(double x, double y, double z)

Вычисляет угол (в градусах) между вектором, представленным этой точкой, и указанным вектором.

Параметры:: x - величина X другого вектора; y - величина Y другого вектора; z - величина Z другого вектора
Возвращает:: угол между двумя векторами, измеренный в градусах
С тех пор:: JavaFX 8.0

angle

public double angle(Point3D point)

Вычисляет угол (в градусах) между вектором, представленным этой точкой, и вектором, представленным указанной точкой.

Параметры:: point - другой вектор
Возвращает:: угол между двумя векторами, измеренный в градусах, NaN если какой-либо из двух векторов является нулевым вектором
Исключения:: NullPointerException - если указанный point равен null
С тех пор:: JavaFX 8.0

angle

public double angle(Point3D p1, Point3D p2)

Вычисляет угол (в градусах) между тремя точками с этой точкой в качестве вершины.

Параметры:: p1 - одна точка; p2 - другая точка
Возвращает:: угол между векторами (эта точка, p1) и (эта точка, p2), измеренный в градусах, NaN если три точки не различаются друг от друга
Исключения:: NullPointerException - если p1 или p2 равны null
С тех пор:: JavaFX 8.0

magnitude

public double magnitude()

Вычисляет величину (длину) вектора относительной величины, представленного этим экземпляром.

Возвращает:: величина вектора
С тех пор:: JavaFX 8.0

dotProduct

public double dotProduct(double x, double y, double z)

Вычисляет скалярное произведение вектора, представленного этим экземпляром, и указанного вектора.

Параметры:: x - величина X другого вектора; y - величина Y другого вектора; z - величина Z другого вектора
Возвращает:: скалярное произведение двух векторов
С тех пор:: JavaFX 8.0

dotProduct

public double dotProduct(Point3D vector)

Вычисляет скалярное произведение вектора, представленного этим экземпляром, и указанного вектора.

Параметры:: vector - другой вектор
Возвращает:: скалярное произведение двух векторов
Исключения:: NullPointerException - если указанный vector равен null
С тех пор:: JavaFX 8.0

crossProduct

public Point3D crossProduct(double x, double y, double z)

Вычисляет векторное произведение вектора, представленного этим экземпляром, и указанного вектора.

Параметры:: x - величина X другого вектора; y - величина Y другого вектора; z - величина Z другого вектора
Возвращает:: векторное произведение двух векторов
С момента:: JavaFX 8.0

crossProduct

public Point3D crossProduct(Point3D vector)

Вычисляет векторное произведение вектора, представленного этим экземпляром, и указанного вектора.

Параметры:: vector - другой вектор
Возвращает:: векторное произведение двух векторов
Выбрасывает:: NullPointerException - если указанный vector равен null
С момента:: JavaFX 8.0

interpolate

public Point3D interpolate(Point3D endValue, double t)

Возвращает промежуточное значение между значением этого Interpolatable и указанным endValue с использованием линейного коэффициента интерполяции t, значения которого находятся в диапазоне от 0 (включительно) до 1 (включительно).

Возвращаемое значение может не быть новым экземпляром; реализация также может вернуть один из двух существующих экземпляров, если промежуточное значение будет равно одному из существующих значений. Однако это оптимизация, и приложения не должны предполагать никакой особой идентичности возвращаемого значения.

Определено в:: interpolate в интерфейсе Interpolatable<Point3D>
Параметры:: endValue - целевое значение; t - коэффициент интерполяции
Возвращает:: промежуточное значение
Выбрасывает:: NullPointerException - если endValue равен null
С момента:: 13

equals

public boolean equals(Object obj)

Указывает, является ли какой-либо другой объект "равным" этому. Два экземпляра Point3D равны, если возвращаемые значения их методов getX, getY и getZ равны.

Переопределяет:: equals в классе Object
Параметры:: obj - объект-ссылка для сравнения
Возвращает:: true, если этот Point3D идентичен аргументу-объекту; false в противном случае

hashCode

public int hashCode()

Возвращает хэш-код для этого объекта Point3D.

Переопределяет:: hashCode в классе Object
Возвращает:: хэш-код для этого объекта Point3D.

toString

public String toString()

Возвращает строковое представление этого Point3D. Этот метод предназначен только для информационных целей. Содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не может быть null.

Переопределяет:: toString в классе Object

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.