- java.lang.Object
-
- javafx.geometry.Point3D
-
public class Point3D extends Object
Трехмерная геометрическая точка, обычно представляющая координаты x, y, z. Также может представлять вектор с величинами x, y, z.- С тех пор:
- JavaFX 2.0
-
Краткое описание конструкторов
Конструкторы Конструктор Описание Point3D(double x, double y, double z)Создаёт новый экземплярPoint3D.
-
Краткое описание методов
Все методыМетоды экземпляраКонкретные методы Модификатор и тип Метод Описание Point3Dadd(double x, double y, double z)Возвращает точку с координатами, добавленными к координатам этой точки.Point3Dadd(Point3D point)Возвращает точку с координатами заданной точки, добавленными к координатам этой точки.doubleangle(double x, double y, double z)Вычисляет угол (в градусах) между вектором, представленным этой точкой, и заданным вектором.doubleangle(Point3D point)Вычисляет угол (в градусах) между вектором, представленным этой точкой, и вектором, представленным заданной точкой.doubleangle(Point3D p1, Point3D p2)Вычисляет угол (в градусах) между тремя точками с этой точкой в качестве вершины.Point3DcrossProduct(double x, double y, double z)Вычисляет векторное произведение вектора, представленного данным экземпляром, и заданного вектора.Point3DcrossProduct(Point3D vector)Вычисляет векторное произведение вектора, представленного данным экземпляром, и заданного вектора.doubledistance(double x1, double y1, double z1)Вычисляет расстояние между этой точкой и точкой(x1, y1, z1).doubledistance(Point3D point)Вычисляет расстояние между этой точкой и заданнойpoint.doubledotProduct(double x, double y, double z)Вычисляет скалярное произведение вектора, представленного данным экземпляром, и заданного вектора.doubledotProduct(Point3D vector)Вычисляет скалярное произведение вектора, представленного данным экземпляром, и заданного вектора.booleanequals(Object obj)Возвращает хэш-код для точки.doublegetX()Координата x.doublegetY()Координата y.doublegetZ()Координата z.inthashCode()Возвращает хэш-код для этого объектаPoint3D.doublemagnitude()Вычисляет величину (длину) вектора относительной величины, представленного этим экземпляром.Point3Dmidpoint(double x, double y, double z)Возвращает точку, находящуюся посередине между этой точкой и указанными координатами.Point3Dmidpoint(Point3D point)Возвращает точку, находящуюся посередине между этой точкой и заданной точкой.Point3Dmultiply(double factor)Возвращает точку с координатами этой точки, умноженными на указанный множительPoint3Dnormalize()Нормализует вектор относительной величины, представленный этим экземпляром.Point3Dsubtract(double x, double y, double z)Возвращает точку с координатами, вычтенными из координат этой точки.Point3Dsubtract(Point3D point)Возвращает точку с координатами указанной точки, вычтенными из координат этой точки.StringtoString()Возвращает строковое представление этогоPoint3D.
-
Подробное описание полей
-
ZERO
public static final Point3D ZERO
Точка или вектор с координатами всех трёх осей, равными 0.
-
-
Подробное описание конструкторов
-
Point3D
public Point3D(double x, double y, double z)Создаёт новый экземплярPoint3D.- Параметры:
-
x- Координата XPoint3D -
y- Координата YPoint3D -
z- Координата ZPoint3D
-
-
Метод Detail
-
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
-
equals
public boolean equals(Object obj)
Возвращает значение хэша для точки.
-
hashCode
public int hashCode()
Возвращает значение хэша для этого объектаPoint3D.
-
toString
public String toString()
Возвращает строковое представление этого объектаPoint3D. Этот метод предназначен только для информационных целей. Содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не может бытьnull.
-
© 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.