Класс 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 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)`	Возвращает хэш-код для точки.
`double`	`getX()`	Координата x.
`double`	`getY()`	Координата y.
`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

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

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)

Возвращает значение хэш-кода для точки.

Переопределяет:: equals в классе Object
Возвращает:: значение хэш-кода для точки.

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.