public final class VectorM3D extends Object implements Vector3DType
A three-dimensional mutable vector type with double elements.
Values of this type cannot be accessed safely from multiple threads without explicit synchronization.
| Modifier and Type | Class and Description |
|---|---|
static class |
VectorM3D.ContextVM3D
Preallocated storage to allow all vector functions to run without
allocating.
|
| Constructor and Description |
|---|
VectorM3D()
Default constructor, initializing the vector with values
[0.0, 0.0,
0.0]. |
VectorM3D(double in_x,
double in_y,
double in_z)
Construct a vector initialized with the given values.
|
VectorM3D(VectorReadable3DType in_v)
Construct a vector initialized with the values given in the vector
v. |
| Modifier and Type | Method and Description |
|---|---|
static <V extends VectorWritable3DType> |
absolute(VectorReadable3DType v,
V out)
Calculate the absolute values of the elements in vector
v, saving
the result to out. |
static <V extends VectorWritable3DType & VectorReadable3DType> |
absoluteInPlace(V v)
Calculate the absolute values of the elements in vector
v,
modifying the vector in-place. |
static <V extends VectorWritable3DType> |
add(VectorReadable3DType v0,
VectorReadable3DType v1,
V out)
Calculate the element-wise sum of the vectors
v0 and v1,
saving the result to out. |
static <V extends VectorWritable3DType & VectorReadable3DType> |
addInPlace(V v0,
VectorReadable3DType v1)
Calculate the element-wise sum of the vectors
v0 and v1,
saving the result to v0. |
static <V extends VectorWritable3DType> |
addScaled(VectorReadable3DType v0,
VectorReadable3DType v1,
double r,
V out)
Calculate the element-wise sum of the vectors
v0 and the
element-wise product of v1 and r, saving the result to
out. |
static <V extends VectorWritable3DType & VectorReadable3DType> |
addScaledInPlace(V v0,
VectorReadable3DType v1,
double r)
Calculate the element-wise sum of the vectors
v0 and the
element-wise product of v1 and r, saving the result to
v0. |
static boolean |
almostEqual(com.io7m.jequality.AlmostEqualDouble.ContextRelative context,
VectorReadable3DType qa,
VectorReadable3DType qb)
Determine whether or not the vectors
qa and qb are equal to
within the degree of error given in context. |
static <V extends VectorWritable3DType> |
clamp(VectorReadable3DType v,
double minimum,
double maximum,
V out)
Clamp the elements of the vector
v to the range {@code [minimum .. |
static <V extends VectorWritable3DType> |
clampByVector(VectorReadable3DType v,
VectorReadable3DType minimum,
VectorReadable3DType maximum,
V out)
Clamp the elements of the vector
v to the inclusive range given by
the corresponding elements in minimum and maximum, saving
the result to out. |
static <V extends VectorWritable3DType & VectorReadable3DType> |
clampByVectorInPlace(V v,
VectorReadable3DType minimum,
VectorReadable3DType maximum)
Clamp the elements of the vector
v to the inclusive range given by
the corresponding elements in minimum and maximum, saving
the result to v. |
static <V extends VectorWritable3DType & VectorReadable3DType> |
clampInPlace(V v,
double minimum,
double maximum)
Clamp the elements of the vector
v to the range {@code [minimum .. |
static <V extends VectorWritable3DType> |
clampMaximum(VectorReadable3DType v,
double maximum,
V out)
Clamp the elements of the vector
v to the range {@code [-Infinity
.. |
static <V extends VectorWritable3DType> |
clampMaximumByVector(VectorReadable3DType v,
VectorReadable3DType maximum,
V out)
Clamp the elements of the vector
v to the inclusive range given by
the corresponding elements in maximum, saving the result to out. |
static <V extends VectorWritable3DType & VectorReadable3DType> |
clampMaximumByVectorInPlace(V v,
VectorReadable3DType maximum)
Clamp the elements of the vector
v to the inclusive range given by
the corresponding elements in maximum, saving the result to v. |
static <V extends VectorWritable3DType & VectorReadable3DType> |
clampMaximumInPlace(V v,
double maximum)
Clamp the elements of the vector
v to the range {@code [-Infinity
.. |
static <V extends VectorWritable3DType> |
clampMinimum(VectorReadable3DType v,
double minimum,
V out)
Clamp the elements of the vector
v to the range {@code [minimum .. |
static <V extends VectorWritable3DType> |
clampMinimumByVector(VectorReadable3DType v,
VectorReadable3DType minimum,
V out)
Clamp the elements of the vector
v to the inclusive range given by
the corresponding elements in minimum, saving the result to out. |
static <V extends VectorWritable3DType & VectorReadable3DType> |
clampMinimumByVectorInPlace(V v,
VectorReadable3DType minimum)
Clamp the elements of the vector
v to the inclusive range given by
the corresponding elements in minimum, saving the result to v. |
static <V extends VectorWritable3DType & VectorReadable3DType> |
clampMinimumInPlace(V v,
double minimum)
Clamp the elements of the vector
v to the range {@code [minimum .. |
static <V extends VectorWritable3DType> |
copy(VectorReadable3DType input,
V output)
Copy all elements of the vector
input to the vector output. |
void |
copyFrom2D(VectorReadable2DType in_v)
Set the current vector to the contents of the input vector.
|
void |
copyFrom3D(VectorReadable3DType in_v)
Set the current vector to the contents of the input vector.
|
static <V extends VectorWritable3DType> |
crossProduct(VectorReadable3DType v0,
VectorReadable3DType v1,
V out)
Return a vector perpendicular to both
v0 and v1 , saving
the result in out. |
static double |
distance(VectorM3D.ContextVM3D c,
VectorReadable3DType v0,
VectorReadable3DType v1)
Calculate the distance between the two vectors
v0 and v1. |
static double |
dotProduct(VectorReadable3DType v0,
VectorReadable3DType v1)
Calculate the scalar product of the vectors
v0 and v1. |
boolean |
equals(Object obj) |
double |
getXD() |
double |
getYD() |
double |
getZD() |
int |
hashCode() |
static <V extends VectorWritable3DType> |
interpolateLinear(VectorM3D.ContextVM3D c,
VectorReadable3DType v0,
VectorReadable3DType v1,
double alpha,
V r)
Linearly interpolate between
v0 and v1 by the amount alpha, saving the result to r. |
static double |
magnitude(VectorReadable3DType v)
Calculate the magnitude of the vector
v. |
static double |
magnitudeSquared(VectorReadable3DType v)
Calculate the squared magnitude of the vector
v. |
static <V extends VectorWritable3DType> |
normalize(VectorReadable3DType v,
V out)
Returns a vector with the same orientation as
v but with magnitude
equal to 1.0 in out. |
static <V extends VectorWritable3DType & VectorReadable3DType> |
normalizeInPlace(V v)
Returns a vector with the same orientation as
v but with magnitude
equal to 1.0 in v. |
static <V extends VectorReadable3DType,U extends VectorWritable3DType> |
orthoNormalize(VectorM3D.ContextVM3D c,
VectorReadable3DType v0,
U v0_out,
VectorReadable3DType v1,
U v1_out)
Orthonormalize and return the vectors
v0 and v1 . |
static <V extends VectorWritable3DType & VectorReadable3DType,W extends VectorWritable3DType & VectorReadable3DType> |
orthoNormalizeInPlace(VectorM3D.ContextVM3D c,
V v0,
W v1)
Orthonormalize and the vectors
v0 and v1. |
static <V extends VectorWritable3DType> |
projection(VectorReadable3DType p,
VectorReadable3DType q,
V r)
Calculate the projection of the vector
p onto the vector q,
saving the result in r. |
static <V extends VectorWritable3DType> |
scale(VectorReadable3DType v,
double r,
V out)
Scale the vector
v by the scalar r, saving the result to
out. |
static <V extends VectorWritable3DType & VectorReadable3DType> |
scaleInPlace(V v,
double r)
Scale the vector
v by the scalar r, saving the result to
v. |
void |
set2D(double in_x,
double in_y)
Set the current
x and y values of the current vector. |
void |
set3D(double in_x,
double in_y,
double in_z)
Set the current
x, y and z values of the current
vector. |
void |
setXD(double in_x)
Set the current
x value of the current vector. |
void |
setYD(double in_y)
Set the current
y value of the current vector. |
void |
setZD(double in_z)
Set the current
z value of the current vector. |
static <V extends VectorWritable3DType> |
subtract(VectorReadable3DType v0,
VectorReadable3DType v1,
V out)
Subtract the vector
v1 from the vector v0, saving the
result to out. |
static <V extends VectorWritable3DType & VectorReadable3DType> |
subtractInPlace(V v0,
VectorReadable3DType v1)
Subtract the vector
v1 from the vector v0, saving the
result to v0. |
String |
toString() |
public VectorM3D()
[0.0, 0.0,
0.0].public VectorM3D(double in_x,
double in_y,
double in_z)
in_x - The x valuein_y - The y valuein_z - The z valuepublic VectorM3D(VectorReadable3DType in_v)
v.in_v - The source vectorpublic static <V extends VectorWritable3DType> V absolute(VectorReadable3DType v, V out)
v, saving
the result to out.V - The precise type of vectorv - The input vectorout - The output vector(abs v.x, abs v.y, abs v.z)public static <V extends VectorWritable3DType & VectorReadable3DType> V absoluteInPlace(V v)
v,
modifying the vector in-place.V - The precise type of vectorv - The input vector(abs v.x, abs v.y, abs v.z)public static <V extends VectorWritable3DType> V add(VectorReadable3DType v0, VectorReadable3DType v1, V out)
v0 and v1,
saving the result to out.V - The precise type of vectorv0 - The left input vectorv1 - The right input vectorout - The output vector(v0.x + v1.x, v0.y + v1.y, v0.z + v1.z)public static <V extends VectorWritable3DType & VectorReadable3DType> V addInPlace(V v0, VectorReadable3DType v1)
v0 and v1,
saving the result to v0.V - The precise type of vectorv0 - The left input vectorv1 - The right input vector(v0.x + v1.x, v0.y + v1.y, v0.z + v1.z)public static <V extends VectorWritable3DType> V addScaled(VectorReadable3DType v0, VectorReadable3DType v1, double r, V out)
v0 and the
element-wise product of v1 and r, saving the result to
out.V - The precise type of vectorv0 - The left input vectorv1 - The right input vectorout - The output vectorr - The scaling value(v0.x + (v1.x * r), v0.y + (v1.y * r), v0.z + (v1.z * r))public static <V extends VectorWritable3DType & VectorReadable3DType> V addScaledInPlace(V v0, VectorReadable3DType v1, double r)
v0 and the
element-wise product of v1 and r, saving the result to
v0.V - The precise type of vectorv0 - The left input vectorv1 - The right input vectorr - The scaling value(v0.x + (v1.x * r), v0.y + (v1.y * r), v0.z + (v1.z * r))public static boolean almostEqual(com.io7m.jequality.AlmostEqualDouble.ContextRelative context,
VectorReadable3DType qa,
VectorReadable3DType qb)
qa and qb are equal to
within the degree of error given in context.context - The equality contextqa - The left input vectorqb - The right input vectortrue if the vectors are almost equalAlmostEqualDouble.almostEqual(ContextRelative, double, double)public static <V extends VectorWritable3DType> V clamp(VectorReadable3DType v, double minimum, double maximum, V out)
v to the range [minimum ..
maximum] inclusive, saving the result to out.V - The precise type of vectorv - The input vectorminimum - The minimum allowed valuemaximum - The maximum allowed valueout - The output vectormaximum and at
least minimumpublic static <V extends VectorWritable3DType> V clampByVector(VectorReadable3DType v, VectorReadable3DType minimum, VectorReadable3DType maximum, V out)
v to the inclusive range given by
the corresponding elements in minimum and maximum, saving
the result to out.V - The precise type of vectorv - The input vectorminimum - The vector containing the minimum acceptable valuesmaximum - The vector containing the maximum acceptable valuesout - The output vector(min(max(v.x, minimum.x), maximum.x), min(max(v.y,
minimum.y), maximum.y), min(max(v.z, minimum.z), maximum.z))public static <V extends VectorWritable3DType & VectorReadable3DType> V clampByVectorInPlace(V v, VectorReadable3DType minimum, VectorReadable3DType maximum)
v to the inclusive range given by
the corresponding elements in minimum and maximum, saving
the result to v.V - The precise type of vectorv - The input vectorminimum - The vector containing the minimum acceptable valuesmaximum - The vector containing the maximum acceptable values(min(max(v.x, minimum.x), maximum.x), min(max(v.y,
minimum.y), maximum.y), min(max(v.z, minimum.z), maximum.z))public static <V extends VectorWritable3DType & VectorReadable3DType> V clampInPlace(V v, double minimum, double maximum)
v to the range [minimum ..
maximum] inclusive, saving the result to v.V - The precise type of vectorv - The input vectorminimum - The minimum allowed valuemaximum - The maximum allowed valuemaximum and at
least minimum, in vpublic static <V extends VectorWritable3DType> V clampMaximum(VectorReadable3DType v, double maximum, V out)
v to the range [-Infinity
.. maximum] inclusive, saving the result to out.V - The precise type of vectorv - The input vectorout - The output vectormaximum - The maximum allowed valuemaximumpublic static <V extends VectorWritable3DType> V clampMaximumByVector(VectorReadable3DType v, VectorReadable3DType maximum, V out)
v to the inclusive range given by
the corresponding elements in maximum, saving the result to out.V - The precise type of vectorv - The input vectormaximum - The vector containing the maximum acceptable valuesout - The output vector(min(v.x, maximum.x), min(v.y, maximum.y), min(v.z,
maximum.z))public static <V extends VectorWritable3DType & VectorReadable3DType> V clampMaximumByVectorInPlace(V v, VectorReadable3DType maximum)
v to the inclusive range given by
the corresponding elements in maximum, saving the result to v.V - The precise type of vectorv - The input vectormaximum - The vector containing the maximum acceptable values(min(v.x, maximum.x), min(v.y, maximum.y), min(v.z,
maximum.z))public static <V extends VectorWritable3DType & VectorReadable3DType> V clampMaximumInPlace(V v, double maximum)
v to the range [-Infinity
.. maximum] inclusive, saving the result to v.V - The precise type of vectorv - The input vectormaximum - The maximum allowed valuemaximum , in
vpublic static <V extends VectorWritable3DType> V clampMinimum(VectorReadable3DType v, double minimum, V out)
v to the range [minimum ..
Infinity] inclusive, saving the result to out.V - The precise type of vectorv - The input vectorout - The output vectorminimum - The minimum allowed valueminimumpublic static <V extends VectorWritable3DType> V clampMinimumByVector(VectorReadable3DType v, VectorReadable3DType minimum, V out)
v to the inclusive range given by
the corresponding elements in minimum, saving the result to out.V - The precise type of vectorv - The input vectorout - The output vectorminimum - The vector containing the minimum acceptable values(max(v.x, minimum.x), max(v.y, minimum.y), max(v.z,
minimum.z))public static <V extends VectorWritable3DType & VectorReadable3DType> V clampMinimumByVectorInPlace(V v, VectorReadable3DType minimum)
v to the inclusive range given by
the corresponding elements in minimum, saving the result to v.V - The precise type of vectorv - The input vectorminimum - The vector containing the minimum acceptable values(max(v.x, minimum.x), max(v.y, minimum.y), max(v.z,
minimum.z)) , in vpublic static <V extends VectorWritable3DType & VectorReadable3DType> V clampMinimumInPlace(V v, double minimum)
v to the range [minimum ..
Infinity] inclusive, saving the result to v.V - The precise type of vectorv - The input vectorminimum - The minimum allowed valueminimum, in
v.public static <V extends VectorWritable3DType> V copy(VectorReadable3DType input, V output)
input to the vector output.V - The precise type of vectorinput - The input vectoroutput - The output vectorpublic static <V extends VectorWritable3DType> V crossProduct(VectorReadable3DType v0, VectorReadable3DType v1, V out)
v0 and v1 , saving
the result in out.V - The precise type of vectorv0 - The left input vector.v1 - The right input vector.out - The output vector.public static double distance(VectorM3D.ContextVM3D c, VectorReadable3DType v0, VectorReadable3DType v1)
v0 and v1.c - Preallocated storagev0 - The left input vectorv1 - The right input vectorpublic static double dotProduct(VectorReadable3DType v0, VectorReadable3DType v1)
v0 and v1.v0 - The left input vectorv1 - The right input vectorpublic static <V extends VectorWritable3DType> V interpolateLinear(VectorM3D.ContextVM3D c, VectorReadable3DType v0, VectorReadable3DType v1, double alpha, V r)
v0 and v1 by the amount alpha, saving the result to r.
The alpha parameter controls the degree of interpolation, such
that:
interpolateLinear(v0, v1, 0.0, r) -> r = v0interpolateLinear(v0, v1, 1.0, r) -> r = v1V - The precise type of vectorc - Preallocated storagev0 - The left input vector.v1 - The right input vector.alpha - The interpolation value, between 0.0 and 1.0.r - The result vector.rpublic static double magnitude(VectorReadable3DType v)
v.
Correspondingly, magnitude(normalize(v)) == 1.0.v - The input vectorpublic static double magnitudeSquared(VectorReadable3DType v)
v.v - The input vectorpublic static <V extends VectorWritable3DType> V normalize(VectorReadable3DType v, V out)
v but with magnitude
equal to 1.0 in out. The function returns the zero vector
iff the input is the zero vector.V - The precise type of vectorv - The input vectorout - The output vectorpublic static <V extends VectorWritable3DType & VectorReadable3DType> V normalizeInPlace(V v)
v but with magnitude
equal to 1.0 in v. The function returns the zero vector iff
the input is the zero vector.V - The precise type of vectorv - The input vectorpublic static <V extends VectorReadable3DType,U extends VectorWritable3DType> void orthoNormalize(VectorM3D.ContextVM3D c, VectorReadable3DType v0, U v0_out, VectorReadable3DType v1, U v1_out)
Orthonormalize and return the vectors v0 and v1 .
See GSP
V - The precise type of readable vectorsU - The precise type of writable vectorsc - Preallocated storagev0 - The left vectorv0_out - The orthonormalized form of v0v1 - The right vectorv1_out - The orthonormalized form of v1public static <V extends VectorWritable3DType & VectorReadable3DType,W extends VectorWritable3DType & VectorReadable3DType> void orthoNormalizeInPlace(VectorM3D.ContextVM3D c, V v0, W v1)
Orthonormalize and the vectors v0 and v1.
See GSP
V - The precise type of readable/writable vectorW - The precise type of readable/writable vectorc - Preallocated storagev0 - The left vectorv1 - The right vectorpublic static <V extends VectorWritable3DType> V projection(VectorReadable3DType p, VectorReadable3DType q, V r)
p onto the vector q,
saving the result in r.V - The precise type of vectorp - The left vectorq - The right vectorr - The output vector((dotProduct p q) / magnitudeSquared q) * qpublic static <V extends VectorWritable3DType> V scale(VectorReadable3DType v, double r, V out)
v by the scalar r, saving the result to
out.V - The precise type of vectorv - The input vectorr - The scaling valueout - The output vector(v.x * r, v.y * r, v.z * r)public static <V extends VectorWritable3DType & VectorReadable3DType> V scaleInPlace(V v, double r)
v by the scalar r, saving the result to
v.V - The precise type of vectorv - The input vectorr - The scaling value(v.x * r, v.y * r, v.z * r)public static <V extends VectorWritable3DType> V subtract(VectorReadable3DType v0, VectorReadable3DType v1, V out)
v1 from the vector v0, saving the
result to out.V - The precise type of vectorv0 - The left input vectorv1 - The right input vectorout - The output vector(v0.x - v1.x, v0.y - v1.y, v0.z - v1.z)public static <V extends VectorWritable3DType & VectorReadable3DType> V subtractInPlace(V v0, VectorReadable3DType v1)
v1 from the vector v0, saving the
result to v0.V - The precise type of vectorv0 - The left input vectorv1 - The right input vector(v0.x - v1.x, v0.y - v1.y, v0.z - v1.z)public void copyFrom2D(VectorReadable2DType in_v)
VectorWritable2DTypecopyFrom2D in interface VectorWritable2DTypein_v - The input vectorpublic void copyFrom3D(VectorReadable3DType in_v)
VectorWritable3DTypecopyFrom3D in interface VectorWritable3DTypein_v - The input vectorpublic double getXD()
getXD in interface VectorReadable2DTypepublic void setXD(double in_x)
VectorWritable2DTypex value of the current vector.setXD in interface VectorWritable2DTypein_x - The new x value.public double getYD()
getYD in interface VectorReadable2DTypepublic void setYD(double in_y)
VectorWritable2DTypey value of the current vector.setYD in interface VectorWritable2DTypein_y - The new y value.public double getZD()
getZD in interface VectorReadable3DTypepublic void setZD(double in_z)
VectorWritable3DTypez value of the current vector.setZD in interface VectorWritable3DTypein_z - The new z value.public void set2D(double in_x,
double in_y)
VectorWritable2DTypex and y values of the current vector.set2D in interface VectorWritable2DTypein_x - The new x value.in_y - The new y value.public void set3D(double in_x,
double in_y,
double in_z)
VectorWritable3DTypex, y and z values of the current
vector.set3D in interface VectorWritable3DTypein_x - The new x value.in_y - The new y value.in_z - The new z value.Copyright © 2015 <code@io7m.com> http://io7m.com