- java.lang.Object
-
- javafx.geometry.Point3D
-
public class Point3D extends Object
通常表示x,y,z坐标的3D几何点。 它也可以表示相对幅度向量的x,y,z幅度。- 从以下版本开始:
- JavaFX 2.0
-
-
构造方法摘要
构造方法 Constructor 描述 Point3D(double x, double y, double z)
创建一个新的实例Point3D
。
-
方法摘要
所有方法 接口方法 具体的方法 Modifier and Type 方法 描述 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
对象的哈希码。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
的字符串表示Point3D
。
-
-
-
字段详细信息
-
ZERO
public static final Point3D ZERO
所有三个坐标设置为0的点或向量。
-
-
方法详细信息
-
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
为空
-
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
为空 - 从以下版本开始:
- 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
为空 - 从以下版本开始:
- 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
为空 - 从以下版本开始:
- 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
为空 - 从以下版本开始:
- JavaFX 8.0
-
angle
public double angle(Point3D p1, Point3D p2)
计算三点之间的角度(以度为单位),此点作为顶点。- 参数
-
p1
- 一点 -
p2
- 其他一点 - 结果
-
矢量之间的角度(这个,p1)和(这个,p2)以度为单位,
NaN
如果三个点没有不同 - 异常
-
NullPointerException
- 如果p1
或p2
为空 - 从以下版本开始:
- 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
为空 - 从以下版本开始:
- 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
为空 - 从以下版本开始:
- JavaFX 8.0
-
equals
public boolean equals(Object obj)
返回该点的哈希码值。- 重写:
-
equals
在Object
- 参数
-
obj
- 与之比较的参考对象。 - 结果
- 该点的哈希码值。
- 另请参见:
-
Object.hashCode()
,HashMap
-
hashCode
public int hashCode()
返回此Point3D
对象的哈希码。- 重写:
-
hashCode
在Object
- 结果
-
这个
Point3D
对象的哈希码。 - 另请参见:
-
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
-