Interface Vector4dc
- All Known Implementing Classes:
Vector4d
- Author:
- Kai Burjack
-
Method Summary
Modifier and TypeMethodDescriptionCompute the absolute of each of this vector's components and store the result intodest
.Add(x, y, z, w)
to this and store the result indest
.Add the supplied vector to this one and store the result indest
.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 between this vector and the supplied vector.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
.double
distance
(double x, double y, double z, double w) Return the distance betweenthis
vector and(x, y, z, w)
.double
Return the distance between this Vector andv
.double
distanceSquared
(double x, double y, double z, double w) Return the square of the distance betweenthis
vector and(x, y, z, w)
.double
Return the square of the distance between this vector andv
.Divide this Vector4d by the given scalar value and store the result indest
.double
dot
(double x, double y, double z, double w) Compute the dot product (inner product) of this vector and(x, y, z, w)
.double
Compute the dot product (inner product) of this vector andv
.boolean
equals
(double x, double y, double z, double w) Compare the vector components ofthis
vector with the given(x, y, z, w)
and return whether all of them are equal.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
.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 and store the result indest
.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.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.double
Return the length squared of this vector.Linearly interpolatethis
andother
using the given interpolation factort
and store the result indest
.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 ofdest
to be the component-wise minimum of this and the other vector.int
Determine the component with the smallest (towards zero) absolute value.Multiply this Vector4d by the given scalar value and store the result indest
.Multiply the given matrix mat with thisVector4d
and store the result indest
.Multiply the given matrix mat with this Vector4d and store the result indest
.mul
(Matrix4x3dc mat, Vector4d dest) Multiply the given matrix mat with this Vector4d and store the result indest
.mul
(Matrix4x3fc mat, Vector4d dest) Multiply the given matrix mat with this Vector4d and store the result indest
.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
.Multiply the given affine matrix mat with this Vector4d and store the result indest
.mulAffineTranspose
(Matrix4dc mat, Vector4d dest) Multiply the transpose of the given affine matrixmat
with this Vector4d and store the result indest
.mulProject
(Matrix4dc mat, Vector3d dest) Multiply the given matrixmat
with this Vector4d, perform perspective division and store the(x, y, z)
result indest
.mulProject
(Matrix4dc mat, Vector4d dest) Multiply the given matrixmat
with this Vector4d, perform perspective division and store the result indest
.mulTranspose
(Matrix4dc mat, Vector4d dest) Multiply the transpose of the given matrixmat
with this Vector4d and store the result indest
.Negate this vector and store the result indest
.Scale this vector to have the given length and store the result indest
.Normalizes this vector and store the result indest
.normalize3
(Vector4d dest) Normalize this vector by computing only the norm of(x, y, z)
and store the result indest
.rotate
(Quaterniondc quat, Vector4d dest) Transform this vector by the given quaternionquat
and store the result indest
.rotateAxis
(double angle, double aX, double aY, double aZ, Vector4d dest) Rotate this vector the specified radians around the given rotation axis and store the result intodest
.Rotate this vector the specified radians around the X axis and store the result intodest
.Rotate this vector the specified radians around the Y axis and store the result intodest
.Rotate this vector the specified radians around the Z axis and store the result intodest
.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
.smoothStep
(Vector4dc v, double t, Vector4d dest) Compute a smooth-step (i.e.Subtract(x, y, z, w)
from this and store the result indest
.Subtract the supplied vector from this one and store the result indest
.Subtract the supplied vector from this one and store the result indest
.double
w()
double
x()
double
y()
double
z()
-
Method Details
-
x
double x()- Returns:
- the value of the x component
-
y
double y()- Returns:
- the value of the y component
-
z
double z()- Returns:
- the value of the z component
-
w
double w()- Returns:
- the value of the w component
-
get
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
get(int, ByteBuffer)
, taking the absolute position as parameter.- Parameters:
buffer
- will receive the values of this vector inx, y, z, w
order- Returns:
- the passed in buffer
- See Also:
-
get
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.
- Parameters:
index
- the absolute position into the ByteBufferbuffer
- will receive the values of this vector inx, y, z, w
order- Returns:
- the passed in buffer
-
get
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
get(int, DoubleBuffer)
, taking the absolute position as parameter.- Parameters:
buffer
- will receive the values of this vector inx, y, z, w
order- Returns:
- the passed in buffer
- See Also:
-
get
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.
- Parameters:
index
- the absolute position into the DoubleBufferbuffer
- will receive the values of this vector inx, y, z, w
order- Returns:
- the passed in buffer
-
get
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
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.
- Parameters:
buffer
- will receive the values of this vector inx, y, z, w
order- Returns:
- the passed in buffer
- See Also:
-
get
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.
- Parameters:
index
- the absolute position into the FloatBufferbuffer
- will receive the values of this vector inx, y, z, w
order- Returns:
- the passed in buffer
-
getf
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
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.
- Parameters:
buffer
- will receive the values of this vector inx, y, z, w
order- Returns:
- the passed in buffer
- See Also:
-
getf
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.
- Parameters:
index
- the absolute position into the ByteBufferbuffer
- will receive the values of this vector inx, y, z, w
order- Returns:
- the passed in buffer
-
getToAddress
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.
- Parameters:
address
- the off-heap address where to store this vector- Returns:
- this
-
sub
Subtract the supplied vector from this one and store the result indest
.- Parameters:
v
- the vector to subtractdest
- will hold the result- Returns:
- dest
-
sub
Subtract the supplied vector from this one and store the result indest
.- Parameters:
v
- the vector to subtractdest
- will hold the result- Returns:
- dest
-
sub
Subtract(x, y, z, w)
from this and store the result indest
.- Parameters:
x
- the x component to subtracty
- the y component to subtractz
- the z component to subtractw
- the w component to subtractdest
- will hold the result- Returns:
- dest
-
add
Add the supplied vector to this one and store the result indest
.- Parameters:
v
- the vector to adddest
- will hold the result- Returns:
- dest
-
add
Add the supplied vector to this one and store the result indest
.- Parameters:
v
- the vector to adddest
- will hold the result- Returns:
- dest
-
add
Add(x, y, z, w)
to this and store the result indest
.- Parameters:
x
- the x component to subtracty
- the y component to subtractz
- the z component to subtractw
- the w component to subtractdest
- will hold the result- Returns:
- dest
-
fma
Add the component-wise multiplication ofa * b
to this vector and store the result indest
.- Parameters:
a
- the first multiplicandb
- the second multiplicanddest
- will hold the result- Returns:
- dest
-
fma
Add the component-wise multiplication ofa * b
to this vector and store the result indest
.- Parameters:
a
- the first multiplicandb
- the second multiplicanddest
- will hold the result- Returns:
- dest
-
mul
- Parameters:
v
- the vector to multiply this bydest
- will hold the result- Returns:
- dest
-
mul
- Parameters:
v
- the vector to multiply this bydest
- will hold the result- Returns:
- dest
-
div
- Parameters:
v
- the vector to divide this bydest
- will hold the result- Returns:
- dest
-
mul
Multiply the given matrix mat with thisVector4d
and store the result indest
.- Parameters:
mat
- the matrix to multiplythis
bydest
- will hold the result- Returns:
- dest
-
mul
Multiply the given matrix mat with this Vector4d and store the result indest
.- Parameters:
mat
- the matrix to multiply the vector withdest
- the destination vector to hold the result- Returns:
- dest
-
mul
Multiply the given matrix mat with this Vector4d and store the result indest
.- Parameters:
mat
- the matrix to multiply the vector withdest
- the destination vector to hold the result- Returns:
- dest
-
mul
Multiply the given matrix mat with this Vector4d and store the result indest
.- Parameters:
mat
- the matrix to multiplythis
bydest
- will hold the result- Returns:
- dest
-
mulTranspose
Multiply the transpose of the given matrixmat
with this Vector4d and store the result indest
.- Parameters:
mat
- the matrix whose transpose to multiply the vector withdest
- the destination vector to hold the result- Returns:
- dest
-
mulAffine
Multiply the given affine matrix mat with this Vector4d and store the result indest
.- Parameters:
mat
- the affine matrix to multiply the vector withdest
- the destination vector to hold the result- Returns:
- dest
-
mulAffineTranspose
Multiply the transpose of the given affine matrixmat
with this Vector4d and store the result indest
.- Parameters:
mat
- the affine matrix whose transpose to multiply the vector withdest
- the destination vector to hold the result- Returns:
- dest
-
mulProject
Multiply the given matrixmat
with this Vector4d, perform perspective division and store the result indest
.- Parameters:
mat
- the matrix to multiply this vector bydest
- will hold the result- Returns:
- dest
-
mulProject
Multiply the given matrixmat
with this Vector4d, perform perspective division and store the(x, y, z)
result indest
.- Parameters:
mat
- the matrix to multiply this vector bydest
- will hold the result- Returns:
- dest
-
mulAdd
Add the component-wise multiplication ofthis * a
tob
and store the result indest
.- Parameters:
a
- the multiplicandb
- the addenddest
- will hold the result- Returns:
- dest
-
mulAdd
Add the component-wise multiplication ofthis * a
tob
and store the result indest
.- Parameters:
a
- the multiplicandb
- the addenddest
- will hold the result- Returns:
- dest
-
mul
Multiply this Vector4d by the given scalar value and store the result indest
.- Parameters:
scalar
- the factor to multiply bydest
- will hold the result- Returns:
- dest
-
div
Divide this Vector4d by the given scalar value and store the result indest
.- Parameters:
scalar
- the factor to divide bydest
- will hold the result- Returns:
- dest
-
rotate
Transform this vector by the given quaternionquat
and store the result indest
.- Parameters:
quat
- the quaternion to transform this vectordest
- will hold the result- Returns:
- dest
- See Also:
-
rotateAxis
Rotate this vector the specified radians around the given rotation axis and store the result intodest
.- 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 and store the result intodest
.- Parameters:
angle
- the angle in radiansdest
- will hold the result- Returns:
- dest
-
rotateY
Rotate this vector the specified radians around the Y axis and store the result intodest
.- Parameters:
angle
- the angle in radiansdest
- will hold the result- Returns:
- dest
-
rotateZ
Rotate this vector the specified radians around the Z axis and store the result intodest
.- Parameters:
angle
- the angle in radiansdest
- will hold the result- Returns:
- dest
-
lengthSquared
double lengthSquared()Return the length squared of this vector.- Returns:
- the length squared
-
length
double length()Return the length of this vector.- Returns:
- the length
-
normalize
Normalizes this vector and store the result indest
.- Parameters:
dest
- will hold the result- Returns:
- dest
-
normalize
Scale this vector to have the given length and store the result indest
.- Parameters:
length
- the desired lengthdest
- will hold the result- Returns:
- dest
-
normalize3
Normalize this vector by computing only the norm of(x, y, z)
and store the result indest
.- Parameters:
dest
- will hold the result- Returns:
- dest
-
distance
Return the distance between this Vector andv
.- Parameters:
v
- the other vector- Returns:
- the distance
-
distance
double distance(double x, double y, double z, double w) Return the distance betweenthis
vector and(x, y, z, w)
.- Parameters:
x
- the x component of the other vectory
- the y component of the other vectorz
- the z component of the other vectorw
- the w component of the other vector- Returns:
- the euclidean distance
-
distanceSquared
Return the square of the distance between this vector andv
.- Parameters:
v
- the other vector- Returns:
- the squared of the distance
-
distanceSquared
double distanceSquared(double x, double y, double z, double w) Return the square of the distance betweenthis
vector and(x, y, z, w)
.- Parameters:
x
- the x component of the other vectory
- the y component of the other vectorz
- the z component of the other vectorw
- the w component of the other vector- Returns:
- the square of the distance
-
dot
Compute the dot product (inner product) of this vector andv
.- Parameters:
v
- the other vector- Returns:
- the dot product
-
dot
double dot(double x, double y, double z, double w) Compute the dot product (inner product) of this vector and(x, y, z, w)
.- Parameters:
x
- the x component of the other vectory
- the y component of the other vectorz
- the z component of the other vectorw
- the w component of the other vector- Returns:
- the dot product
-
angleCos
Return the cosine of the angle between this vector and the supplied vector.Use this instead of
Math.cos(angle(v))
.- Parameters:
v
- the other vector- Returns:
- the cosine of the angle
- See Also:
-
angle
Return the angle between this vector and the supplied vector.- Parameters:
v
- the other vector- Returns:
- the angle, in radians
- See Also:
-
negate
Negate this vector and store the result indest
.- Parameters:
dest
- will hold the result- Returns:
- dest
-
min
Set the components ofdest
to be the component-wise minimum of this and the other vector.- Parameters:
v
- the other vectordest
- will hold the result- Returns:
- dest
-
max
Set the components ofdest
to be the component-wise maximum of this and the other vector.- Parameters:
v
- the other vectordest
- will hold the result- Returns:
- dest
-
smoothStep
Compute a smooth-step (i.e. hermite with zero tangents) interpolation betweenthis
vector and the given vectorv
and store the result indest
.- Parameters:
v
- the other vectort
- the interpolation factor, within[0..1]
dest
- will hold the result- Returns:
- dest
-
hermite
Compute a hermite interpolation betweenthis
vector and its associated tangentt0
and the given vectorv
with its tangentt1
and store the result indest
.- Parameters:
t0
- the tangent ofthis
vectorv1
- the other vectort1
- the tangent of the other vectort
- the interpolation factor, within[0..1]
dest
- will hold the result- Returns:
- dest
-
lerp
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
.- Parameters:
other
- the other vectort
- the interpolation factor between 0.0 and 1.0dest
- will hold the result- Returns:
- dest
-
get
Get the value of the specified component of this vector.- Parameters:
component
- the component, within[0..3]
- Returns:
- the value
- Throws:
IllegalArgumentException
- ifcomponent
is not within[0..3]
-
get
- Parameters:
mode
- theRoundingMode
to usedest
- will hold the result- Returns:
- dest
-
get
Set the components of the given vectordest
to those ofthis
vector.- Parameters:
dest
- will hold the result- Returns:
- dest
-
get
Set the components of the given vectordest
to those ofthis
vector.- Parameters:
dest
- will hold the result- Returns:
- dest
-
maxComponent
int maxComponent()Determine the component with the biggest absolute value.- Returns:
- the component index, within
[0..3]
-
minComponent
int minComponent()Determine the component with the smallest (towards zero) absolute value.- Returns:
- the component index, within
[0..3]
-
floor
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
.- Parameters:
dest
- will hold the result- Returns:
- dest
-
ceil
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
.- Parameters:
dest
- will hold the result- Returns:
- dest
-
round
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
.- Parameters:
dest
- will hold the result- Returns:
- dest
-
isFinite
boolean isFinite()Determine whether all components are finite floating-point values, that is, they are notNaN
and notinfinity
.- Returns:
true
if all components are finite floating-point values;false
otherwise
-
absolute
Compute the absolute of each of this vector's components and store the result intodest
.- Parameters:
dest
- will hold the result- Returns:
- dest
-
equals
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.- Parameters:
v
- the other vectordelta
- the allowed maximum difference- Returns:
true
whether all of the vector components are equal;false
otherwise
-
equals
boolean equals(double x, double y, double z, double w) Compare the vector components ofthis
vector with the given(x, y, z, w)
and return whether all of them are equal.- Parameters:
x
- the x component to compare toy
- the y component to compare toz
- the z component to compare tow
- the w component to compare to- Returns:
true
if all the vector components are equal
-