Class Vector3d
- All Implemented Interfaces:
Externalizable
,Serializable
,Cloneable
,Vector3dc
- Author:
- Richard Greenlees, Kai Burjack, F. Neurath
- See Also:
-
Field Summary
-
Constructor Summary
ConstructorDescriptionVector3d()
Create a newVector3d
with all components set to zero.Vector3d
(double d) Create a newVector3d
and initialize all three components with the given value.Vector3d
(double[] xyz) Create a newVector3d
and initialize its three components from the first three elements of the given array.Vector3d
(double x, double y, double z) Create a newVector3d
with the given component values.Vector3d
(float[] xyz) Create a newVector3d
and initialize its three components from the first three elements of the given array.Vector3d
(int index, ByteBuffer buffer) Create a newVector3d
and read this vector from the suppliedByteBuffer
starting at the specified absolute buffer position/index.Vector3d
(int index, DoubleBuffer buffer) Create a newVector3d
and read this vector from the suppliedDoubleBuffer
starting at the specified absolute buffer position/index.Vector3d
(ByteBuffer buffer) Create a newVector3d
and read this vector from the suppliedByteBuffer
at the current bufferposition
.Vector3d
(DoubleBuffer buffer) Create a newVector3d
and read this vector from the suppliedDoubleBuffer
at the current bufferposition
.Create a newVector3d
whose values will be copied from the given vector.Create a newVector3d
whose values will be copied from the given vector.Create a newVector3d
whose values will be copied from the given vector. -
Method Summary
Modifier and TypeMethodDescriptionabsolute()
Setthis
vector's components to their respective absolute values.Compute the absolute values of the individual components ofthis
and store the result indest
.add
(double x, double y, double z) Increment the components of this vector by the given values.Increment the components of this vector by the given values and store the result indest
.Add the supplied vector to this one.Add the supplied vector to this one and store the result indest
.Add the supplied vector to this one.Add the supplied vector to this one and store the result indest
.double
Return the angle between this vector and the supplied vector.double
Return the cosine of the angle betweenthis
vector and the supplied vector.double
angleSigned
(double x, double y, double z, double nx, double ny, double nz) Return the signed angle between this vector and the supplied vector with respect to the plane with the given normal vector(nx, ny, nz)
.double
angleSigned
(Vector3dc v, Vector3dc n) Return the signed angle between this vector and the supplied vector with respect to the plane with the given normal vectorn
.ceil()
Set each component of this vector to the smallest (closest to negative infinity)double
value that is greater than or equal to that component and is equal to a mathematical integer.Compute for each component of this vector the smallest (closest to negative infinity)double
value that is greater than or equal to that component and is equal to a mathematical integer and store the result indest
.clone()
cross
(double x, double y, double z) Set this vector to be the cross product of itself and(x, y, z)
.Compute the cross product of this vector and(x, y, z)
and store the result indest
.Set this vector to be the cross product of this and v2.Calculate the cross product of this and v2 and store the result indest
.double
distance
(double x, double y, double z) Return the distance betweenthis
vector and(x, y, z)
.static double
distance
(double x1, double y1, double z1, double x2, double y2, double z2) Return the distance between(x1, y1, z1)
and(x2, y2, z2)
.double
Return the distance between this vector andv
.double
distanceSquared
(double x, double y, double z) Return the square of the distance betweenthis
vector and(x, y, z)
.static double
distanceSquared
(double x1, double y1, double z1, double x2, double y2, double z2) Return the squared distance between(x1, y1, z1)
and(x2, y2, z2)
.double
Return the square of the distance between this vector andv
.div
(double scalar) Divide this Vector3d by the given scalar value.div
(double x, double y, double z) Divide the components of this Vector3d by the given scalar values and store the result inthis
.Divide the components of this Vector3f by the given scalar values and store the result indest
.Divide this Vector3d by the given scalar value and store the result indest
.Divide this Vector3d component-wise by another Vector3dc.Divide this byv
component-wise and store the result intodest
.Divide this Vector3d component-wise by another Vector3fc.Divide this Vector3d component-wise by another Vector3f and store the result indest
.double
dot
(double x, double y, double z) Return the dot product of this vector and the vector(x, y, z)
.double
Return the dot product of this vector and the supplied vector.boolean
equals
(double x, double y, double z) Compare the vector components ofthis
vector with the given(x, y, z)
and return whether all of them are equal.boolean
boolean
Compare the vector components ofthis
vector with the given vector using the givendelta
and return whether all of them are equal within a maximum difference ofdelta
.floor()
Set each component of this vector to the largest (closest to positive infinity)double
value that is less than or equal to that component and is equal to a mathematical integer.Compute for each component of this vector the largest (closest to positive infinity)double
value that is less than or equal to that component and is equal to a mathematical integer and store the result indest
.Add the component-wise multiplication ofa * b
to this vector.Add the component-wise multiplication ofa * b
to this vector and store the result indest
.Add the component-wise multiplication ofa * b
to this vector.Add the component-wise multiplication ofa * b
to this vector and store the result indest
.Add the component-wise multiplication ofa * b
to this vector.Add the component-wise multiplication ofa * b
to this vector and store the result indest
.Add the component-wise multiplication ofa * b
to this vector and store the result indest
.Add the component-wise multiplication ofa * b
to this vector.Add the component-wise multiplication ofa * b
to this vector and store the result indest
.double
get
(int component) Get the value of the specified component of this vector.get
(int index, ByteBuffer buffer) Store this vector into the suppliedByteBuffer
starting at the specified absolute buffer position/index.get
(int index, DoubleBuffer buffer) Store this vector into the suppliedDoubleBuffer
starting at the specified absolute buffer position/index.get
(int index, FloatBuffer buffer) Store this vector into the suppliedFloatBuffer
starting at the specified absolute buffer position/index.get
(ByteBuffer buffer) Store this vector into the suppliedByteBuffer
at the current bufferposition
.get
(DoubleBuffer buffer) Store this vector into the suppliedDoubleBuffer
at the current bufferposition
.get
(FloatBuffer buffer) Store this vector into the suppliedFloatBuffer
at the current bufferposition
.Set the components of the given vectordest
to those ofthis
vector.Set the components of the given vectordest
to those ofthis
vector.getf
(int index, ByteBuffer buffer) Store this vector into the suppliedByteBuffer
starting at the specified absolute buffer position/index.getf
(ByteBuffer buffer) Store this vector into the suppliedByteBuffer
at the current bufferposition
.getToAddress
(long address) Store this vector at the given off-heap memory address.half
(double x, double y, double z) Compute the half vector between this and the vector(x, y, z)
.Compute the half vector between this and the vector(x, y, z)
and store the result indest
.Compute the half vector between this and the other vector.Compute the half vector between this and the other vector and store the result indest
.int
hashCode()
Compute a hermite interpolation betweenthis
vector and its associated tangentt0
and the given vectorv
with its tangentt1
and store the result indest
.boolean
isFinite()
double
length()
Return the length of this vector.static double
length
(double x, double y, double z) Get the length of a 3-dimensional double-precision vector.double
Return the length squared of this vector.static double
lengthSquared
(double x, double y, double z) Get the length squared of a 3-dimensional double-precision vector.Linearly interpolatethis
andother
using the given interpolation factort
and store the result inthis
.Linearly interpolatethis
andother
using the given interpolation factort
and store the result indest
.Set the components of this vector to be the component-wise maximum of this and the other vector.Set the components ofdest
to be the component-wise maximum of this and the other vector.int
Determine the component with the biggest absolute value.Set the components of this vector to be the component-wise minimum of this and the other vector.Set the components ofdest
to be the component-wise minimum of this and the other vector.int
Determine the component with the smallest (towards zero) absolute value.mul
(double scalar) Multiply this Vector3d by the given scalar value.mul
(double x, double y, double z) Multiply the components of this Vector3d by the given scalar values and store the result inthis
.Multiply the components of this Vector3f by the given scalar values and store the result indest
.Multiply this Vector3d by the given scalar value and store the result indest
.Multiply the given matrixmat
with this Vector3d.Multiply the given matrixmat
withthis
and store the result indest
.Multiply the given matrixmat
withthis
and store the result indest
.Multiply the given matrixmat
with this Vector3d.Multiply the given matrixmat
withthis
and store the result indest
.mul
(Matrix3x2dc mat) Multiply the given matrix with this Vector3d by assuming a third row in the matrix of(0, 0, 1)
and store the result inthis
.mul
(Matrix3x2dc mat, Vector3d dest) Multiply the given matrixmat
withthis
by assuming a third row in the matrix of(0, 0, 1)
and store the result indest
.mul
(Matrix3x2fc mat) Multiply the given matrix with this Vector3d by assuming a third row in the matrix of(0, 0, 1)
and store the result inthis
.mul
(Matrix3x2fc mat, Vector3d dest) Multiply the given matrixmat
withthis
by assuming a third row in the matrix of(0, 0, 1)
and store the result indest
.Multiply this Vector3d component-wise by another Vector3dc.Multiply this byv
component-wise and store the result intodest
.Multiply this Vector3d component-wise by another Vector3fc.Multiply this Vector3d component-wise by another Vector3f and store the result indest
.Add the component-wise multiplication ofthis * a
tob
and store the result inthis
.Add the component-wise multiplication ofthis * a
tob
and store the result indest
.Add the component-wise multiplication ofthis * a
tob
and store the result inthis
.Add the component-wise multiplication ofthis * a
tob
and store the result indest
.Add the component-wise multiplication ofthis * a
tob
and store the result indest
.mulDirection
(Matrix4dc mat) Multiply the given 4x4 matrixmat
withthis
.mulDirection
(Matrix4dc mat, Vector3d dest) Multiply the given 4x4 matrixmat
withthis
and store the result indest
.mulDirection
(Matrix4fc mat) Multiply the given 4x4 matrixmat
withthis
.mulDirection
(Matrix4fc mat, Vector3d dest) Multiply the given 4x4 matrixmat
withthis
and store the result indest
.mulDirection
(Matrix4x3dc mat) Multiply the given 4x3 matrixmat
withthis
.mulDirection
(Matrix4x3dc mat, Vector3d dest) Multiply the given 4x3 matrixmat
withthis
and store the result indest
.mulDirection
(Matrix4x3fc mat) Multiply the given 4x3 matrixmat
withthis
.mulDirection
(Matrix4x3fc mat, Vector3d dest) Multiply the given 4x3 matrixmat
withthis
and store the result indest
.mulPosition
(Matrix4dc mat) Multiply the given 4x4 matrixmat
withthis
.mulPosition
(Matrix4dc mat, Vector3d dest) Multiply the given 4x4 matrixmat
withthis
and store the result indest
.mulPosition
(Matrix4fc mat) Multiply the given 4x4 matrixmat
withthis
.mulPosition
(Matrix4fc mat, Vector3d dest) Multiply the given 4x4 matrixmat
withthis
and store the result indest
.mulPosition
(Matrix4x3dc mat) Multiply the given 4x3 matrixmat
withthis
.mulPosition
(Matrix4x3dc mat, Vector3d dest) Multiply the given 4x3 matrixmat
withthis
and store the result indest
.mulPosition
(Matrix4x3fc mat) Multiply the given 4x3 matrixmat
withthis
.mulPosition
(Matrix4x3fc mat, Vector3d dest) Multiply the given 4x3 matrixmat
withthis
and store the result indest
.double
mulPositionW
(Matrix4dc mat) Multiply the given 4x4 matrixmat
withthis
and return the w component of the resulting 4D vector.double
mulPositionW
(Matrix4dc mat, Vector3d dest) Multiply the given 4x4 matrixmat
withthis
, store the result indest
and return the w component of the resulting 4D vector.double
mulPositionW
(Matrix4fc mat) Multiply the given 4x4 matrixmat
withthis
and return the w component of the resulting 4D vector.double
mulPositionW
(Matrix4fc mat, Vector3d dest) Multiply the given 4x4 matrixmat
withthis
, store the result indest
and return the w component of the resulting 4D vector.mulProject
(Matrix4dc mat) Multiply the given matrixmat
this Vector3d, perform perspective division.mulProject
(Matrix4dc mat, double w, Vector3d dest) Multiply the given matrixmat
with this Vector3d, perform perspective division and store the result indest
.mulProject
(Matrix4dc mat, Vector3d dest) Multiply the given matrixmat
with this Vector3d, perform perspective division and store the result indest
.mulProject
(Matrix4fc mat) Multiply the given matrixmat
with this Vector3d, perform perspective division.mulProject
(Matrix4fc mat, Vector3d dest) Multiply the given matrixmat
with this Vector3d, perform perspective division and store the result indest
.mulTranspose
(Matrix3dc mat) Multiply the transpose of the given matrix with this Vector3d and store the result inthis
.mulTranspose
(Matrix3dc mat, Vector3d dest) Multiply the transpose of the given matrix with this Vector3f and store the result indest
.mulTranspose
(Matrix3fc mat) Multiply the transpose of the given matrix with this Vector3d and store the result inthis
.mulTranspose
(Matrix3fc mat, Vector3d dest) Multiply the transpose of the given matrix with this Vector3f and store the result indest
.Multiply the transpose of the given 4x4 matrixmat
withthis
.mulTransposeDirection
(Matrix4dc mat, Vector3d dest) Multiply the transpose of the given 4x4 matrixmat
withthis
and store the result indest
.Multiply the transpose of the given 4x4 matrixmat
withthis
.mulTransposeDirection
(Matrix4fc mat, Vector3d dest) Multiply the transpose of the given 4x4 matrixmat
withthis
and store the result indest
.Multiply the transpose of the given 4x4 matrixmat
withthis
.mulTransposePosition
(Matrix4dc mat, Vector3d dest) Multiply the transpose of the given 4x4 matrixmat
withthis
and store the result indest
.Multiply the transpose of the given 4x4 matrixmat
withthis
.mulTransposePosition
(Matrix4fc mat, Vector3d dest) Multiply the transpose of the given 4x4 matrixmat
withthis
and store the result indest
.negate()
Negate this vector.Negate this vector and store the result indest
.Normalize this vector.normalize
(double length) Scale this vector to have the given length.Scale this vector to have the given length and store the result indest
.Normalize this vector and store the result indest
.Transformthis
vector so that it is orthogonal to the given vectorv
and normalize the result.orthogonalize
(Vector3dc v, Vector3d dest) Transformthis
vector so that it is orthogonal to the given vectorv
, normalize the result and store it intodest
.Transformthis
vector so that it is orthogonal to the given unit vectorv
and normalize the result.orthogonalizeUnit
(Vector3dc v, Vector3d dest) Transformthis
vector so that it is orthogonal to the given unit vectorv
, normalize the result and store it intodest
.void
reflect
(double x, double y, double z) Reflect this vector about the given normal vector.Reflect this vector about the given normal vector and store the result indest
.Reflect this vector about the given normal vector.Reflect this vector about the given normal vector and store the result indest
.rotate
(Quaterniondc quat) Rotate this vector by the given quaternionquat
and store the result inthis
.rotate
(Quaterniondc quat, Vector3d dest) Rotate this vector by the given quaternionquat
and store the result indest
.rotateAxis
(double angle, double x, double y, double z) Rotate this vector the specified radians around the given rotation axis.rotateAxis
(double angle, double aX, double aY, double aZ, Vector3d dest) Rotate this vector the specified radians around the given rotation axis and store the result intodest
.rotateX
(double angle) Rotate this vector the specified radians around the X axis.Rotate this vector the specified radians around the X axis and store the result intodest
.rotateY
(double angle) Rotate this vector the specified radians around the Y axis.Rotate this vector the specified radians around the Y axis and store the result intodest
.rotateZ
(double angle) Rotate this vector the specified radians around the Z axis.Rotate this vector the specified radians around the Z axis and store the result intodest
.rotationTo
(double toDirX, double toDirY, double toDirZ, Quaterniond dest) Compute the quaternion representing a rotation ofthis
vector to point along(toDirX, toDirY, toDirZ)
and store the result indest
.rotationTo
(Vector3dc toDir, Quaterniond dest) Compute the quaternion representing a rotation ofthis
vector to point alongtoDir
and store the result indest
.round()
Set each component of this vector to the closest double that is equal to a mathematical integer, with ties rounding to positive infinity.Compute for each component of this vector the closest double that is equal to a mathematical integer, with ties rounding to positive infinity and store the result indest
.set
(double d) Set the x, y, and z components to the supplied value.set
(double[] xyz) Set the three components of this vector to the first three elements of the given array.set
(double x, double y, double z) Set the x, y and z components to the supplied values.set
(float[] xyz) Set the three components of this vector to the first three elements of the given array.set
(int index, ByteBuffer buffer) Read this vector from the suppliedByteBuffer
starting at the specified absolute buffer position/index.set
(int index, DoubleBuffer buffer) Read this vector from the suppliedDoubleBuffer
starting at the specified absolute buffer position/index.set
(ByteBuffer buffer) Read this vector from the suppliedByteBuffer
at the current bufferposition
.set
(DoubleBuffer buffer) Read this vector from the suppliedDoubleBuffer
at the current bufferposition
.Set the first two components from the givenv
and the z component from the givenz
Set the first two components from the givenv
and the z component from the givenz
Set the first two components from the givenv
and the z component from the givenz
Set the x, y and z components to match the supplied vector.Set the x, y and z components to match the supplied vector.Set the x, y and z components to match the supplied vector.setComponent
(int component, double value) Set the value of the specified component of this vector.setFromAddress
(long address) Set the values of this vector by reading 3 double values from off-heap memory, starting at the given address.smoothStep
(Vector3dc v, double t, Vector3d dest) Compute a smooth-step (i.e.sub
(double x, double y, double z) Subtract(x, y, z)
from this vector.Subtract(x, y, z)
from this vector and store the result indest
.Subtract the supplied vector from this one.Subtract the supplied vector from this one and store the result indest
.Subtract the supplied vector from this one.Subtract the supplied vector from this one and store the result indest
.toString()
Return a string representation of this vector.toString
(NumberFormat formatter) Return a string representation of this vector by formatting the vector components with the givenNumberFormat
.void
double
x()
double
y()
double
z()
zero()
Set all components to zero.
-
Field Details
-
x
public double xThe x component of the vector. -
y
public double yThe y component of the vector. -
z
public double zThe z component of the vector.
-
-
Constructor Details
-
Vector3d
public Vector3d()Create a newVector3d
with all components set to zero. -
Vector3d
public Vector3d(double d) Create a newVector3d
and initialize all three components with the given value.- Parameters:
d
- the value of all three components
-
Vector3d
public Vector3d(double x, double y, double z) Create a newVector3d
with the given component values.- Parameters:
x
- the value of xy
- the value of yz
- the value of z
-
Vector3d
Create a newVector3d
whose values will be copied from the given vector.- Parameters:
v
- provides the initial values for the new vector
-
Vector3d
Create a newVector3d
whose values will be copied from the given vector.- Parameters:
v
- provides the initial values for the new vector
-
Vector3d
- Parameters:
v
- theVector2fc
to copy the values fromz
- the z component
-
Vector3d
- Parameters:
v
- theVector2ic
to copy the values fromz
- the z component
-
Vector3d
Create a newVector3d
whose values will be copied from the given vector.- Parameters:
v
- provides the initial values for the new vector
-
Vector3d
- Parameters:
v
- theVector2d
to copy the values fromz
- the z component
-
Vector3d
public Vector3d(double[] xyz) Create a newVector3d
and initialize its three components from the first three elements of the given array.- Parameters:
xyz
- the array containing at least three elements
-
Vector3d
public Vector3d(float[] xyz) Create a newVector3d
and initialize its three components from the first three elements of the given array.- Parameters:
xyz
- the array containing at least three elements
-
Vector3d
Create a newVector3d
and read this vector from the suppliedByteBuffer
at the current bufferposition
.This method will not increment the position of the given ByteBuffer.
In order to specify the offset into the ByteBuffer at which the vector is read, use
Vector3d(int, ByteBuffer)
, taking the absolute position as parameter.- Parameters:
buffer
- values will be read inx, y, z
order- See Also:
-
Vector3d
Create a newVector3d
and read this vector from the suppliedByteBuffer
starting at the specified absolute buffer position/index.This method will not increment the position of the given ByteBuffer.
- Parameters:
index
- the absolute position into the ByteBufferbuffer
- values will be read inx, y, z
order
-
Vector3d
Create a newVector3d
and read this vector from the suppliedDoubleBuffer
at the current bufferposition
.This method will not increment the position of the given DoubleBuffer.
In order to specify the offset into the DoubleBuffer at which the vector is read, use
Vector3d(int, DoubleBuffer)
, taking the absolute position as parameter.- Parameters:
buffer
- values will be read inx, y, z
order- See Also:
-
Vector3d
Create a newVector3d
and read this vector from the suppliedDoubleBuffer
starting at the specified absolute buffer position/index.This method will not increment the position of the given DoubleBuffer.
- Parameters:
index
- the absolute position into the DoubleBufferbuffer
- values will be read inx, y, z
order
-
-
Method Details
-
x
public double x() -
y
public double y() -
z
public double z() -
set
Set the x, y and z components to match the supplied vector.- Parameters:
v
- the vector to set this vector's components from- Returns:
- this
-
set
Set the x, y and z components to match the supplied vector.- Parameters:
v
- the vector to set this vector's components from- Returns:
- this
-
set
Set the first two components from the givenv
and the z component from the givenz
- Parameters:
v
- theVector2dc
to copy the values fromz
- the z component- Returns:
- this
-
set
Set the first two components from the givenv
and the z component from the givenz
- Parameters:
v
- theVector2ic
to copy the values fromz
- the z component- Returns:
- this
-
set
Set the x, y and z components to match the supplied vector.- Parameters:
v
- the vector to set this vector's components from- Returns:
- this
-
set
Set the first two components from the givenv
and the z component from the givenz
- Parameters:
v
- theVector2fc
to copy the values fromz
- the z component- Returns:
- this
-
set
Set the x, y, and z components to the supplied value.- Parameters:
d
- the value of all three components- Returns:
- this
-
set
Set the x, y and z components to the supplied values.- Parameters:
x
- the x componenty
- the y componentz
- the z component- Returns:
- this
-
set
Set the three components of this vector to the first three elements of the given array.- Parameters:
xyz
- the array containing at least three elements- Returns:
- this
-
set
Set the three components of this vector to the first three elements of the given array.- Parameters:
xyz
- the array containing at least three elements- Returns:
- this
-
set
Read this vector from the suppliedByteBuffer
at the current bufferposition
.This method will not increment the position of the given ByteBuffer.
In order to specify the offset into the ByteBuffer at which the vector is read, use
set(int, ByteBuffer)
, taking the absolute position as parameter.- Parameters:
buffer
- values will be read inx, y, z
order- Returns:
- this
- See Also:
-
set
Read this vector from the suppliedByteBuffer
starting at the specified absolute buffer position/index.This method will not increment the position of the given ByteBuffer.
- Parameters:
index
- the absolute position into the ByteBufferbuffer
- values will be read inx, y, z
order- Returns:
- this
-
set
Read this vector from the suppliedDoubleBuffer
at the current bufferposition
.This method will not increment the position of the given DoubleBuffer.
In order to specify the offset into the DoubleBuffer at which the vector is read, use
set(int, DoubleBuffer)
, taking the absolute position as parameter.- Parameters:
buffer
- values will be read inx, y, z
order- Returns:
- this
- See Also:
-
set
Read this vector from the suppliedDoubleBuffer
starting at the specified absolute buffer position/index.This method will not increment the position of the given DoubleBuffer.
- Parameters:
index
- the absolute position into the DoubleBufferbuffer
- values will be read inx, y, z
order- Returns:
- this
-
setFromAddress
Set the values of this vector by reading 3 double values from off-heap memory, starting at the given address.This method will throw an
UnsupportedOperationException
when JOML is used with `-Djoml.nounsafe`.This method is unsafe as it can result in a crash of the JVM process when the specified address range does not belong to this process.
- Parameters:
address
- the off-heap memory address to read the vector values from- Returns:
- this
-
setComponent
Set the value of the specified component of this vector.- Parameters:
component
- the component whose value to set, within[0..2]
value
- the value to set- Returns:
- this
- Throws:
IllegalArgumentException
- ifcomponent
is not within[0..2]
-
get
Description copied from interface:Vector3dc
Store this vector into the suppliedByteBuffer
at the current bufferposition
.This method will not increment the position of the given ByteBuffer.
In order to specify the offset into the ByteBuffer at which the vector is stored, use
Vector3dc.get(int, ByteBuffer)
, taking the absolute position as parameter. -
get
Description copied from interface:Vector3dc
Store this vector into the suppliedByteBuffer
starting at the specified absolute buffer position/index.This method will not increment the position of the given ByteBuffer.
-
get
Description copied from interface:Vector3dc
Store this vector into the suppliedDoubleBuffer
at the current bufferposition
.This method will not increment the position of the given DoubleBuffer.
In order to specify the offset into the DoubleBuffer at which the vector is stored, use
Vector3dc.get(int, DoubleBuffer)
, taking the absolute position as parameter. -
get
Description copied from interface:Vector3dc
Store this vector into the suppliedDoubleBuffer
starting at the specified absolute buffer position/index.This method will not increment the position of the given DoubleBuffer.
-
getf
Description copied from interface:Vector3dc
Store this vector into the suppliedByteBuffer
at the current bufferposition
.This method will not increment the position of the given ByteBuffer.
In order to specify the offset into the ByteBuffer at which the vector is stored, use
Vector3dc.get(int, ByteBuffer)
, taking the absolute position as parameter.Please note that due to this vector storing double values those values will potentially lose precision when they are converted to float values before being put into the given ByteBuffer.
-
getf
Description copied from interface:Vector3dc
Store this vector into the suppliedByteBuffer
starting at the specified absolute buffer position/index.This method will not increment the position of the given ByteBuffer.
Please note that due to this vector storing double values those values will potentially lose precision when they are converted to float values before being put into the given ByteBuffer.
-
get
Description copied from interface:Vector3dc
Store this vector into the suppliedFloatBuffer
at the current bufferposition
.This method will not increment the position of the given FloatBuffer.
In order to specify the offset into the FloatBuffer at which the vector is stored, use
Vector3dc.get(int, FloatBuffer)
, taking the absolute position as parameter.Please note that due to this vector storing double values those values will potentially lose precision when they are converted to float values before being put into the given FloatBuffer.
-
get
Description copied from interface:Vector3dc
Store this vector into the suppliedFloatBuffer
starting at the specified absolute buffer position/index.This method will not increment the position of the given FloatBuffer.
Please note that due to this vector storing double values those values will potentially lose precision when they are converted to float values before being put into the given FloatBuffer.
-
getToAddress
Description copied from interface:Vector3dc
Store this vector at the given off-heap memory address.This method will throw an
UnsupportedOperationException
when JOML is used with `-Djoml.nounsafe`.This method is unsafe as it can result in a crash of the JVM process when the specified address range does not belong to this process.
- Specified by:
getToAddress
in interfaceVector3dc
- Parameters:
address
- the off-heap address where to store this vector- Returns:
- this
-
sub
Subtract the supplied vector from this one.- Parameters:
v
- the vector to subtract from this- Returns:
- this
-
sub
Description copied from interface:Vector3dc
Subtract the supplied vector from this one and store the result indest
. -
sub
Subtract the supplied vector from this one.- Parameters:
v
- the vector to subtract from this- Returns:
- this
-
sub
Description copied from interface:Vector3dc
Subtract the supplied vector from this one and store the result indest
. -
sub
Subtract(x, y, z)
from this vector.- Parameters:
x
- the x component to subtracty
- the y component to subtractz
- the z component to subtract- Returns:
- this
-
sub
Description copied from interface:Vector3dc
Subtract(x, y, z)
from this vector and store the result indest
. -
add
Add the supplied vector to this one.- Parameters:
v
- the vector to add- Returns:
- this
-
add
Description copied from interface:Vector3dc
Add the supplied vector to this one and store the result indest
. -
add
Add the supplied vector to this one.- Parameters:
v
- the vector to add- Returns:
- this
-
add
Description copied from interface:Vector3dc
Add the supplied vector to this one and store the result indest
. -
add
Increment the components of this vector by the given values.- Parameters:
x
- the x component to addy
- the y component to addz
- the z component to add- Returns:
- this
-
add
Description copied from interface:Vector3dc
Increment the components of this vector by the given values and store the result indest
. -
fma
Add the component-wise multiplication ofa * b
to this vector.- Parameters:
a
- the first multiplicandb
- the second multiplicand- Returns:
- this
-
fma
Add the component-wise multiplication ofa * b
to this vector.- Parameters:
a
- the first multiplicandb
- the second multiplicand- Returns:
- this
-
fma
Add the component-wise multiplication ofa * b
to this vector.- Parameters:
a
- the first multiplicandb
- the second multiplicand- Returns:
- this
-
fma
Description copied from interface:Vector3dc
Add the component-wise multiplication ofa * b
to this vector and store the result indest
. -
fma
Add the component-wise multiplication ofa * b
to this vector.- Parameters:
a
- the first multiplicandb
- the second multiplicand- Returns:
- this
-
fma
Description copied from interface:Vector3dc
Add the component-wise multiplication ofa * b
to this vector and store the result indest
. -
fma
Description copied from interface:Vector3dc
Add the component-wise multiplication ofa * b
to this vector and store the result indest
. -
fma
Description copied from interface:Vector3dc
Add the component-wise multiplication ofa * b
to this vector and store the result indest
. -
fma
Description copied from interface:Vector3dc
Add the component-wise multiplication ofa * b
to this vector and store the result indest
. -
mulAdd
Add the component-wise multiplication ofthis * a
tob
and store the result inthis
.- Parameters:
a
- the multiplicandb
- the addend- Returns:
- this
-
mulAdd
Add the component-wise multiplication ofthis * a
tob
and store the result inthis
.- Parameters:
a
- the multiplicandb
- the addend- Returns:
- this
-
mulAdd
Description copied from interface:Vector3dc
Add the component-wise multiplication ofthis * a
tob
and store the result indest
. -
mulAdd
Description copied from interface:Vector3dc
Add the component-wise multiplication ofthis * a
tob
and store the result indest
. -
mulAdd
Description copied from interface:Vector3dc
Add the component-wise multiplication ofthis * a
tob
and store the result indest
. -
mul
Multiply this Vector3d component-wise by another Vector3dc.- Parameters:
v
- the vector to multiply by- Returns:
- this
-
mul
Multiply this Vector3d component-wise by another Vector3fc.- Parameters:
v
- the vector to multiply by- Returns:
- this
-
mul
Description copied from interface:Vector3dc
Multiply this Vector3d component-wise by another Vector3f and store the result indest
. -
mul
Description copied from interface:Vector3dc
Multiply this byv
component-wise and store the result intodest
. -
div
Divide this Vector3d component-wise by another Vector3dc.- Parameters:
v
- the vector to divide by- Returns:
- this
-
div
Divide this Vector3d component-wise by another Vector3fc.- Parameters:
v
- the vector to divide by- Returns:
- this
-
div
Description copied from interface:Vector3dc
Divide this Vector3d component-wise by another Vector3f and store the result indest
. -
div
Description copied from interface:Vector3dc
Divide this byv
component-wise and store the result intodest
. -
mulProject
Description copied from interface:Vector3dc
Multiply the given matrixmat
with this Vector3d, perform perspective division and store the result indest
.This method uses the given
w
as the fourth vector component.- Specified by:
mulProject
in interfaceVector3dc
- Parameters:
mat
- the matrix to multiply this vector byw
- the w component to usedest
- will hold the result- Returns:
- dest
-
mulProject
Description copied from interface:Vector3dc
Multiply the given matrixmat
with this Vector3d, perform perspective division and store the result indest
.This method uses
w=1.0
as the fourth vector component.- Specified by:
mulProject
in interfaceVector3dc
- Parameters:
mat
- the matrix to multiply this vector bydest
- will hold the result- Returns:
- dest
-
mulProject
Multiply the given matrixmat
this Vector3d, perform perspective division.This method uses
w=1.0
as the fourth vector component.- Parameters:
mat
- the matrix to multiply this vector by- Returns:
- this
-
mulProject
Description copied from interface:Vector3dc
Multiply the given matrixmat
with this Vector3d, perform perspective division and store the result indest
.This method uses
w=1.0
as the fourth vector component.- Specified by:
mulProject
in interfaceVector3dc
- Parameters:
mat
- the matrix to multiply this vector bydest
- will hold the result- Returns:
- dest
-
mulProject
Multiply the given matrixmat
with this Vector3d, perform perspective division.This method uses
w=1.0
as the fourth vector component.- Parameters:
mat
- the matrix to multiply this vector by- Returns:
- this
-
mul
Multiply the given matrixmat
with this Vector3d.- Parameters:
mat
- the matrix to multiply this vector by- Returns:
- this
-
mul
Multiply the given matrixmat
with this Vector3d.- Parameters:
mat
- the matrix to multiply this vector by- Returns:
- this
-
mul
Description copied from interface:Vector3dc
Multiply the given matrixmat
withthis
and store the result indest
. -
mul
Description copied from interface:Vector3dc
Multiply the given matrixmat
withthis
and store the result indest
. -
mul
Description copied from interface:Vector3dc
Multiply the given matrixmat
withthis
and store the result indest
. -
mul
Multiply the given matrix with this Vector3d by assuming a third row in the matrix of(0, 0, 1)
and store the result inthis
.- Parameters:
mat
- the matrix- Returns:
- this
-
mul
Description copied from interface:Vector3dc
Multiply the given matrixmat
withthis
by assuming a third row in the matrix of(0, 0, 1)
and store the result indest
. -
mul
Multiply the given matrix with this Vector3d by assuming a third row in the matrix of(0, 0, 1)
and store the result inthis
.- Parameters:
mat
- the matrix- Returns:
- this
-
mul
Description copied from interface:Vector3dc
Multiply the given matrixmat
withthis
by assuming a third row in the matrix of(0, 0, 1)
and store the result indest
. -
mulTranspose
Multiply the transpose of the given matrix with this Vector3d and store the result inthis
.- Parameters:
mat
- the matrix- Returns:
- this
-
mulTranspose
Description copied from interface:Vector3dc
Multiply the transpose of the given matrix with this Vector3f and store the result indest
.- Specified by:
mulTranspose
in interfaceVector3dc
- Parameters:
mat
- the matrixdest
- will hold the result- Returns:
- dest
-
mulTranspose
Multiply the transpose of the given matrix with this Vector3d and store the result inthis
.- Parameters:
mat
- the matrix- Returns:
- this
-
mulTranspose
Description copied from interface:Vector3dc
Multiply the transpose of the given matrix with this Vector3f and store the result indest
.- Specified by:
mulTranspose
in interfaceVector3dc
- Parameters:
mat
- the matrixdest
- will hold the result- Returns:
- dest
-
mulPosition
Multiply the given 4x4 matrixmat
withthis
.This method assumes the
w
component ofthis
to be1.0
.- Parameters:
mat
- the matrix to multiply this vector by- Returns:
- this
-
mulPosition
Multiply the given 4x4 matrixmat
withthis
.This method assumes the
w
component ofthis
to be1.0
.- Parameters:
mat
- the matrix to multiply this vector by- Returns:
- this
-
mulPosition
Multiply the given 4x3 matrixmat
withthis
.This method assumes the
w
component ofthis
to be1.0
.- Parameters:
mat
- the matrix to multiply this vector by- Returns:
- this
-
mulPosition
Multiply the given 4x3 matrixmat
withthis
.This method assumes the
w
component ofthis
to be1.0
.- Parameters:
mat
- the matrix to multiply this vector by- Returns:
- this
-
mulPosition
Description copied from interface:Vector3dc
Multiply the given 4x4 matrixmat
withthis
and store the result indest
.This method assumes the
w
component ofthis
to be1.0
.- Specified by:
mulPosition
in interfaceVector3dc
- Parameters:
mat
- the matrix to multiply this vector bydest
- will hold the result- Returns:
- dest
-
mulPosition
Description copied from interface:Vector3dc
Multiply the given 4x4 matrixmat
withthis
and store the result indest
.This method assumes the
w
component ofthis
to be1.0
.- Specified by:
mulPosition
in interfaceVector3dc
- Parameters:
mat
- the matrix to multiply this vector bydest
- will hold the result- Returns:
- dest
-
mulPosition
Description copied from interface:Vector3dc
Multiply the given 4x3 matrixmat
withthis
and store the result indest
.This method assumes the
w
component ofthis
to be1.0
.- Specified by:
mulPosition
in interfaceVector3dc
- Parameters:
mat
- the matrix to multiply this vector bydest
- will hold the result- Returns:
- dest
-
mulPosition
Description copied from interface:Vector3dc
Multiply the given 4x3 matrixmat
withthis
and store the result indest
.This method assumes the
w
component ofthis
to be1.0
.- Specified by:
mulPosition
in interfaceVector3dc
- Parameters:
mat
- the matrix to multiply this vector bydest
- will hold the result- Returns:
- dest
-
mulTransposePosition
Multiply the transpose of the given 4x4 matrixmat
withthis
.This method assumes the
w
component ofthis
to be1.0
.- Parameters:
mat
- the matrix whose transpose to multiply this vector by- Returns:
- this
-
mulTransposePosition
Description copied from interface:Vector3dc
Multiply the transpose of the given 4x4 matrixmat
withthis
and store the result indest
.This method assumes the
w
component ofthis
to be1.0
.- Specified by:
mulTransposePosition
in interfaceVector3dc
- Parameters:
mat
- the matrix whose transpose to multiply this vector bydest
- will hold the result- Returns:
- dest
-
mulTransposePosition
Multiply the transpose of the given 4x4 matrixmat
withthis
.This method assumes the
w
component ofthis
to be1.0
.- Parameters:
mat
- the matrix whose transpose to multiply this vector by- Returns:
- this
-
mulTransposePosition
Description copied from interface:Vector3dc
Multiply the transpose of the given 4x4 matrixmat
withthis
and store the result indest
.This method assumes the
w
component ofthis
to be1.0
.- Specified by:
mulTransposePosition
in interfaceVector3dc
- Parameters:
mat
- the matrix whose transpose to multiply this vector bydest
- will hold the result- Returns:
- dest
-
mulPositionW
Multiply the given 4x4 matrixmat
withthis
and return the w component of the resulting 4D vector.This method assumes the
w
component ofthis
to be1.0
.- Parameters:
mat
- the matrix to multiply this vector by- Returns:
- the w component of the resulting 4D vector after multiplication
-
mulPositionW
Description copied from interface:Vector3dc
Multiply the given 4x4 matrixmat
withthis
, store the result indest
and return the w component of the resulting 4D vector.This method assumes the
w
component ofthis
to be1.0
.- Specified by:
mulPositionW
in interfaceVector3dc
- Parameters:
mat
- the matrix to multiply this vector bydest
- will hold the(x, y, z)
components of the resulting vector- Returns:
- the w component of the resulting 4D vector after multiplication
-
mulPositionW
Multiply the given 4x4 matrixmat
withthis
and return the w component of the resulting 4D vector.This method assumes the
w
component ofthis
to be1.0
.- Parameters:
mat
- the matrix to multiply this vector by- Returns:
- the w component of the resulting 4D vector after multiplication
-
mulPositionW
Description copied from interface:Vector3dc
Multiply the given 4x4 matrixmat
withthis
, store the result indest
and return the w component of the resulting 4D vector.This method assumes the
w
component ofthis
to be1.0
.- Specified by:
mulPositionW
in interfaceVector3dc
- Parameters:
mat
- the matrix to multiply this vector bydest
- will hold the(x, y, z)
components of the resulting vector- Returns:
- the w component of the resulting 4D vector after multiplication
-
mulDirection
Multiply the given 4x4 matrixmat
withthis
.This method assumes the
w
component ofthis
to be0.0
.- Parameters:
mat
- the matrix to multiply this vector by- Returns:
- this
-
mulDirection
Multiply the given 4x4 matrixmat
withthis
.This method assumes the
w
component ofthis
to be0.0
.- Parameters:
mat
- the matrix to multiply this vector by- Returns:
- this
-
mulDirection
Multiply the given 4x3 matrixmat
withthis
.This method assumes the
w
component ofthis
to be0.0
.- Parameters:
mat
- the matrix to multiply this vector by- Returns:
- this
-
mulDirection
Multiply the given 4x3 matrixmat
withthis
.This method assumes the
w
component ofthis
to be0.0
.- Parameters:
mat
- the matrix to multiply this vector by- Returns:
- this
-
mulDirection
Description copied from interface:Vector3dc
Multiply the given 4x4 matrixmat
withthis
and store the result indest
.This method assumes the
w
component ofthis
to be0.0
.- Specified by:
mulDirection
in interfaceVector3dc
- Parameters:
mat
- the matrix to multiply this vector bydest
- will hold the result- Returns:
- dest
-
mulDirection
Description copied from interface:Vector3dc
Multiply the given 4x4 matrixmat
withthis
and store the result indest
.This method assumes the
w
component ofthis
to be0.0
.- Specified by:
mulDirection
in interfaceVector3dc
- Parameters:
mat
- the matrix to multiply this vector bydest
- will hold the result- Returns:
- dest
-
mulDirection
Description copied from interface:Vector3dc
Multiply the given 4x3 matrixmat
withthis
and store the result indest
.This method assumes the
w
component ofthis
to be0.0
.- Specified by:
mulDirection
in interfaceVector3dc
- Parameters:
mat
- the matrix to multiply this vector bydest
- will hold the result- Returns:
- dest
-
mulDirection
Description copied from interface:Vector3dc
Multiply the given 4x3 matrixmat
withthis
and store the result indest
.This method assumes the
w
component ofthis
to be0.0
.- Specified by:
mulDirection
in interfaceVector3dc
- Parameters:
mat
- the matrix to multiply this vector bydest
- will hold the result- Returns:
- dest
-
mulTransposeDirection
Multiply the transpose of the given 4x4 matrixmat
withthis
.This method assumes the
w
component ofthis
to be0.0
.- Parameters:
mat
- the matrix whose transpose to multiply this vector by- Returns:
- this
-
mulTransposeDirection
Description copied from interface:Vector3dc
Multiply the transpose of the given 4x4 matrixmat
withthis
and store the result indest
.This method assumes the
w
component ofthis
to be0.0
.- Specified by:
mulTransposeDirection
in interfaceVector3dc
- Parameters:
mat
- the matrix whose transpose to multiply this vector bydest
- will hold the result- Returns:
- dest
-
mulTransposeDirection
Multiply the transpose of the given 4x4 matrixmat
withthis
.This method assumes the
w
component ofthis
to be0.0
.- Parameters:
mat
- the matrix whose transpose to multiply this vector by- Returns:
- this
-
mulTransposeDirection
Description copied from interface:Vector3dc
Multiply the transpose of the given 4x4 matrixmat
withthis
and store the result indest
.This method assumes the
w
component ofthis
to be0.0
.- Specified by:
mulTransposeDirection
in interfaceVector3dc
- Parameters:
mat
- the matrix whose transpose to multiply this vector bydest
- will hold the result- Returns:
- dest
-
mul
Multiply this Vector3d by the given scalar value.- Parameters:
scalar
- the scalar to multiply this vector by- Returns:
- this
-
mul
Description copied from interface:Vector3dc
Multiply this Vector3d by the given scalar value and store the result indest
. -
mul
Multiply the components of this Vector3d by the given scalar values and store the result inthis
.- Parameters:
x
- the x component to multiply this vector byy
- the y component to multiply this vector byz
- the z component to multiply this vector by- Returns:
- this
-
mul
Description copied from interface:Vector3dc
Multiply the components of this Vector3f by the given scalar values and store the result indest
. -
rotate
Rotate this vector by the given quaternionquat
and store the result inthis
.- Parameters:
quat
- the quaternion to rotate this vector- Returns:
- this
- See Also:
-
rotate
Description copied from interface:Vector3dc
Rotate this vector by the given quaternionquat
and store the result indest
. -
rotationTo
Description copied from interface:Vector3dc
Compute the quaternion representing a rotation ofthis
vector to point alongtoDir
and store the result indest
.Because there can be multiple possible rotations, this method chooses the one with the shortest arc.
- Specified by:
rotationTo
in interfaceVector3dc
- Parameters:
toDir
- the destination directiondest
- will hold the result- Returns:
- dest
- See Also:
-
rotationTo
Description copied from interface:Vector3dc
Compute the quaternion representing a rotation ofthis
vector to point along(toDirX, toDirY, toDirZ)
and store the result indest
.Because there can be multiple possible rotations, this method chooses the one with the shortest arc.
- Specified by:
rotationTo
in interfaceVector3dc
- Parameters:
toDirX
- the x coordinate of the destination directiontoDirY
- the y coordinate of the destination directiontoDirZ
- the z coordinate of the destination directiondest
- will hold the result- Returns:
- dest
- See Also:
-
rotateAxis
Rotate this vector the specified radians around the given rotation axis.- Parameters:
angle
- the angle in radiansx
- the x component of the rotation axisy
- the y component of the rotation axisz
- the z component of the rotation axis- Returns:
- this
-
rotateAxis
Description copied from interface:Vector3dc
Rotate this vector the specified radians around the given rotation axis and store the result intodest
.- Specified by:
rotateAxis
in interfaceVector3dc
- Parameters:
angle
- the angle in radiansaX
- the x component of the rotation axisaY
- the y component of the rotation axisaZ
- the z component of the rotation axisdest
- will hold the result- Returns:
- dest
-
rotateX
Rotate this vector the specified radians around the X axis.- Parameters:
angle
- the angle in radians- Returns:
- this
-
rotateX
Description copied from interface:Vector3dc
Rotate this vector the specified radians around the X axis and store the result intodest
. -
rotateY
Rotate this vector the specified radians around the Y axis.- Parameters:
angle
- the angle in radians- Returns:
- this
-
rotateY
Description copied from interface:Vector3dc
Rotate this vector the specified radians around the Y axis and store the result intodest
. -
rotateZ
Rotate this vector the specified radians around the Z axis.- Parameters:
angle
- the angle in radians- Returns:
- this
-
rotateZ
Description copied from interface:Vector3dc
Rotate this vector the specified radians around the Z axis and store the result intodest
. -
div
Divide this Vector3d by the given scalar value.- Parameters:
scalar
- the scalar to divide this vector by- Returns:
- this
-
div
Description copied from interface:Vector3dc
Divide this Vector3d by the given scalar value and store the result indest
. -
div
Divide the components of this Vector3d by the given scalar values and store the result inthis
.- Parameters:
x
- the x component to divide this vector byy
- the y component to divide this vector byz
- the z component to divide this vector by- Returns:
- this
-
div
Description copied from interface:Vector3dc
Divide the components of this Vector3f by the given scalar values and store the result indest
. -
lengthSquared
public double lengthSquared()Description copied from interface:Vector3dc
Return the length squared of this vector.- Specified by:
lengthSquared
in interfaceVector3dc
- Returns:
- the length squared
-
lengthSquared
public static double lengthSquared(double x, double y, double z) Get the length squared of a 3-dimensional double-precision vector.- Parameters:
x
- The vector's x componenty
- The vector's y componentz
- The vector's z component- Returns:
- the length squared of the given vector
-
length
public double length()Description copied from interface:Vector3dc
Return the length of this vector. -
length
public static double length(double x, double y, double z) Get the length of a 3-dimensional double-precision vector.- Parameters:
x
- The vector's x componenty
- The vector's y componentz
- The vector's z component- Returns:
- the length of the given vector
-
normalize
Normalize this vector.- Returns:
- this
-
normalize
Description copied from interface:Vector3dc
Normalize this vector and store the result indest
. -
normalize
Scale this vector to have the given length.- Parameters:
length
- the desired length- Returns:
- this
-
normalize
Description copied from interface:Vector3dc
Scale this vector to have the given length and store the result indest
. -
cross
Set this vector to be the cross product of this and v2.- Parameters:
v
- the other vector- Returns:
- this
-
cross
Set this vector to be the cross product of itself and(x, y, z)
.- Parameters:
x
- the x component of the other vectory
- the y component of the other vectorz
- the z component of the other vector- Returns:
- this
-
cross
Description copied from interface:Vector3dc
Calculate the cross product of this and v2 and store the result indest
. -
cross
Description copied from interface:Vector3dc
Compute the cross product of this vector and(x, y, z)
and store the result indest
. -
distance
Description copied from interface:Vector3dc
Return the distance between this vector andv
. -
distance
public double distance(double x, double y, double z) Description copied from interface:Vector3dc
Return the distance betweenthis
vector and(x, y, z)
. -
distanceSquared
Description copied from interface:Vector3dc
Return the square of the distance between this vector andv
.- Specified by:
distanceSquared
in interfaceVector3dc
- Parameters:
v
- the other vector- Returns:
- the squared of the distance
-
distanceSquared
public double distanceSquared(double x, double y, double z) Description copied from interface:Vector3dc
Return the square of the distance betweenthis
vector and(x, y, z)
.- Specified by:
distanceSquared
in interfaceVector3dc
- Parameters:
x
- the x component of the other vectory
- the y component of the other vectorz
- the z component of the other vector- Returns:
- the square of the distance
-
distance
public static double distance(double x1, double y1, double z1, double x2, double y2, double z2) Return the distance between(x1, y1, z1)
and(x2, y2, z2)
.- Parameters:
x1
- the x component of the first vectory1
- the y component of the first vectorz1
- the z component of the first vectorx2
- the x component of the second vectory2
- the y component of the second vectorz2
- the z component of the second vector- Returns:
- the euclidean distance
-
distanceSquared
public static double distanceSquared(double x1, double y1, double z1, double x2, double y2, double z2) Return the squared distance between(x1, y1, z1)
and(x2, y2, z2)
.- Parameters:
x1
- the x component of the first vectory1
- the y component of the first vectorz1
- the z component of the first vectorx2
- the x component of the second vectory2
- the y component of the second vectorz2
- the z component of the second vector- Returns:
- the euclidean distance squared
-
dot
Description copied from interface:Vector3dc
Return the dot product of this vector and the supplied vector. -
dot
public double dot(double x, double y, double z) Description copied from interface:Vector3dc
Return the dot product of this vector and the vector(x, y, z)
. -
angleCos
Description copied from interface:Vector3dc
Return the cosine of the angle betweenthis
vector and the supplied vector. Use this instead ofMath.cos(angle(v))
. -
angle
Description copied from interface:Vector3dc
Return the angle between this vector and the supplied vector. -
angleSigned
Description copied from interface:Vector3dc
Return the signed angle between this vector and the supplied vector with respect to the plane with the given normal vectorn
.- Specified by:
angleSigned
in interfaceVector3dc
- Parameters:
v
- the other vectorn
- the plane's normal vector- Returns:
- the angle, in radians
- See Also:
-
angleSigned
public double angleSigned(double x, double y, double z, double nx, double ny, double nz) Description copied from interface:Vector3dc
Return the signed angle between this vector and the supplied vector with respect to the plane with the given normal vector(nx, ny, nz)
.- Specified by:
angleSigned
in interfaceVector3dc
- Parameters:
x
- the x coordinate of the other vectory
- the y coordinate of the other vectorz
- the z coordinate of the other vectornx
- the x coordinate of the plane's normal vectorny
- the y coordinate of the plane's normal vectornz
- the z coordinate of the plane's normal vector- Returns:
- the angle, in radians
-
min
Set the components of this vector to be the component-wise minimum of this and the other vector.- Parameters:
v
- the other vector- Returns:
- this
-
min
Description copied from interface:Vector3dc
Set the components ofdest
to be the component-wise minimum of this and the other vector. -
max
Set the components of this vector to be the component-wise maximum of this and the other vector.- Parameters:
v
- the other vector- Returns:
- this
-
max
Description copied from interface:Vector3dc
Set the components ofdest
to be the component-wise maximum of this and the other vector. -
zero
Set all components to zero.- Returns:
- this
-
toString
Return a string representation of this vector.This method creates a new
DecimalFormat
on every invocation with the format string "0.000E0;-
". -
toString
Return a string representation of this vector by formatting the vector components with the givenNumberFormat
.- Parameters:
formatter
- theNumberFormat
used to format the vector components with- Returns:
- the string representation
-
writeExternal
- Specified by:
writeExternal
in interfaceExternalizable
- Throws:
IOException
-
readExternal
- Specified by:
readExternal
in interfaceExternalizable
- Throws:
IOException
ClassNotFoundException
-
negate
Negate this vector.- Returns:
- this
-
negate
Description copied from interface:Vector3dc
Negate this vector and store the result indest
. -
absolute
Setthis
vector's components to their respective absolute values.- Returns:
- this
-
absolute
Description copied from interface:Vector3dc
Compute the absolute values of the individual components ofthis
and store the result indest
. -
hashCode
public int hashCode() -
equals
-
equals
Description copied from interface:Vector3dc
Compare the vector components ofthis
vector with the given vector using the givendelta
and return whether all of them are equal within a maximum difference ofdelta
.Please note that this method is not used by any data structure such as
ArrayList
HashSet
orHashMap
and their operations, such asArrayList.contains(Object)
orHashSet.remove(Object)
, since those data structures only use theObject.equals(Object)
andObject.hashCode()
methods. -
equals
public boolean equals(double x, double y, double z) Description copied from interface:Vector3dc
Compare the vector components ofthis
vector with the given(x, y, z)
and return whether all of them are equal. -
reflect
Reflect this vector about the given normal vector.- Parameters:
normal
- the vector to reflect about- Returns:
- this
-
reflect
Reflect this vector about the given normal vector.- Parameters:
x
- the x component of the normaly
- the y component of the normalz
- the z component of the normal- Returns:
- this
-
reflect
Description copied from interface:Vector3dc
Reflect this vector about the given normal vector and store the result indest
. -
reflect
Description copied from interface:Vector3dc
Reflect this vector about the given normal vector and store the result indest
. -
half
Compute the half vector between this and the other vector.- Parameters:
other
- the other vector- Returns:
- this
-
half
Compute the half vector between this and the vector(x, y, z)
.- Parameters:
x
- the x component of the other vectory
- the y component of the other vectorz
- the z component of the other vector- Returns:
- this
-
half
Description copied from interface:Vector3dc
Compute the half vector between this and the other vector and store the result indest
. -
half
Description copied from interface:Vector3dc
Compute the half vector between this and the vector(x, y, z)
and store the result indest
. -
smoothStep
Description copied from interface:Vector3dc
Compute a smooth-step (i.e. hermite with zero tangents) interpolation betweenthis
vector and the given vectorv
and store the result indest
.- Specified by:
smoothStep
in interfaceVector3dc
- Parameters:
v
- the other vectort
- the interpolation factor, within[0..1]
dest
- will hold the result- Returns:
- dest
-
hermite
Description copied from interface:Vector3dc
Compute a hermite interpolation betweenthis
vector and its associated tangentt0
and the given vectorv
with its tangentt1
and store the result indest
. -
lerp
Linearly interpolatethis
andother
using the given interpolation factort
and store the result inthis
.If
t
is0.0
then the result isthis
. If the interpolation factor is1.0
then the result isother
.- Parameters:
other
- the other vectort
- the interpolation factor between 0.0 and 1.0- Returns:
- this
-
lerp
Description copied from interface:Vector3dc
Linearly interpolatethis
andother
using the given interpolation factort
and store the result indest
.If
t
is0.0
then the result isthis
. If the interpolation factor is1.0
then the result isother
. -
get
Description copied from interface:Vector3dc
Get the value of the specified component of this vector.- Specified by:
get
in interfaceVector3dc
- Parameters:
component
- the component, within[0..2]
- Returns:
- the value
- Throws:
IllegalArgumentException
- ifcomponent
is not within[0..2]
-
get
Description copied from interface:Vector3dc
- Specified by:
get
in interfaceVector3dc
- Parameters:
mode
- theRoundingMode
to usedest
- will hold the result- Returns:
- dest
-
get
Description copied from interface:Vector3dc
Set the components of the given vectordest
to those ofthis
vector. -
get
Description copied from interface:Vector3dc
Set the components of the given vectordest
to those ofthis
vector. -
maxComponent
public int maxComponent()Description copied from interface:Vector3dc
Determine the component with the biggest absolute value.- Specified by:
maxComponent
in interfaceVector3dc
- Returns:
- the component index, within
[0..2]
-
minComponent
public int minComponent()Description copied from interface:Vector3dc
Determine the component with the smallest (towards zero) absolute value.- Specified by:
minComponent
in interfaceVector3dc
- Returns:
- the component index, within
[0..2]
-
orthogonalize
Description copied from interface:Vector3dc
Transformthis
vector so that it is orthogonal to the given vectorv
, normalize the result and store it intodest
.Reference: Gram–Schmidt process
- Specified by:
orthogonalize
in interfaceVector3dc
- Parameters:
v
- the reference vector which the result should be orthogonal todest
- will hold the result- Returns:
- dest
-
orthogonalize
Transformthis
vector so that it is orthogonal to the given vectorv
and normalize the result.Reference: Gram–Schmidt process
- Parameters:
v
- the reference vector which the result should be orthogonal to- Returns:
- this
-
orthogonalizeUnit
Description copied from interface:Vector3dc
Transformthis
vector so that it is orthogonal to the given unit vectorv
, normalize the result and store it intodest
.The vector
v
is assumed to be aunit
vector.Reference: Gram–Schmidt process
- Specified by:
orthogonalizeUnit
in interfaceVector3dc
- Parameters:
v
- the reference unit vector which the result should be orthogonal todest
- will hold the result- Returns:
- dest
-
orthogonalizeUnit
Transformthis
vector so that it is orthogonal to the given unit vectorv
and normalize the result.The vector
v
is assumed to be aunit
vector.Reference: Gram–Schmidt process
- Parameters:
v
- the reference unit vector which the result should be orthogonal to- Returns:
- this
-
floor
Set each component of this vector to the largest (closest to positive infinity)double
value that is less than or equal to that component and is equal to a mathematical integer.- Returns:
- this
-
floor
Description copied from interface:Vector3dc
Compute for each component of this vector the largest (closest to positive infinity)double
value that is less than or equal to that component and is equal to a mathematical integer and store the result indest
. -
ceil
Set each component of this vector to the smallest (closest to negative infinity)double
value that is greater than or equal to that component and is equal to a mathematical integer.- Returns:
- this
-
ceil
Description copied from interface:Vector3dc
Compute for each component of this vector the smallest (closest to negative infinity)double
value that is greater than or equal to that component and is equal to a mathematical integer and store the result indest
. -
round
Set each component of this vector to the closest double that is equal to a mathematical integer, with ties rounding to positive infinity.- Returns:
- this
-
round
Description copied from interface:Vector3dc
Compute for each component of this vector the closest double that is equal to a mathematical integer, with ties rounding to positive infinity and store the result indest
. -
isFinite
public boolean isFinite()Description copied from interface:Vector3dc
-
clone
- Overrides:
clone
in classObject
- Throws:
CloneNotSupportedException
-