Class Point4Float

java.lang.Object

com.github.yellowstonegames.grid.Point4Float

All Implemented Interfaces:

com.github.tommyettinger.crux.Point4<Point4Float>, com.github.tommyettinger.crux.PointN<Point4Float>, com.github.tommyettinger.crux.PointNFloat<Point4Float, com.github.tommyettinger.crux.Point4<?>>, com.github.tommyettinger.ds.PrimitiveCollection<Float>, com.github.tommyettinger.ds.PrimitiveCollection.OfFloat, PointNFloat<Point4Float, com.github.tommyettinger.crux.Point4<?>>

public class Point4Float
extends Object
implements com.github.tommyettinger.crux.Point4<Point4Float>, PointNFloat<Point4Float, com.github.tommyettinger.crux.Point4<?>>, com.github.tommyettinger.ds.PrimitiveCollection.OfFloat

A mutable 4D point with float components implementing Point4, PrimitiveCollection.OfFloat, and PointNFloat.

Nested Class Summary

Nested classes/interfaces inherited from interface com.github.tommyettinger.ds.PrimitiveCollection

com.github.tommyettinger.ds.PrimitiveCollection.OfBoolean, com.github.tommyettinger.ds.PrimitiveCollection.OfByte, com.github.tommyettinger.ds.PrimitiveCollection.OfChar, com.github.tommyettinger.ds.PrimitiveCollection.OfDouble, com.github.tommyettinger.ds.PrimitiveCollection.OfFloat, com.github.tommyettinger.ds.PrimitiveCollection.OfInt, com.github.tommyettinger.ds.PrimitiveCollection.OfLong, com.github.tommyettinger.ds.PrimitiveCollection.OfShort

Field Summary

Fields

Modifier and Type	Field	Description
float	w
float	x
float	y
float	z

Constructor Summary

Constructors

Constructor	Description
Point4Float()
Point4Float(float x, float y, float z, float w)
Point4Float(com.github.tommyettinger.crux.Point4<?> p)
Point4Float(Point4Float p)

Method Summary

Modifier and Type	Method	Description
boolean	add(float c)	Not supported; this collection is fixed-size.
Point4Float	add(float x, float y, float z, float w)
Point4Float	add(com.github.tommyettinger.crux.Point4<?> point)
Point4Float	add(Point4Float point)
Point4Float	addProduct(com.github.tommyettinger.crux.Point4<?> vec, float scalar)
Point4Float	addProduct(com.github.tommyettinger.crux.Point4<?> vec, com.github.tommyettinger.crux.Point4<?> mulVec)
Point4Float	clampEach(float min, float max)	For each component, this clamps it between min and max, inclusive.
Point4Float	clampLength(float min, float max)
void	clear()	Not supported; this collection is fixed-size.
boolean	contains(float c)	Compares c with the components of this collection using ==; if any are considered equal, this returns true.
Point4Float	copy()
Point4Float	cpy()
float	distance(com.github.tommyettinger.crux.Point4<?> point)
float	distanceSquared(com.github.tommyettinger.crux.Point4<?> point)
Point4Float	div(com.github.tommyettinger.crux.Point4<?> point)
Point4Float	div(Point4Float point)
Point4Float	divide(float scalar)
Point4Float	divide(com.github.tommyettinger.crux.Point4<?> point)
float	dot(com.github.tommyettinger.crux.Point4<?> other)
static float	dot(com.github.tommyettinger.crux.Point4<?> a, com.github.tommyettinger.crux.Point4<?> b)
float	dst2(com.github.tommyettinger.crux.Point4<?> point)
float	dst2(Point4Float point)
boolean	equals(Object o)
boolean	floatingPoint()	Returns true if this type of point uses float or double for its components, or false otherwise.
Point4Float	fract()	Sets each component so it only has a fractional value, by subtracting the floor from each component.
Point4Float	fractional()
Point4Float	fromString(String s)	Sets this Point5Float to the value represented by the specified string according to the format of toString().
float	get(int index)	Gets the component at the specified index.
int	hashCode()
Point4Float	interpolate(com.github.tommyettinger.crux.Point4<?> target, float alpha, com.github.tommyettinger.digital.Interpolations.Interpolator interpolation)	Calls PointNFloat.lerp(PointN, float) with the alpha determined by the given interpolation.
Point4Float	inverse()	Assigns to each component of this point 1f divided by its original value.
boolean	isEmpty()
PointNFloatIterator	iterator()
float	len2()
Point4Float	lerp(com.github.tommyettinger.crux.Point4<?> target, float alpha)	Linear-interpolates from this point toward target, moving a distance proportional to alpha and changing this point in-place if possible.
Point4Float	limit(float limit)
Point4Float	limit2(float limit2)
Point4Float	limitSquared(float limit2)
Point4Float	minus(float scalar)
Point4Float	mul(float scalar)	Multiplies each component of this by the given scalar, in-place, and returns this.
Point4Float	mul(float x, float y, float z, float w)	Multiplies each component of this by the corresponding scalar, in-place, and returns this.
Point4Float	mul(com.github.tommyettinger.crux.Point4<?> point)
Point4Float	mul(Point4Float point)
Point4Float	mulAdd(com.github.tommyettinger.crux.Point4<?> vec, float scalar)
Point4Float	mulAdd(com.github.tommyettinger.crux.Point4<?> vec, com.github.tommyettinger.crux.Point4<?> mulVec)
Point4Float	multiply(float scalar)	Multiplies each component of this by the given scalar, in-place, and returns this.
Point4Float	multiply(float x, float y, float z, float w)	Multiplies each component of this by the corresponding scalar, in-place, and returns this.
Point4Float	multiply(com.github.tommyettinger.crux.Point4<?> point)
Point4Float	nor()
Point4Float	normalize()
boolean	notEmpty()
Point4Float	plus(float scalar)
boolean	remove(float c)	Not supported; this collection is fixed-size.
Point4Float	scale(float scalar)
Point4Float	scale(float x, float y, float z, float w)
Point4Float	scale(com.github.tommyettinger.crux.Point4<?> point)
Point4Float	scl(float x, float y, float z, float w)
Point4Float	scl(com.github.tommyettinger.crux.Point4<?> point)
Point4Float	scl(Point4Float point)
Point4Float	set(float x, float y, float z, float w)
Point4Float	set(com.github.tommyettinger.crux.Point4<?> point)
Point4Float	set(Point4Float point)
Point4Float	setAt(int index, float value)	Sets the component at the specified index to the specified value.
Point4Float	setLength(float len)
Point4Float	setLength2(float len2)
Point4Float	setToRandomDirection(Random random)	Sets this PointNFloat to a randomly chosen unit vector.
Point4Float	setZero()
int	size()
Point4Float	slerpGeometric(Point4Float target, float alpha)
Point4Float	sub(float x, float y, float z, float w)
Point4Float	sub(com.github.tommyettinger.crux.Point4<?> point)
Point4Float	sub(Point4Float point)
Point4Float	subtract(float x, float y, float z, float w)
Point4Float	subtract(com.github.tommyettinger.crux.Point4<?> point)
Point4Float	times(float scalar)
String	toString()	Converts this Point5Float to a string in the format (x,y,z,w).
float	w()
Point4Float	w(float next)
float	x()
Point4Float	x(float next)
float	y()
Point4Float	y(float next)
float	z()
Point4Float	z(float next)

Methods inherited from class Object

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

Methods inherited from interface com.github.tommyettinger.crux.Point4

rank, seti, wi, wi, xi, xi, yi, yi, zi, zi

Methods inherited from interface com.github.tommyettinger.crux.PointN

dst, isUnit, isUnit, isZero, isZero, len, mutable

Methods inherited from interface com.github.tommyettinger.ds.PrimitiveCollection.OfFloat

addAll, addAll, addAll, addAll, addDense, addDense, addLegible, addLegible, addVarargs, appendTo, appendTo, containsAll, containsAll, containsAll, containsAll, containsAny, containsAny, containsAny, containsAny, denseAppendTo, first, forEach, removeAll, removeAll, removeAll, removeAll, removeEach, removeEach, removeEach, removeEach, removeIf, retainAll, retainAll, retainAll, toArray, toArray, toDenseString, toDenseString, toString, toString, toString

Field Details

x

public float x

y

public float y

z

public float z

w

public float w

Constructor Details

Point4Float

public Point4Float()

Point4Float

public Point4Float(float x,
 float y,
 float z,
 float w)

Point4Float

public Point4Float(Point4Float p)

Point4Float

public Point4Float(com.github.tommyettinger.crux.Point4<?> p)

Method Details

floatingPoint

public boolean floatingPoint()

Returns true if this type of point uses float or double for its components, or false otherwise. This always returns true.

Specified by:

floatingPoint in interface com.github.tommyettinger.crux.PointN<Point4Float>

Specified by:

floatingPoint in interface com.github.tommyettinger.crux.PointNFloat<Point4Float, com.github.tommyettinger.crux.Point4<?>>

Specified by:

floatingPoint in interface PointNFloat<Point4Float, com.github.tommyettinger.crux.Point4<?>>

Returns:

true

cpy

public Point4Float cpy()

Specified by:

cpy in interface com.github.tommyettinger.crux.PointN<Point4Float>

copy

public Point4Float copy()

len2

public float len2()

Specified by:

len2 in interface com.github.tommyettinger.crux.PointN<Point4Float>

set

public Point4Float set(Point4Float point)

Specified by:

set in interface com.github.tommyettinger.crux.PointN<Point4Float>

set

public Point4Float set(com.github.tommyettinger.crux.Point4<?> point)

sub

public Point4Float sub(Point4Float point)

Specified by:

sub in interface com.github.tommyettinger.crux.PointN<Point4Float>

sub

public Point4Float sub(com.github.tommyettinger.crux.Point4<?> point)

subtract

public Point4Float subtract(com.github.tommyettinger.crux.Point4<?> point)

add

public Point4Float add(Point4Float point)

Specified by:

add in interface com.github.tommyettinger.crux.PointN<Point4Float>

add

public Point4Float add(com.github.tommyettinger.crux.Point4<?> point)

scl

public Point4Float scl(Point4Float point)

Specified by:

scl in interface com.github.tommyettinger.crux.PointN<Point4Float>

scl

public Point4Float scl(com.github.tommyettinger.crux.Point4<?> point)

scale

public Point4Float scale(com.github.tommyettinger.crux.Point4<?> point)

mul

public Point4Float mul(Point4Float point)

mul

public Point4Float mul(com.github.tommyettinger.crux.Point4<?> point)

multiply

public Point4Float multiply(com.github.tommyettinger.crux.Point4<?> point)

div

public Point4Float div(Point4Float point)

Specified by:

div in interface com.github.tommyettinger.crux.PointN<Point4Float>

div

public Point4Float div(com.github.tommyettinger.crux.Point4<?> point)

divide

public Point4Float divide(com.github.tommyettinger.crux.Point4<?> point)

dst2

public float dst2(Point4Float point)

Specified by:

dst2 in interface com.github.tommyettinger.crux.PointN<Point4Float>

dst2

public float dst2(com.github.tommyettinger.crux.Point4<?> point)

distance

public float distance(com.github.tommyettinger.crux.Point4<?> point)

distanceSquared

public float distanceSquared(com.github.tommyettinger.crux.Point4<?> point)

setZero

public Point4Float setZero()

Specified by:

setZero in interface com.github.tommyettinger.crux.PointN<Point4Float>

x

public float x()

Specified by:

x in interface com.github.tommyettinger.crux.Point4<Point4Float>

x

public Point4Float x(float next)

Specified by:

x in interface com.github.tommyettinger.crux.Point4<Point4Float>

y

public float y()

Specified by:

y in interface com.github.tommyettinger.crux.Point4<Point4Float>

y

public Point4Float y(float next)

Specified by:

y in interface com.github.tommyettinger.crux.Point4<Point4Float>

z

public float z()

Specified by:

z in interface com.github.tommyettinger.crux.Point4<Point4Float>

z

public Point4Float z(float next)

Specified by:

z in interface com.github.tommyettinger.crux.Point4<Point4Float>

w

public float w()

Specified by:

w in interface com.github.tommyettinger.crux.Point4<Point4Float>

w

public Point4Float w(float next)

Specified by:

w in interface com.github.tommyettinger.crux.Point4<Point4Float>

set

public Point4Float set(float x,
 float y,
 float z,
 float w)

Specified by:

set in interface com.github.tommyettinger.crux.Point4<Point4Float>

nor

public Point4Float nor()

Specified by:

nor in interface com.github.tommyettinger.crux.PointN<Point4Float>

normalize

public Point4Float normalize()

add

public Point4Float add(float x,
 float y,
 float z,
 float w)

sub

public Point4Float sub(float x,
 float y,
 float z,
 float w)

subtract

public Point4Float subtract(float x,
 float y,
 float z,
 float w)

plus

public Point4Float plus(float scalar)

Specified by:

plus in interface com.github.tommyettinger.crux.PointN<Point4Float>

minus

public Point4Float minus(float scalar)

Specified by:

minus in interface com.github.tommyettinger.crux.PointN<Point4Float>

times

public Point4Float times(float scalar)

Specified by:

times in interface com.github.tommyettinger.crux.PointN<Point4Float>

scale

public Point4Float scale(float scalar)

scl

public Point4Float scl(float x,
 float y,
 float z,
 float w)

scale

public Point4Float scale(float x,
 float y,
 float z,
 float w)

mul

public Point4Float mul(float scalar)

Multiplies each component of this by the given scalar, in-place, and returns this. This is an alias for times(float).

Parameters:

scalar - a float that will be multiplied with each component

Returns:

this, for chaining

multiply

public Point4Float multiply(float scalar)

Multiplies each component of this by the given scalar, in-place, and returns this. This is an alias for times(float).

Parameters:

scalar - a float that will be multiplied with each component

Returns:

this, for chaining

mul

public Point4Float mul(float x,
 float y,
 float z,
 float w)

Multiplies each component of this by the corresponding scalar, in-place, and returns this. This is an alias for scl(float, float, float, float).

Parameters:

x - a float that will be multiplied with x

y - a float that will be multiplied with y

Returns:

this, for chaining

multiply

public Point4Float multiply(float x,
 float y,
 float z,
 float w)

Multiplies each component of this by the corresponding scalar, in-place, and returns this. This is an alias for scl(float, float, float, float).

Parameters:

x - a float that will be multiplied with x

y - a float that will be multiplied with y

Returns:

this, for chaining

divide

public Point4Float divide(float scalar)

Specified by:

divide in interface com.github.tommyettinger.crux.PointN<Point4Float>

addProduct

public Point4Float addProduct(com.github.tommyettinger.crux.Point4<?> vec,
 float scalar)

mulAdd

public Point4Float mulAdd(com.github.tommyettinger.crux.Point4<?> vec,
 float scalar)

mulAdd

public Point4Float mulAdd(com.github.tommyettinger.crux.Point4<?> vec,
 com.github.tommyettinger.crux.Point4<?> mulVec)

addProduct

public Point4Float addProduct(com.github.tommyettinger.crux.Point4<?> vec,
 com.github.tommyettinger.crux.Point4<?> mulVec)

limit

public Point4Float limit(float limit)

limit2

public Point4Float limit2(float limit2)

limitSquared

public Point4Float limitSquared(float limit2)

clampLength

public Point4Float clampLength(float min,
 float max)

setLength

public Point4Float setLength(float len)

setLength2

public Point4Float setLength2(float len2)

dot

public float dot(com.github.tommyettinger.crux.Point4<?> other)

dot

public static float dot(com.github.tommyettinger.crux.Point4<?> a,
 com.github.tommyettinger.crux.Point4<?> b)

lerp

public Point4Float lerp(com.github.tommyettinger.crux.Point4<?> target,
 float alpha)

Description copied from interface: PointNFloat

Linear-interpolates from this point toward target, moving a distance proportional to alpha and changing this point in-place if possible. If this point is not PointN.mutable(), this will return a new or pooled point. The alpha is expected to be in the 0 to 1 range, inclusive.

Specified by:

lerp in interface com.github.tommyettinger.crux.PointNFloat<Point4Float, com.github.tommyettinger.crux.Point4<?>>

Specified by:

lerp in interface PointNFloat<Point4Float, com.github.tommyettinger.crux.Point4<?>>

Parameters:

target - any point with the same dimension to move toward

alpha - between 0 and 1, inclusive

Returns:

this point after modifications, if possible, or a new PointNFloat if this is immutable

interpolate

public Point4Float interpolate(com.github.tommyettinger.crux.Point4<?> target,
 float alpha,
 com.github.tommyettinger.digital.Interpolations.Interpolator interpolation)

Description copied from interface: PointNFloat

Calls PointNFloat.lerp(PointN, float) with the alpha determined by the given interpolation. Simply returns lerp(target, interpolation.apply(alpha)) .

Specified by:

interpolate in interface PointNFloat<Point4Float, com.github.tommyettinger.crux.Point4<?>>

Parameters:

target - any point with the same dimension to move toward

alpha - between 0 and 1, inclusive

interpolation - an Interpolator from digital, such as Interpolations.smooth

Returns:

this point after modifications, if possible, or a new PointNFloat if this is immutable

slerpGeometric

public Point4Float slerpGeometric(Point4Float target,
 float alpha)

setToRandomDirection

public Point4Float setToRandomDirection(Random random)

Description copied from interface: PointNFloat

Sets this PointNFloat to a randomly chosen unit vector. The exact algorithm is expected to vary between dimensions. In 2D, for instance, it is sufficient to get a random float between 0 and 1, and call TrigTools.cosTurns(float) and TrigTools.sinTurns(float) to get x and y. In higher dimensions, this gets more complex. A solution that works for any dimension, but is only the best option for 4D and up, is to assign to each component a normal-distributed float using Distributor.probitF(float) with random inputs, then normalize the PointNFloat with PointN.nor().

Specified by:

setToRandomDirection in interface PointNFloat<Point4Float, com.github.tommyettinger.crux.Point4<?>>

Parameters:

random - any Random or subclass thereof

Returns:

this point after modifications, if possible, or a new PointNFloat if this is immutable

clampEach

public Point4Float clampEach(float min,
 float max)

For each component, this clamps it between min and max, inclusive.

Parameters:

min - the minimum value allowable for any component, inclusive

max - the maximum value allowable for any component, inclusive

Returns:

this, after modifications

fract

public Point4Float fract()

Sets each component so it only has a fractional value, by subtracting the floor from each component. This produces a non-negative float for each component, between 0.0 inclusive and 1.0 exclusive, unless a component is outside the safe range for MathTools.floor(float) (-16384.0 at the lowest).

The result of fract() for a component with a value of  1.25 will be 0.25 .
The result of fract() for a component with a value of -1.25 will be 0.75 .

Returns:

this, after modifications

fractional

public Point4Float fractional()

inverse

public Point4Float inverse()

Assigns to each component of this point 1f divided by its original value. If a component is 0.0f, its value after this will be positive infinity. If a component is -0.0f, its value after this will be negative infinity.

Specified by:

inverse in interface com.github.tommyettinger.crux.PointNFloat<Point4Float, com.github.tommyettinger.crux.Point4<?>>

Specified by:

inverse in interface PointNFloat<Point4Float, com.github.tommyettinger.crux.Point4<?>>

Returns:

1f divided by this point, assigned in-place to this

get

public float get(int index)

Gets the component at the specified index. Kotlin-compatible using square-bracket indexing.

Specified by:

get in interface com.github.tommyettinger.crux.PointNFloat<Point4Float, com.github.tommyettinger.crux.Point4<?>>

Specified by:

get in interface PointNFloat<Point4Float, com.github.tommyettinger.crux.Point4<?>>

Parameters:

index - which component to get, in order

Returns:

the component

setAt

public Point4Float setAt(int index,
 float value)

Sets the component at the specified index to the specified value.

Specified by:

setAt in interface com.github.tommyettinger.crux.PointNFloat<Point4Float, com.github.tommyettinger.crux.Point4<?>>

Specified by:

setAt in interface PointNFloat<Point4Float, com.github.tommyettinger.crux.Point4<?>>

Parameters:

index - which component to set, in order

value - the value to assign at index

Returns:

this, for chaining

equals

public boolean equals(Object o)

Specified by:

equals in interface com.github.tommyettinger.ds.PrimitiveCollection<Float>

Overrides:

equals in class Object

hashCode

public int hashCode()

Specified by:

hashCode in interface com.github.tommyettinger.ds.PrimitiveCollection<Float>

Overrides:

hashCode in class Object

toString

public String toString()

Converts this Point5Float to a string in the format (x,y,z,w).

Overrides:

toString in class Object

Returns:

a string representation of this object.

fromString

public Point4Float fromString(String s)

Sets this Point5Float to the value represented by the specified string according to the format of toString().

Parameters:

s - the string.

Returns:

this point for chaining

add

public boolean add(float c)

Not supported; this collection is fixed-size.

Specified by:

add in interface com.github.tommyettinger.ds.PrimitiveCollection.OfFloat

Parameters:

c - ignored

Returns:

never returns

Throws:

UnsupportedOperationException - always

remove

public boolean remove(float c)

Not supported; this collection is fixed-size.

Specified by:

remove in interface com.github.tommyettinger.ds.PrimitiveCollection.OfFloat

Parameters:

c - ignored

Returns:

never returns

Throws:

UnsupportedOperationException - always

clear

public void clear()

Not supported; this collection is fixed-size.

Specified by:

clear in interface com.github.tommyettinger.ds.PrimitiveCollection<Float>

Throws:

UnsupportedOperationException - always

contains

public boolean contains(float c)

Compares c with the components of this collection using ==; if any are considered equal, this returns true.

Specified by:

contains in interface com.github.tommyettinger.ds.PrimitiveCollection.OfFloat

Parameters:

c - a float to be compared using ==

Returns:

true if any component of this collection is equal to c via == comparison

size

public int size()

Specified by:

size in interface com.github.tommyettinger.ds.PrimitiveCollection<Float>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface com.github.tommyettinger.ds.PrimitiveCollection<Float>

notEmpty

public boolean notEmpty()

Specified by:

notEmpty in interface com.github.tommyettinger.ds.PrimitiveCollection<Float>

iterator

public PointNFloatIterator iterator()

Specified by:

iterator in interface com.github.tommyettinger.ds.PrimitiveCollection<Float>

Specified by:

iterator in interface com.github.tommyettinger.ds.PrimitiveCollection.OfFloat