com.io7m.jtensors.parameterized

Class PVectorI2F<T>

java.lang.Object

com.io7m.jtensors.parameterized.PVectorI2F<T>

Type Parameters:

T - A phantom type parameter.

All Implemented Interfaces:

PVectorReadable2FType<T>, VectorReadable2FType

@Immutable
public final class PVectorI2F<T>
extends Object
implements PVectorReadable2FType<T>

A two-dimensional immutable vector type with float elements.

Values of this type are immutable and can therefore be safely accessed from multiple threads.

Constructor Summary

Constructors

Constructor and Description
PVectorI2F() Default constructor, initializing the vector with values [0.0, 0.0].
PVectorI2F(float in_x, float in_y) Construct a vector initialized with the given values.
PVectorI2F(PVectorReadable2FType<T> in_v) Construct a vector initialized with the values given in the vector v.

Method Summary

Modifier and Type	Method and Description
static <T> PVectorI2F<T>	absolute(PVectorReadable2FType<T> v) Calculate the absolute value of the vector v.
static <T> PVectorI2F<T>	add(PVectorReadable2FType<T> v0, PVectorReadable2FType<T> v1) Calculate the element-wise sum of the vectors v0 and v1.
static <T> PVectorI2F<T>	addScaled(PVectorReadable2FType<T> v0, PVectorReadable2FType<T> v1, double r) Calculate the element-wise sum of the vectors v0 and the element-wise product of v1 and r.
static <T> boolean	almostEqual(com.io7m.jequality.AlmostEqualFloat.ContextRelative context, PVectorReadable2FType<T> qa, PVectorReadable2FType<T> qb) Determine whether or not the vectors qa and qb are equal to within the degree of error given in context.
static <T> double	angle(PVectorReadable2FType<T> v0, PVectorReadable2FType<T> v1) Calculate the angle between the vectors v0 and v1 in radians.
static <T> PVectorI2F<T>	clamp(PVectorReadable2FType<T> v, float minimum, float maximum) Clamp the elements of the vector v to the range {@code [minimum ..
static <T> PVectorI2F<T>	clampByPVector(PVectorReadable2FType<T> v, PVectorReadable2FType<T> minimum, PVectorReadable2FType<T> maximum) Clamp the elements of the vector v to the inclusive range given by the corresponding elements in minimum and maximum.
static <T> PVectorI2F<T>	clampMaximum(PVectorReadable2FType<T> v, float maximum) Clamp the elements of the vector v to the range {@code [-Infinity ..
static <T> PVectorI2F<T>	clampMaximumByPVector(PVectorReadable2FType<T> v, PVectorReadable2FType<T> maximum) Clamp the elements of the vector v to the inclusive range given by the corresponding elements in maximum.
static <T> PVectorI2F<T>	clampMinimum(PVectorReadable2FType<T> v, float minimum) Clamp the elements of the vector v to the range {@code [minimum ..
static <T> PVectorI2F<T>	clampMinimumByPVector(PVectorReadable2FType<T> v, PVectorReadable2FType<T> minimum) Clamp the elements of the vector v to the inclusive range given by the corresponding elements in minimum.
static <T> double	distance(PVectorReadable2FType<T> v0, PVectorReadable2FType<T> v1) Calculate the distance between the two vectors v0 and v1.
static <T> double	dotProduct(PVectorReadable2FType<T> v0, PVectorReadable2FType<T> v1) Calculate the scalar product of the vectors v0 and v1.
boolean	equals(Object obj)
float	getXF()
float	getYF()
int	hashCode()
static <T> PVectorI2F<T>	interpolateLinear(PVectorReadable2FType<T> v0, PVectorReadable2FType<T> v1, float alpha) Linearly interpolate between v0 and v1 by the amount alpha.
static <T> double	magnitude(PVectorReadable2FType<T> v) Calculate the magnitude of the vector v.
static <T> double	magnitudeSquared(PVectorReadable2FType<T> v) Calculate the squared magnitude of the vector v.
static <T> PVectorI2F<T>	normalize(PVectorReadable2FType<T> v) Normalize the vector v, preserving its direction but reducing it to unit length.
static <T> com.io7m.jfunctional.Pair<PVectorI2F<T>,PVectorI2F<T>>	orthoNormalize(PVectorReadable2FType<T> v0, PVectorReadable2FType<T> v1) Orthonormalize and return the vectors v0 and v1 .
static <T> PVectorI2F<T>	projection(PVectorReadable2FType<T> p, PVectorReadable2FType<T> q) Calculate the projection of the vector p onto the vector q.
static <T> PVectorI2F<T>	scale(PVectorReadable2FType<T> v, double r) Scale the vector v by the scalar r.
static <T> PVectorI2F<T>	subtract(PVectorReadable2FType<T> v0, PVectorReadable2FType<T> v1) Subtract the vector v1 from the vector v0.
String	toString()
static <T> PVectorI2F<T>	zero()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

PVectorI2F

public PVectorI2F()

Default constructor, initializing the vector with values [0.0, 0.0].

PVectorI2F

public PVectorI2F(float in_x,
                  float in_y)

Construct a vector initialized with the given values.

Parameters:

in_x - The x value

in_y - The y value

PVectorI2F

public PVectorI2F(PVectorReadable2FType<T> in_v)

Construct a vector initialized with the values given in the vector v.

Parameters:

in_v - The input vector

Method Detail

absolute

public static <T> PVectorI2F<T> absolute(PVectorReadable2FType<T> v)

Calculate the absolute value of the vector v.

Type Parameters:

T - A phantom type parameter.

Parameters:

v - The input vector

Returns:

(abs v.x, abs v.y)

add

public static <T> PVectorI2F<T> add(PVectorReadable2FType<T> v0,
                                    PVectorReadable2FType<T> v1)

Calculate the element-wise sum of the vectors v0 and v1.

Type Parameters:

T - A phantom type parameter.

Parameters:

v0 - The left input vector

v1 - The right input vector

Returns:

(v0.x + v1.x, v0.y + v1.y)

addScaled

public static <T> PVectorI2F<T> addScaled(PVectorReadable2FType<T> v0,
                                          PVectorReadable2FType<T> v1,
                                          double r)

Calculate the element-wise sum of the vectors v0 and the element-wise product of v1 and r.

Type Parameters:

T - A phantom type parameter.

Parameters:

v0 - The left input vector

v1 - The right input vector

r - The scaling value

Returns:

(v0.x + (v1.x * r), v0.y + (v1.y * r))

almostEqual

public static <T> boolean almostEqual(com.io7m.jequality.AlmostEqualFloat.ContextRelative context,
                                      PVectorReadable2FType<T> qa,
                                      PVectorReadable2FType<T> qb)

Determine whether or not the vectors qa and qb are equal to within the degree of error given in context.

Type Parameters:

T - A phantom type parameter.

Parameters:

context - The equality context

qa - The left input vector

qb - The right input vector

Returns:

true iff the vectors are almost equal.

Since:

7.0.0

See Also:

AlmostEqualFloat.almostEqual(ContextRelative, float, float)

angle

public static <T> double angle(PVectorReadable2FType<T> v0,
                               PVectorReadable2FType<T> v1)

Calculate the angle between the vectors v0 and v1 in radians.

Type Parameters:

T - A phantom type parameter.

Parameters:

v0 - The left input vector

v1 - The right input vector

Returns:

The angle between the two vectors, in radians.

clamp

public static <T> PVectorI2F<T> clamp(PVectorReadable2FType<T> v,
                                      float minimum,
                                      float maximum)

Clamp the elements of the vector v to the range [minimum .. maximum] inclusive.

Type Parameters:

T - A phantom type parameter.

Parameters:

v - The input vector

minimum - The minimum allowed value

maximum - The maximum allowed value

Returns:

A vector with both elements equal to at most maximum and at least minimum.

clampByPVector

public static <T> PVectorI2F<T> clampByPVector(PVectorReadable2FType<T> v,
                                               PVectorReadable2FType<T> minimum,
                                               PVectorReadable2FType<T> maximum)

Clamp the elements of the vector v to the inclusive range given by the corresponding elements in minimum and maximum.

Type Parameters:

T - A phantom type parameter.

Parameters:

v - The input vector

minimum - The vector containing the minimum acceptable values

maximum - The vector containing the maximum acceptable values

Returns:

(min(max(v.x, minimum.x), maximum.x), min(max(v.y, minimum.y), maximum.y))

clampMaximum

public static <T> PVectorI2F<T> clampMaximum(PVectorReadable2FType<T> v,
                                             float maximum)

Clamp the elements of the vector v to the range [-Infinity .. maximum] inclusive.

Type Parameters:

T - A phantom type parameter.

Parameters:

v - The input vector

maximum - The maximum allowed value

Returns:

A vector with both elements equal to at most maximum

clampMaximumByPVector

public static <T> PVectorI2F<T> clampMaximumByPVector(PVectorReadable2FType<T> v,
                                                      PVectorReadable2FType<T> maximum)

Clamp the elements of the vector v to the inclusive range given by the corresponding elements in maximum.

Type Parameters:

T - A phantom type parameter.

Parameters:

v - The input vector

maximum - The vector containing the maximum acceptable values

Returns:

(min(v.x, maximum.x), min(v.y, maximum.y))

clampMinimum

public static <T> PVectorI2F<T> clampMinimum(PVectorReadable2FType<T> v,
                                             float minimum)

Clamp the elements of the vector v to the range [minimum .. Infinity] inclusive.

Type Parameters:

T - A phantom type parameter.

Parameters:

v - The input vector

minimum - The minimum allowed value

Returns:

A vector with both elements equal to at least minimum

clampMinimumByPVector

public static <T> PVectorI2F<T> clampMinimumByPVector(PVectorReadable2FType<T> v,
                                                      PVectorReadable2FType<T> minimum)

Clamp the elements of the vector v to the inclusive range given by the corresponding elements in minimum.

Type Parameters:

T - A phantom type parameter.

Parameters:

v - The input vector

minimum - The vector containing the minimum acceptable values

Returns:

(max(v.x, minimum.x), max(v.y, minimum.y))

distance

public static <T> double distance(PVectorReadable2FType<T> v0,
                                  PVectorReadable2FType<T> v1)

Calculate the distance between the two vectors v0 and v1.

Type Parameters:

T - A phantom type parameter.

Parameters:

v0 - The left input vector

v1 - The right input vector

Returns:

The distance between the two vectors

dotProduct

public static <T> double dotProduct(PVectorReadable2FType<T> v0,
                                    PVectorReadable2FType<T> v1)

Calculate the scalar product of the vectors v0 and v1.

Type Parameters:

T - A phantom type parameter.

Parameters:

v0 - The left input vector

v1 - The right input vector

Returns:

The scalar product of the two vectors

interpolateLinear

public static <T> PVectorI2F<T> interpolateLinear(PVectorReadable2FType<T> v0,
                                                  PVectorReadable2FType<T> v1,
                                                  float alpha)

Linearly interpolate between v0 and v1 by the amount alpha. The alpha parameter controls the degree of interpolation, such that:

• interpolateLinear(v0, v1, 0.0) = v0
• interpolateLinear(v0, v1, 1.0) = v1

Type Parameters:

T - A phantom type parameter.

Parameters:

v0 - The left input vector.

v1 - The right input vector.

alpha - The interpolation value, between 0.0 and 1.0.

Returns:

(1 - alpha) * v0 + alpha * v1

magnitude

public static <T> double magnitude(PVectorReadable2FType<T> v)

Calculate the magnitude of the vector v. Correspondingly, magnitude(normalize(v)) == 1.0.

Type Parameters:

T - A phantom type parameter.

Parameters:

v - The input vector

Returns:

The magnitude of the input vector

magnitudeSquared

public static <T> double magnitudeSquared(PVectorReadable2FType<T> v)

Calculate the squared magnitude of the vector v.

Type Parameters:

T - A phantom type parameter.

Parameters:

v - The input vector

Returns:

The squared magnitude of the input vector

normalize

public static <T> PVectorI2F<T> normalize(PVectorReadable2FType<T> v)

Normalize the vector v, preserving its direction but reducing it to unit length.

Type Parameters:

T - A phantom type parameter.

Parameters:

v - The input vector

Returns:

A vector with the same orientation as v but with magnitude equal to 1.0

orthoNormalize

public static <T> com.io7m.jfunctional.Pair<PVectorI2F<T>,PVectorI2F<T>> orthoNormalize(PVectorReadable2FType<T> v0,
                                                                                        PVectorReadable2FType<T> v1)

Orthonormalize and return the vectors v0 and v1 .

See GSP

Type Parameters:

T - A phantom type parameter.

Parameters:

v0 - The left vector

v1 - The right vector

Returns:

A pair (v0, v1), orthonormalized.

Since:

7.0.0

projection

public static <T> PVectorI2F<T> projection(PVectorReadable2FType<T> p,
                                           PVectorReadable2FType<T> q)

Calculate the projection of the vector p onto the vector q.

Type Parameters:

T - A phantom type parameter.

Parameters:

p - The left vector

q - The right vector

Returns:

((dotProduct p q) / magnitudeSquared q) * q

scale

public static <T> PVectorI2F<T> scale(PVectorReadable2FType<T> v,
                                      double r)

Scale the vector v by the scalar r.

Type Parameters:

T - A phantom type parameter.

Parameters:

v - The input vector

r - The scaling value

Returns:

(v.x * r, v.y * r)

subtract

public static <T> PVectorI2F<T> subtract(PVectorReadable2FType<T> v0,
                                         PVectorReadable2FType<T> v1)

Subtract the vector v1 from the vector v0.

Type Parameters:

T - A phantom type parameter.

Parameters:

v0 - The left input vector

v1 - The right input vector

Returns:

(v0.x - v1.x, v0.y - v1.y)

zero

public static <T> PVectorI2F<T> zero()

Type Parameters:

T - A phantom type parameter.

Returns:

The zero vector.

equals

public boolean equals(@Nullable
                      Object obj)

Overrides:

equals in class Object

getXF

public float getXF()

Specified by:

getXF in interface VectorReadable2FType

Returns:

The X value of the given vector.

getYF

public float getYF()

Specified by:

getYF in interface VectorReadable2FType

Returns:

The Y value of the given vector.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object