java.lang.Object
javafx.geometry.Point3D
- All Implemented Interfaces:
Interpolatable<Point3D>
A 3D geometric point that usually represents the x, y, z coordinates.
It can also represent a relative magnitude vector's x, y, z magnitudes.
- Since:
- JavaFX 2.0
-
Field Summary
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionadd
(double x, double y, double z) Returns a point with the specified coordinates added to the coordinates of this point.Returns a point with the coordinates of the specified point added to the coordinates of this point.double
angle
(double x, double y, double z) Computes the angle (in degrees) between the vector represented by this point and the specified vector.double
Computes the angle (in degrees) between the vector represented by this point and the vector represented by the specified point.double
Computes the angle (in degrees) between the three points with this point as a vertex.crossProduct
(double x, double y, double z) Computes cross product of the vector represented by this instance and the specified vector.crossProduct
(Point3D vector) Computes cross product of the vector represented by this instance and the specified vector.double
distance
(double x1, double y1, double z1) Computes the distance between this point and point(x1, y1, z1)
.double
Computes the distance between this point and the specifiedpoint
.double
dotProduct
(double x, double y, double z) Computes dot (scalar) product of the vector represented by this instance and the specified vector.double
dotProduct
(Point3D vector) Computes dot (scalar) product of the vector represented by this instance and the specified vector.boolean
Indicates whether some other object is "equal to" this one.final double
getX()
The x coordinate.final double
getY()
The y coordinate.final double
getZ()
The z coordinate.int
hashCode()
Returns a hash code for thisPoint3D
object.interpolate
(Point3D endValue, double t) The function calculates an interpolated value along the fractiont
between0.0
and1.0
.double
Computes magnitude (length) of the relative magnitude vector represented by this instance.midpoint
(double x, double y, double z) Returns a point which lies in the middle between this point and the specified coordinates.Returns a point which lies in the middle between this point and the specified point.multiply
(double factor) Returns a point with the coordinates of this point multiplied by the specified factorNormalizes the relative magnitude vector represented by this instance.subtract
(double x, double y, double z) Returns a point with the specified coordinates subtracted from the coordinates of this point.Returns a point with the coordinates of the specified point subtracted from the coordinates of this point.toString()
Returns a string representation of thisPoint3D
.
-
Field Details
-
ZERO
Point or vector with all three coordinates set to 0.
-
-
Constructor Details
-
Point3D
public Point3D(double x, double y, double z) Creates a new instance ofPoint3D
.- Parameters:
x
- The X coordinate of thePoint3D
y
- The Y coordinate of thePoint3D
z
- The Z coordinate of thePoint3D
-
-
Method Details
-
getX
public final double getX()The x coordinate.- Returns:
- the x coordinate
-
getY
public final double getY()The y coordinate.- Returns:
- the y coordinate
-
getZ
public final double getZ()The z coordinate.- Returns:
- the z coordinate
-
distance
public double distance(double x1, double y1, double z1) Computes the distance between this point and point(x1, y1, z1)
.- Parameters:
x1
- the x coordinate of other pointy1
- the y coordinate of other pointz1
- the z coordinate of other point- Returns:
- the distance between this point and point
(x1, y1, z1)
.
-
distance
Computes the distance between this point and the specifiedpoint
.- Parameters:
point
- the other point- Returns:
- the distance between this point and the specified
point
. - Throws:
NullPointerException
- if the specifiedpoint
is null
-
add
Returns a point with the specified coordinates added to the coordinates of this point.- Parameters:
x
- the X coordinate additiony
- the Y coordinate additionz
- the Z coordinate addition- Returns:
- the point with added coordinates
- Since:
- JavaFX 8.0
-
add
Returns a point with the coordinates of the specified point added to the coordinates of this point.- Parameters:
point
- the point whose coordinates are to be added- Returns:
- the point with added coordinates
- Throws:
NullPointerException
- if the specifiedpoint
is null- Since:
- JavaFX 8.0
-
subtract
Returns a point with the specified coordinates subtracted from the coordinates of this point.- Parameters:
x
- the X coordinate subtractiony
- the Y coordinate subtractionz
- the Z coordinate subtraction- Returns:
- the point with subtracted coordinates
- Since:
- JavaFX 8.0
-
subtract
Returns a point with the coordinates of the specified point subtracted from the coordinates of this point.- Parameters:
point
- the point whose coordinates are to be subtracted- Returns:
- the point with subtracted coordinates
- Throws:
NullPointerException
- if the specifiedpoint
is null- Since:
- JavaFX 8.0
-
multiply
Returns a point with the coordinates of this point multiplied by the specified factor- Parameters:
factor
- the factor multiplying the coordinates- Returns:
- the point with multiplied coordinates
- Since:
- JavaFX 8.0
-
normalize
Normalizes the relative magnitude vector represented by this instance. Returns a vector with the same direction and magnitude equal to 1. If this is a zero vector, a zero vector is returned.- Returns:
- the normalized vector represented by a
Point3D
instance - Since:
- JavaFX 8.0
-
midpoint
Returns a point which lies in the middle between this point and the specified coordinates.- Parameters:
x
- the X coordinate of the second endpointy
- the Y coordinate of the second endpointz
- the Z coordinate of the second endpoint- Returns:
- the point in the middle
- Since:
- JavaFX 8.0
-
midpoint
Returns a point which lies in the middle between this point and the specified point.- Parameters:
point
- the other endpoint- Returns:
- the point in the middle
- Throws:
NullPointerException
- if the specifiedpoint
is null- Since:
- JavaFX 8.0
-
angle
public double angle(double x, double y, double z) Computes the angle (in degrees) between the vector represented by this point and the specified vector.- Parameters:
x
- the X magnitude of the other vectory
- the Y magnitude of the other vectorz
- the Z magnitude of the other vector- Returns:
- the angle between the two vectors measured in degrees
- Since:
- JavaFX 8.0
-
angle
Computes the angle (in degrees) between the vector represented by this point and the vector represented by the specified point.- Parameters:
point
- the other vector- Returns:
- the angle between the two vectors measured in degrees,
NaN
if any of the two vectors is a zero vector - Throws:
NullPointerException
- if the specifiedpoint
is null- Since:
- JavaFX 8.0
-
angle
Computes the angle (in degrees) between the three points with this point as a vertex.- Parameters:
p1
- one pointp2
- other point- Returns:
- angle between the vectors (this, p1) and (this, p2) measured
in degrees,
NaN
if the three points are not different from one another - Throws:
NullPointerException
- if thep1
orp2
is null- Since:
- JavaFX 8.0
-
magnitude
public double magnitude()Computes magnitude (length) of the relative magnitude vector represented by this instance.- Returns:
- magnitude of the vector
- Since:
- JavaFX 8.0
-
dotProduct
public double dotProduct(double x, double y, double z) Computes dot (scalar) product of the vector represented by this instance and the specified vector.- Parameters:
x
- the X magnitude of the other vectory
- the Y magnitude of the other vectorz
- the Z magnitude of the other vector- Returns:
- the dot product of the two vectors
- Since:
- JavaFX 8.0
-
dotProduct
Computes dot (scalar) product of the vector represented by this instance and the specified vector.- Parameters:
vector
- the other vector- Returns:
- the dot product of the two vectors
- Throws:
NullPointerException
- if the specifiedvector
is null- Since:
- JavaFX 8.0
-
crossProduct
Computes cross product of the vector represented by this instance and the specified vector.- Parameters:
x
- the X magnitude of the other vectory
- the Y magnitude of the other vectorz
- the Z magnitude of the other vector- Returns:
- the cross product of the two vectors
- Since:
- JavaFX 8.0
-
crossProduct
Computes cross product of the vector represented by this instance and the specified vector.- Parameters:
vector
- the other vector- Returns:
- the cross product of the two vectors
- Throws:
NullPointerException
- if the specifiedvector
is null- Since:
- JavaFX 8.0
-
interpolate
The function calculates an interpolated value along the fractiont
between0.0
and1.0
. Whent
= 1.0,endVal
is returned.- Specified by:
interpolate
in interfaceInterpolatable<Point3D>
- Parameters:
endValue
- target valuet
- fraction between0.0
and1.0
- Returns:
- interpolated value
- Since:
- 13
-
equals
Indicates whether some other object is "equal to" this one. Two instances ofPoint3D
are equal if the return values of theirgetX
,getY
, andgetZ
methods are equal. -
hashCode
public int hashCode()Returns a hash code for thisPoint3D
object. -
toString
Returns a string representation of thisPoint3D
. This method is intended to be used only for informational purposes. The content and format of the returned string might vary between implementations. The returned string might be empty but cannot benull
.
-