Interface Vector3ic
-
- All Known Implementing Classes:
Vector3i
public interface Vector3ic
Interface to a read-only view of a 3-dimensional vector of integers.- Author:
- Kai Burjack
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description Vector3i
absolute(Vector3i dest)
Compute the absolute of each of this vector's components and store the result intodest
.Vector3i
add(int x, int y, int z, Vector3i dest)
Increment the components of this vector by the given values and store the result indest
.Vector3i
add(Vector3ic v, Vector3i dest)
Add the supplied vector to this one and store the result indest
.double
distance(int x, int y, int z)
Return the distance betweenthis
vector and(x, y, z)
.double
distance(Vector3ic v)
Return the distance between this Vector andv
.long
distanceSquared(int x, int y, int z)
Return the square of the distance betweenthis
vector and(x, y, z)
.long
distanceSquared(Vector3ic v)
Return the square of the distance between this vector andv
.Vector3i
div(float scalar, Vector3i dest)
Divide all components of thisVector3i
by the given scalar value and store the result indest
.Vector3i
div(int scalar, Vector3i dest)
Divide all components of thisVector3i
by the given scalar value and store the result indest
.boolean
equals(int x, int y, int z)
Compare the vector components ofthis
vector with the given(x, y, z)
and return whether all of them are equal.int
get(int component)
Get the value of the specified component of this vector.java.nio.ByteBuffer
get(int index, java.nio.ByteBuffer buffer)
Store this vector into the suppliedByteBuffer
starting at the specified absolute buffer position/index.java.nio.IntBuffer
get(int index, java.nio.IntBuffer buffer)
Store this vector into the suppliedIntBuffer
starting at the specified absolute buffer position/index.java.nio.ByteBuffer
get(java.nio.ByteBuffer buffer)
Store this vector into the suppliedByteBuffer
at the current bufferposition
.java.nio.IntBuffer
get(java.nio.IntBuffer buffer)
Store this vector into the suppliedIntBuffer
at the current bufferposition
.Vector3ic
getToAddress(long address)
Store this vector at the given off-heap memory address.long
gridDistance(int x, int y, int z)
Return the grid distance in between (aka 1-Norm, Minkowski or Manhattan distance)(x, y)
.long
gridDistance(Vector3ic v)
Return the grid distance in between (aka 1-Norm, Minkowski or Manhattan distance)(x, y)
.double
length()
Return the length of this vector.long
lengthSquared()
Return the length squared of this vector.Vector3i
max(Vector3ic v, Vector3i dest)
Set the components ofdest
to be the component-wise maximum of this and the other vector.int
maxComponent()
Determine the component with the biggest absolute value.Vector3i
min(Vector3ic v, Vector3i dest)
Set the components ofdest
to be the component-wise minimum of this and the other vector.int
minComponent()
Determine the component with the smallest (towards zero) absolute value.Vector3i
mul(int x, int y, int z, Vector3i dest)
Multiply the components of this vector by the given values and store the result indest
.Vector3i
mul(int scalar, Vector3i dest)
Multiply the components of this vector by the given scalar and store the result indest
.Vector3i
mul(Vector3ic v, Vector3i dest)
Multiply the supplied vector by this one and store the result indest
.Vector3i
negate(Vector3i dest)
Negate this vector and store the result indest
.Vector3i
sub(int x, int y, int z, Vector3i dest)
Decrement the components of this vector by the given values and store the result indest
.Vector3i
sub(Vector3ic v, Vector3i dest)
Subtract the supplied vector from this one and store the result indest
.int
x()
int
y()
int
z()
-
-
-
Method Detail
-
x
int x()
- Returns:
- the value of the x component
-
y
int y()
- Returns:
- the value of the y component
-
z
int z()
- Returns:
- the value of the z component
-
get
java.nio.IntBuffer get(java.nio.IntBuffer buffer)
Store this vector into the suppliedIntBuffer
at the current bufferposition
.This method will not increment the position of the given IntBuffer.
In order to specify the offset into the IntBuffer at which the vector is stored, use
get(int, IntBuffer)
, taking the absolute position as parameter.- Parameters:
buffer
- will receive the values of this vector inx, y, z
order- Returns:
- the passed in buffer
- See Also:
get(int, IntBuffer)
-
get
java.nio.IntBuffer get(int index, java.nio.IntBuffer buffer)
Store this vector into the suppliedIntBuffer
starting at the specified absolute buffer position/index.This method will not increment the position of the given IntBuffer.
- Parameters:
index
- the absolute position into the IntBufferbuffer
- will receive the values of this vector inx, y, z
order- Returns:
- the passed in buffer
-
get
java.nio.ByteBuffer get(java.nio.ByteBuffer buffer)
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
order- Returns:
- the passed in buffer
- See Also:
get(int, ByteBuffer)
-
get
java.nio.ByteBuffer get(int index, java.nio.ByteBuffer buffer)
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
order- Returns:
- the passed in buffer
-
getToAddress
Vector3ic getToAddress(long address)
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
Vector3i sub(Vector3ic v, Vector3i dest)
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
Vector3i sub(int x, int y, int z, Vector3i dest)
Decrement the components of this vector by the given values and store the result indest
.- Parameters:
x
- the x component to subtracty
- the y component to subtractz
- the z component to subtractdest
- will hold the result- Returns:
- dest
-
add
Vector3i add(Vector3ic v, Vector3i dest)
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
Vector3i add(int x, int y, int z, Vector3i dest)
Increment the components of this vector by the given values and store the result indest
.- Parameters:
x
- the x component to addy
- the y component to addz
- the z component to adddest
- will hold the result- Returns:
- dest
-
mul
Vector3i mul(int scalar, Vector3i dest)
Multiply the components of this vector by the given scalar and store the result indest
.- Parameters:
scalar
- the value to multiply this vector's components bydest
- will hold the result- Returns:
- dest
-
mul
Vector3i mul(Vector3ic v, Vector3i dest)
Multiply the supplied vector by this one and store the result indest
.- Parameters:
v
- the vector to multiplydest
- will hold the result- Returns:
- dest
-
mul
Vector3i mul(int x, int y, int z, Vector3i dest)
Multiply the components of this vector by the given values and store the result indest
.- Parameters:
x
- the x component to multiplyy
- the y component to multiplyz
- the z component to multiplydest
- will hold the result- Returns:
- dest
-
div
Vector3i div(float scalar, Vector3i dest)
Divide all components of thisVector3i
by the given scalar value and store the result indest
.- Parameters:
scalar
- the scalar to divide bydest
- will hold the result- Returns:
- dest
-
div
Vector3i div(int scalar, Vector3i dest)
Divide all components of thisVector3i
by the given scalar value and store the result indest
.- Parameters:
scalar
- the scalar to divide bydest
- will hold the result- Returns:
- dest
-
lengthSquared
long lengthSquared()
Return the length squared of this vector.- Returns:
- the length squared
-
length
double length()
Return the length of this vector.- Returns:
- the length
-
distance
double distance(Vector3ic v)
Return the distance between this Vector andv
.- Parameters:
v
- the other vector- Returns:
- the distance
-
distance
double distance(int x, int y, int z)
Return the distance betweenthis
vector 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:
- the euclidean distance
-
gridDistance
long gridDistance(Vector3ic v)
Return the grid distance in between (aka 1-Norm, Minkowski or Manhattan distance)(x, y)
.- Parameters:
v
- the other vector- Returns:
- the grid distance
-
gridDistance
long gridDistance(int x, int y, int z)
Return the grid distance in between (aka 1-Norm, Minkowski or Manhattan distance)(x, y)
.- Parameters:
x
- the x component of the other vectory
- the y component of the other vectorz
- the y component of the other vector- Returns:
- the grid distance
-
distanceSquared
long distanceSquared(Vector3ic v)
Return the square of the distance between this vector andv
.- Parameters:
v
- the other vector- Returns:
- the squared of the distance
-
distanceSquared
long distanceSquared(int x, int y, int z)
Return the square of the distance betweenthis
vector 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:
- the square of the distance
-
negate
Vector3i negate(Vector3i dest)
Negate this vector and store the result indest
.- Parameters:
dest
- will hold the result- Returns:
- dest
-
min
Vector3i min(Vector3ic v, Vector3i dest)
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
Vector3i max(Vector3ic v, Vector3i dest)
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
-
get
int get(int component) throws java.lang.IllegalArgumentException
Get the value of the specified component of this vector.- Parameters:
component
- the component, within[0..2]
- Returns:
- the value
- Throws:
java.lang.IllegalArgumentException
- ifcomponent
is not within[0..2]
-
maxComponent
int maxComponent()
Determine the component with the biggest absolute value.- Returns:
- the component index, within
[0..2]
-
minComponent
int minComponent()
Determine the component with the smallest (towards zero) absolute value.- Returns:
- the component index, within
[0..2]
-
absolute
Vector3i absolute(Vector3i dest)
Compute the absolute of each of this vector's components and store the result intodest
.- Parameters:
dest
- will hold the result- Returns:
- dest
-
equals
boolean equals(int x, int y, int z)
Compare the vector components ofthis
vector with the given(x, y, z)
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 to- Returns:
true
if all the vector components are equal
-
-