Class Vector4f
- All Implemented Interfaces:
Externalizable
,Serializable
,Cloneable
,Vector4fc
- Author:
- Richard Greenlees, Kai Burjack, F. Neurath
- See Also:
-
Field Summary
-
Constructor Summary
ConstructorDescriptionVector4f()
Create a newVector4f
of(0, 0, 0, 1)
.Vector4f
(float d) Create a newVector4f
and initialize all four components with the given value.Vector4f
(float[] xyzw) Create a newVector4f
and initialize its four components from the first four elements of the given array.Vector4f
(float x, float y, float z, float w) Create a newVector4f
with the given component values.Vector4f
(int index, ByteBuffer buffer) Create a newVector4f
and read this vector from the suppliedByteBuffer
starting at the specified absolute buffer position/index.Vector4f
(int index, FloatBuffer buffer) Create a newVector4f
and read this vector from the suppliedFloatBuffer
starting at the specified absolute buffer position/index.Vector4f
(ByteBuffer buffer) Create a newVector4f
and read this vector from the suppliedByteBuffer
at the current bufferposition
.Vector4f
(FloatBuffer buffer) Create a newVector4f
and read this vector from the suppliedFloatBuffer
at the current bufferposition
.Create a newVector4f
with the same values asv
.Create a newVector4f
with the same values asv
. -
Method Summary
Modifier and TypeMethodDescriptionabsolute()
Compute the absolute of each of this vector's components.Compute the absolute of each of this vector's components and store the result intodest
.add
(float x, float y, float z, float w) 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
.float
Return the angle between this vector and the supplied vector.float
Return the cosine of the angle between this vector and the supplied vector.ceil()
Set each component of this vector to the smallest (closest to negative infinity)float
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)float
value that is greater than or equal to that component and is equal to a mathematical integer and store the result indest
.clone()
float
distance
(float x, float y, float z, float w) Return the distance betweenthis
vector and(x, y, z, w)
.static float
distance
(float x1, float y1, float z1, float w1, float x2, float y2, float z2, float w2) Return the distance between(x1, y1, z1, w1)
and(x2, y2, z2, w2)
.float
Return the distance between this Vector andv
.float
distanceSquared
(float x, float y, float z, float w) Return the square of the distance betweenthis
vector and(x, y, z, w)
.static float
distanceSquared
(float x1, float y1, float z1, float w1, float x2, float y2, float z2, float w2) Return the squared distance between(x1, y1, z1, w1)
and(x2, y2, z2, w2)
.float
Return the square of the distance between this vector andv
.div
(float scalar) Divide all components of thisVector4f
by the given scalar value.div
(float x, float y, float z, float w) Divide the components of this Vector4f by the given scalar values and store the result inthis
.Divide the components of this Vector4f by the given scalar values and store the result indest
.Divide all components of thisVector4f
by the given scalar value and store the result indest
.Divide this Vector4f component-wise by another Vector4f.Divide this Vector4f component-wise by another Vector4f and store the result indest
.float
dot
(float x, float y, float z, float w) Compute the dot product (inner product) of this vector and(x, y, z, w)
.float
Compute the dot product (inner product) of this vector andv
.boolean
equals
(float x, float y, float z, float w) Compare the vector components ofthis
vector with the given(x, y, z, w)
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)float
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)float
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
.float
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, 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
(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.getToAddress
(long address) Store this vector at the given off-heap memory address.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()
float
length()
Return the length of this vector.static float
length
(float x, float y, float z, float w) Get the length of a 4-dimensional single-precision vector.float
Return the length squared of this vector.static float
lengthSquared
(float x, float y, float z, float w) Get the length squared of a 4-dimensional single-precision vector.static float
lengthSquared
(int x, int y, int z, int w) Get the length squared of a 4-dimensional int 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
(float scalar) Multiply all components of thisVector4f
by the given scalar value.mul
(float x, float y, float z, float w) Multiply the components of this Vector4f by the given scalar values and store the result inthis
.Multiply the components of this Vector4f by the given scalar values and store the result indest
.Multiply all components of thisVector4f
by the given scalar value and store the result indest
.Multiply the given matrix mat with this Vector4f and store the result inthis
.Multiply the given matrix mat with this Vector4f and store the result indest
.mul
(Matrix4x3fc mat) Multiply the given matrix mat with this Vector4f and store the result inthis
.mul
(Matrix4x3fc mat, Vector4f dest) Multiply the given matrix mat with this Vector4f and store the result indest
.Multiply this Vector4f component-wise by another Vector4f.Multiply this Vector4f component-wise by another Vector4f 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
.Multiply the given affine matrix mat with this Vector4f and store the result indest
.mulAffineTranspose
(Matrix4fc mat, Vector4f dest) Multiply the transpose of the given affine matrixmat
with this Vector4f and store the result indest
.mulProject
(Matrix4fc mat) Multiply the given matrixmat
with this Vector4f, perform perspective division.mulProject
(Matrix4fc mat, Vector3f dest) Multiply the given matrixmat
with this Vector4f, perform perspective division and store the(x, y, z)
result indest
.mulProject
(Matrix4fc mat, Vector4f dest) Multiply the given matrixmat
with this Vector4f, perform perspective division and store the result indest
.mulTranspose
(Matrix4fc mat) Multiply the transpose of the given matrixmat
with this Vector4f and store the result inthis
.mulTranspose
(Matrix4fc mat, Vector4f dest) Multiply the transpose of the given matrixmat
with this Vector4f and store the result indest
.negate()
Negate this vector.Negate this vector and store the result indest
.Normalizes this vector.normalize
(float length) Scale this vector to have the given length.Scale this vector to have the given length and store the result indest
.Normalizes this vector and store the result indest
.Normalize this vector by computing only the norm of(x, y, z)
.normalize3
(Vector4f dest) Normalize this vector by computing only the norm of(x, y, z)
and store the result indest
.void
rotate
(Quaternionfc quat) Rotate this vector by the given quaternionquat
and store the result inthis
.rotate
(Quaternionfc quat, Vector4f dest) Rotate this vector by the given quaternionquat
and store the result indest
.rotateAbout
(float angle, float x, float y, float z) Rotate this vector the specified radians around the given rotation axis.rotateAxis
(float angle, float aX, float aY, float aZ, Vector4f dest) Rotate this vector the specified radians around the given rotation axis and store the result intodest
.rotateX
(float 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
(float 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
(float 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
.round()
Set each component of this vector to the closest float that is equal to a mathematical integer, with ties rounding to positive infinity.Compute for each component of this vector the closest float 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, z, and w components to the supplied value.set
(double x, double y, double z, double w) Set the x, y, z, and w components to the supplied values.set
(float d) Set the x, y, z, and w components to the supplied value.set
(float[] xyzw) Set the four components of this vector to the first four elements of the given array.set
(float x, float y, float z) Set the x, y, z components to the supplied values.set
(float x, float y, float z, float w) Set the x, y, z, and w components to the supplied values.set
(int index, ByteBuffer buffer) Read this vector from the suppliedByteBuffer
starting at the specified absolute buffer position/index.set
(int index, FloatBuffer buffer) Read this vector from the suppliedFloatBuffer
starting at the specified absolute buffer position/index.set
(ByteBuffer buffer) Read this vector from the suppliedByteBuffer
at the current bufferposition
.set
(FloatBuffer buffer) Read this vector from the suppliedFloatBuffer
at the current bufferposition
.Sets the first two components of this to the components of givenv
and last two components to the givenz
, andw
.Sets the first two components of this to the components of givenv
and last two components to the givenz
, andw
.Set the first three components of this to the components ofv
and the last component tow
.Set the first three components of this to the components ofv
and the last component tow
.Set thisVector4f
to the values of the givenv
.Set thisVector4f
to the values of the givenv
.Set thisVector4f
to the values of the givenv
.setComponent
(int component, float value) Set the value of the specified component of this vector.setFromAddress
(long address) Set the values of this vector by reading 4 float values from off-heap memory, starting at the given address.smoothStep
(Vector4fc v, float t, Vector4f dest) Compute a smooth-step (i.e.sub
(float x, float y, float z, float w) Subtract(x, y, z, w)
from this.Subtract(x, y, z, w)
from this 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
.float
w()
void
float
x()
float
y()
float
z()
zero()
Set all components to zero.
-
Field Details
-
x
public float xThe x component of the vector. -
y
public float yThe y component of the vector. -
z
public float zThe z component of the vector. -
w
public float wThe w component of the vector.
-
-
Constructor Details
-
Vector4f
public Vector4f()Create a newVector4f
of(0, 0, 0, 1)
. -
Vector4f
Create a newVector4f
with the same values asv
.- Parameters:
v
- theVector4fc
to copy the values from
-
Vector4f
Create a newVector4f
with the same values asv
.- Parameters:
v
- theVector4ic
to copy the values from
-
Vector4f
- Parameters:
v
- theVector3fc
w
- the w component
-
Vector4f
- Parameters:
v
- theVector3ic
w
- the w component
-
Vector4f
- Parameters:
v
- theVector2fc
z
- the z componentw
- the w component
-
Vector4f
- Parameters:
v
- theVector2ic
z
- the z componentw
- the w component
-
Vector4f
public Vector4f(float d) Create a newVector4f
and initialize all four components with the given value.- Parameters:
d
- the value of all four components
-
Vector4f
public Vector4f(float x, float y, float z, float w) Create a newVector4f
with the given component values.- Parameters:
x
- the x componenty
- the y componentz
- the z componentw
- the w component
-
Vector4f
public Vector4f(float[] xyzw) Create a newVector4f
and initialize its four components from the first four elements of the given array.- Parameters:
xyzw
- the array containing at least four elements
-
Vector4f
Create a newVector4f
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
Vector4f(int, ByteBuffer)
, taking the absolute position as parameter.- Parameters:
buffer
- values will be read inx, y, z, w
order- See Also:
-
Vector4f
Create a newVector4f
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, w
order
-
Vector4f
Create a newVector4f
and read this vector from 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 read, use
Vector4f(int, FloatBuffer)
, taking the absolute position as parameter.- Parameters:
buffer
- values will be read inx, y, z, w
order- See Also:
-
Vector4f
Create a newVector4f
and read this vector from the suppliedFloatBuffer
starting at the specified absolute buffer position/index.This method will not increment the position of the given FloatBuffer.
- Parameters:
index
- the absolute position into the FloatBufferbuffer
- values will be read inx, y, z, w
order
-
-
Method Details
-
x
public float x() -
y
public float y() -
z
public float z() -
w
public float w() -
set
Set thisVector4f
to the values of the givenv
.- Parameters:
v
- the vector whose values will be copied into this- Returns:
- this
-
set
Set thisVector4f
to the values of the givenv
.- Parameters:
v
- the vector whose values will be copied into this- Returns:
- this
-
set
Set thisVector4f
to the values of the givenv
.Note that due to the given vector
v
storing the components in double-precision, there is the possibility to lose precision.- Parameters:
v
- the vector whose values will be copied into this- Returns:
- this
-
set
Set the first three components of this to the components ofv
and the last component tow
.- Parameters:
v
- theVector3fc
to copyw
- the w component- Returns:
- this
-
set
Set the first three components of this to the components ofv
and the last component tow
.- Parameters:
v
- theVector3ic
to copyw
- the w component- Returns:
- this
-
set
Sets the first two components of this to the components of givenv
and last two components to the givenz
, andw
.- Parameters:
v
- theVector2fc
z
- the z componentw
- the w component- Returns:
- this
-
set
Sets the first two components of this to the components of givenv
and last two components to the givenz
, andw
.- Parameters:
v
- theVector2ic
z
- the z componentw
- the w component- Returns:
- this
-
set
Set the x, y, z, and w components to the supplied value.- Parameters:
d
- the value of all four components- Returns:
- this
-
set
Set the x, y, z, and w components to the supplied values.- Parameters:
x
- the x componenty
- the y componentz
- the z componentw
- the w component- Returns:
- this
-
set
Set the x, y, z components to the supplied values.- Parameters:
x
- the x componenty
- the y componentz
- the z component- Returns:
- this
-
set
Set the x, y, z, and w components to the supplied value.- Parameters:
d
- the value of all four components- Returns:
- this
-
set
Set the x, y, z, and w components to the supplied values.- Parameters:
x
- the x componenty
- the y componentz
- the z componentw
- the w component- Returns:
- this
-
set
Set the four components of this vector to the first four elements of the given array.- Parameters:
xyzw
- the array containing at least four 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, w
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, w
order- Returns:
- this
-
set
Read this vector from 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 read, use
set(int, FloatBuffer)
, taking the absolute position as parameter.- Parameters:
buffer
- values will be read inx, y, z, w
order- Returns:
- this
- See Also:
-
set
Read this vector from the suppliedFloatBuffer
starting at the specified absolute buffer position/index.This method will not increment the position of the given FloatBuffer.
- Parameters:
index
- the absolute position into the FloatBufferbuffer
- values will be read inx, y, z, w
order- Returns:
- this
-
setFromAddress
Set the values of this vector by reading 4 float 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..3]
value
- the value to set- Returns:
- this
- Throws:
IllegalArgumentException
- ifcomponent
is not within[0..3]
-
get
Description copied from interface:Vector4fc
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
Vector4fc.get(int, FloatBuffer)
, taking the absolute position as parameter. -
get
Description copied from interface:Vector4fc
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.
-
get
Description copied from interface:Vector4fc
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
Vector4fc.get(int, ByteBuffer)
, taking the absolute position as parameter. -
get
Description copied from interface:Vector4fc
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.
-
getToAddress
Description copied from interface:Vector4fc
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 interfaceVector4fc
- 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- Returns:
- this
-
sub
Subtract(x, y, z, w)
from this.- Parameters:
x
- the x component to subtracty
- the y component to subtractz
- the z component to subtractw
- the w component to subtract- Returns:
- this
-
sub
Description copied from interface:Vector4fc
Subtract the supplied vector from this one and store the result indest
. -
sub
Description copied from interface:Vector4fc
Subtract(x, y, z, w)
from this 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:Vector4fc
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 addw
- the w component to add- Returns:
- this
-
add
Description copied from interface:Vector4fc
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
Description copied from interface:Vector4fc
Add the component-wise multiplication ofa * b
to this vector and store the result indest
. -
fma
Description copied from interface:Vector4fc
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:Vector4fc
Add the component-wise multiplication ofthis * a
tob
and store the result indest
. -
mulAdd
Description copied from interface:Vector4fc
Add the component-wise multiplication ofthis * a
tob
and store the result indest
. -
mul
Multiply this Vector4f component-wise by another Vector4f.- Parameters:
v
- the other vector- Returns:
- this
-
mul
Description copied from interface:Vector4fc
Multiply this Vector4f component-wise by another Vector4f and store the result indest
. -
div
Divide this Vector4f component-wise by another Vector4f.- Parameters:
v
- the vector to divide by- Returns:
- this
-
div
Description copied from interface:Vector4fc
Divide this Vector4f component-wise by another Vector4f and store the result indest
. -
mul
Multiply the given matrix mat with this Vector4f and store the result inthis
.- Parameters:
mat
- the matrix to multiply the vector with- Returns:
- this
-
mul
Description copied from interface:Vector4fc
Multiply the given matrix mat with this Vector4f and store the result indest
. -
mulTranspose
Multiply the transpose of the given matrixmat
with this Vector4f and store the result inthis
.- Parameters:
mat
- the matrix whose transpose to multiply the vector with- Returns:
- this
-
mulTranspose
Description copied from interface:Vector4fc
Multiply the transpose of the given matrixmat
with this Vector4f and store the result indest
.- Specified by:
mulTranspose
in interfaceVector4fc
- Parameters:
mat
- the matrix whose transpose to multiply the vector withdest
- the destination vector to hold the result- Returns:
- dest
-
mulAffine
Description copied from interface:Vector4fc
Multiply the given affine matrix mat with this Vector4f and store the result indest
. -
mulAffineTranspose
Description copied from interface:Vector4fc
Multiply the transpose of the given affine matrixmat
with this Vector4f and store the result indest
.- Specified by:
mulAffineTranspose
in interfaceVector4fc
- Parameters:
mat
- the affine matrix whose transpose to multiply the vector withdest
- the destination vector to hold the result- Returns:
- dest
-
mul
Multiply the given matrix mat with this Vector4f and store the result inthis
.- Parameters:
mat
- the matrix to multiply the vector with- Returns:
- this
-
mul
Description copied from interface:Vector4fc
Multiply the given matrix mat with this Vector4f and store the result indest
. -
mulProject
Description copied from interface:Vector4fc
Multiply the given matrixmat
with this Vector4f, perform perspective division and store the result indest
.- Specified by:
mulProject
in interfaceVector4fc
- Parameters:
mat
- the matrix to multiply this vector bydest
- will hold the result- Returns:
- dest
-
mulProject
Multiply the given matrixmat
with this Vector4f, perform perspective division.- Parameters:
mat
- the matrix to multiply this vector by- Returns:
- this
-
mulProject
Description copied from interface:Vector4fc
Multiply the given matrixmat
with this Vector4f, perform perspective division and store the(x, y, z)
result indest
.- Specified by:
mulProject
in interfaceVector4fc
- Parameters:
mat
- the matrix to multiply this vector bydest
- will hold the result- Returns:
- dest
-
mul
Multiply all components of thisVector4f
by the given scalar value.- Parameters:
scalar
- the scalar to multiply by- Returns:
- this
-
mul
Description copied from interface:Vector4fc
Multiply all components of thisVector4f
by the given scalar value and store the result indest
. -
mul
Multiply the components of this Vector4f by the given scalar values and store the result inthis
.- Parameters:
x
- the x component to multiply byy
- the y component to multiply byz
- the z component to multiply byw
- the w component to multiply by- Returns:
- this
-
mul
Description copied from interface:Vector4fc
Multiply the components of this Vector4f by the given scalar values and store the result indest
. -
div
Divide all components of thisVector4f
by the given scalar value.- Parameters:
scalar
- the scalar to divide by- Returns:
- this
-
div
Description copied from interface:Vector4fc
Divide all components of thisVector4f
by the given scalar value and store the result indest
. -
div
Divide the components of this Vector4f by the given scalar values and store the result inthis
.- Parameters:
x
- the x component to divide byy
- the y component to divide byz
- the z component to divide byw
- the w component to divide by- Returns:
- this
-
div
Description copied from interface:Vector4fc
Divide the components of this Vector4f 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:Vector4fc
Rotate this vector by the given quaternionquat
and store the result indest
. -
rotateAbout
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:Vector4fc
Rotate this vector the specified radians around the given rotation axis and store the result intodest
.- Specified by:
rotateAxis
in interfaceVector4fc
- 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:Vector4fc
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:Vector4fc
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:Vector4fc
Rotate this vector the specified radians around the Z axis and store the result intodest
. -
lengthSquared
public float lengthSquared()Description copied from interface:Vector4fc
Return the length squared of this vector.- Specified by:
lengthSquared
in interfaceVector4fc
- Returns:
- the length squared
-
lengthSquared
public static float lengthSquared(float x, float y, float z, float w) Get the length squared of a 4-dimensional single-precision vector.- Parameters:
x
- the vector's x componenty
- the vector's y componentz
- the vector's z componentw
- the vector's w component- Returns:
- the length squared of the given vector
-
lengthSquared
public static float lengthSquared(int x, int y, int z, int w) Get the length squared of a 4-dimensional int vector.- Parameters:
x
- the vector's x componenty
- the vector's y componentz
- the vector's z componentw
- the vector's w component- Returns:
- the length squared of the given vector
-
length
public float length()Description copied from interface:Vector4fc
Return the length of this vector. -
length
public static float length(float x, float y, float z, float w) Get the length of a 4-dimensional single-precision vector.- Parameters:
x
- The vector's x componenty
- The vector's y componentz
- The vector's z componentw
- The vector's w component- Returns:
- the length of the given vector
-
normalize
Normalizes this vector.- Returns:
- this
-
normalize
Description copied from interface:Vector4fc
Normalizes 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:Vector4fc
Scale this vector to have the given length and store the result indest
. -
normalize3
Normalize this vector by computing only the norm of(x, y, z)
.- Returns:
- this
-
normalize3
Description copied from interface:Vector4fc
Normalize this vector by computing only the norm of(x, y, z)
and store the result indest
.- Specified by:
normalize3
in interfaceVector4fc
- Parameters:
dest
- will hold the result- Returns:
- dest
-
distance
Description copied from interface:Vector4fc
Return the distance between this Vector andv
. -
distance
public float distance(float x, float y, float z, float w) Description copied from interface:Vector4fc
Return the distance betweenthis
vector and(x, y, z, w)
. -
distanceSquared
Description copied from interface:Vector4fc
Return the square of the distance between this vector andv
.- Specified by:
distanceSquared
in interfaceVector4fc
- Parameters:
v
- the other vector- Returns:
- the squared of the distance
-
distanceSquared
public float distanceSquared(float x, float y, float z, float w) Description copied from interface:Vector4fc
Return the square of the distance betweenthis
vector and(x, y, z, w)
.- Specified by:
distanceSquared
in interfaceVector4fc
- 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
-
distance
public static float distance(float x1, float y1, float z1, float w1, float x2, float y2, float z2, float w2) Return the distance between(x1, y1, z1, w1)
and(x2, y2, z2, w2)
.- Parameters:
x1
- the x component of the first vectory1
- the y component of the first vectorz1
- the z component of the first vectorw1
- the w 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 vectorw2
- the 2 component of the second vector- Returns:
- the euclidean distance
-
distanceSquared
public static float distanceSquared(float x1, float y1, float z1, float w1, float x2, float y2, float z2, float w2) Return the squared distance between(x1, y1, z1, w1)
and(x2, y2, z2, w2)
.- Parameters:
x1
- the x component of the first vectory1
- the y component of the first vectorz1
- the z component of the first vectorw1
- the w 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 vectorw2
- the w component of the second vector- Returns:
- the euclidean distance squared
-
dot
Description copied from interface:Vector4fc
Compute the dot product (inner product) of this vector andv
. -
dot
public float dot(float x, float y, float z, float w) Description copied from interface:Vector4fc
Compute the dot product (inner product) of this vector and(x, y, z, w)
. -
angleCos
Description copied from interface:Vector4fc
Return the cosine of the angle between this vector and the supplied vector. Use this instead ofMath.cos(angle(v))
. -
angle
Description copied from interface:Vector4fc
Return the angle between this vector and the supplied vector. -
zero
Set all components to zero.- Returns:
- this
-
negate
Negate this vector.- Returns:
- this
-
negate
Description copied from interface:Vector4fc
Negate this vector and store the result indest
. -
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
-
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:Vector4fc
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:Vector4fc
Set the components ofdest
to be the component-wise maximum of this and the other vector. -
hashCode
public int hashCode() -
equals
-
equals
Description copied from interface:Vector4fc
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(float x, float y, float z, float w) Description copied from interface:Vector4fc
Compare the vector components ofthis
vector with the given(x, y, z, w)
and return whether all of them are equal. -
smoothStep
Description copied from interface:Vector4fc
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 interfaceVector4fc
- Parameters:
v
- the other vectort
- the interpolation factor, within[0..1]
dest
- will hold the result- Returns:
- dest
-
hermite
Description copied from interface:Vector4fc
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:Vector4fc
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:Vector4fc
Get the value of the specified component of this vector.- Specified by:
get
in interfaceVector4fc
- Parameters:
component
- the component, within[0..3]
- Returns:
- the value
- Throws:
IllegalArgumentException
- ifcomponent
is not within[0..3]
-
get
Description copied from interface:Vector4fc
- Specified by:
get
in interfaceVector4fc
- Parameters:
mode
- theRoundingMode
to usedest
- will hold the result- Returns:
- dest
-
get
Description copied from interface:Vector4fc
Set the components of the given vectordest
to those ofthis
vector. -
get
Description copied from interface:Vector4fc
Set the components of the given vectordest
to those ofthis
vector. -
maxComponent
public int maxComponent()Description copied from interface:Vector4fc
Determine the component with the biggest absolute value.- Specified by:
maxComponent
in interfaceVector4fc
- Returns:
- the component index, within
[0..3]
-
minComponent
public int minComponent()Description copied from interface:Vector4fc
Determine the component with the smallest (towards zero) absolute value.- Specified by:
minComponent
in interfaceVector4fc
- Returns:
- the component index, within
[0..3]
-
floor
Set each component of this vector to the largest (closest to positive infinity)float
value that is less than or equal to that component and is equal to a mathematical integer.- Returns:
- this
-
floor
Description copied from interface:Vector4fc
Compute for each component of this vector the largest (closest to positive infinity)float
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)float
value that is greater than or equal to that component and is equal to a mathematical integer.- Returns:
- this
-
ceil
Description copied from interface:Vector4fc
Compute for each component of this vector the smallest (closest to negative infinity)float
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 float that is equal to a mathematical integer, with ties rounding to positive infinity.- Returns:
- this
-
round
Description copied from interface:Vector4fc
Compute for each component of this vector the closest float 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:Vector4fc
-
absolute
Compute the absolute of each of this vector's components.- Returns:
- this
-
absolute
Description copied from interface:Vector4fc
Compute the absolute of each of this vector's components and store the result intodest
. -
clone
- Overrides:
clone
in classObject
- Throws:
CloneNotSupportedException
-