Класс 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`	Точка или вектор с координатами x, y, z равными 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)`	Функция вычисляет интерполированное значение вдоль дроби `t` между `0.0` и `1.0`.
`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

END_OF_DOCUMENT_MARKER

интерполировать

public Point3D interpolate(Point3D endValue, double t)

Функция вычисляет интерполированное значение вдоль дроби t между 0.0 и 1.0. Когда t = 1.0, возвращается endVal.

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

equals

public boolean equals(Object obj)

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

Переопределяет:: equals в классе Object
Параметры:: obj - объект-ссылка, с которым нужно сравнить
Возвращает:: true, если этот Point3D такой же, как аргумент-ссылка obj; 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.