Module  javafx.graphics
软件包  javafx.geometry

Class Point3D



  • public class Point3D
    extends Object
    通常表示x,y,z坐标的3D几何点。 它也可以表示相对幅度向量的x,y,z幅度。
    从以下版本开始:
    JavaFX 2.0
    • Field Summary

      Fields  
      Modifier and Type Field 描述
      static Point3D ZERO
      所有三个坐标设置为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的点或向量。
    • 构造方法详细信息

      • 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为空
      • 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 - 如果 p1p2为空
        从以下版本开始:
        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)
        返回该点的哈希码值。
        重写:
        equalsObject
        参数
        obj - 与之比较的参考对象。
        结果
        该点的哈希码值。
        另请参见:
        Object.hashCode()HashMap
      • toString

        public String toString​()
        返回此Point3D的字符串表示Point3D 此方法仅用于信息目的。 返回的字符串的内容和格式可能因实现而异。 返回的字符串可能为空,但不能为null
        重写:
        toStringObject
        结果
        对象的字符串表示形式。