This class implements a vector with four elements. More...

Public Types
typedef T	Type
	Definition of the used data type. More...

Public Member Functions
	VectorT4 ()=default
	Creates a new 2D vector with zeros as default values. More...

	VectorT4 (const T &x, const T &y, const T &z, const T &w) noexcept
	Creates a new 4D vector with four given elements. More...

	VectorT4 (const VectorT3< T > &vector) noexcept
	Creates a new homogeneous 4D vector by a 3D vector. More...

	VectorT4 (const VectorT3< T > &vector, const T &w) noexcept
	Creates a new 4D vector by a 3D vector and a following scalar. More...

	VectorT4 (const T *valueArray) noexcept
	Creates a new 4D vector with a given array of elements. More...

	VectorT4 (const VectorT4< T > &vector) noexcept
	Copies a vector. More...

template<typename U >
	VectorT4 (const VectorT4< U > &vector) noexcept
	Copies a vector with different element data type than T. More...

VectorT4< T >	normalized () const
	Returns the normalized vector. More...

VectorT4< T >	normalizedOrZero () const
	Returns the normalized vector. More...

VectorT4< T >	normalizedOrValue (const VectorT4< T > &value) const
	Returns the normalized vector. More...

bool	normalize ()
	Normalizes this vector. More...

T	length () const
	Returns the length of the vector. More...

T	sqr () const
	Returns the square of the vector length. More...

T	angle (const VectorT4< T > &right) const
	Returns the angle between this vector and a second vectors. More...

bool	isParallel (const VectorT4< T > &right) const
	Returns whether two vectors are parallel. More...

bool	isOrthogonal (const VectorT4< T > &right) const
	Returns whether two vectors are orthogonal. More...

const T &	x () const noexcept
	Returns the x value. More...

T &	x () noexcept
	Returns the x value. More...

const T &	y () const noexcept
	Returns the y value. More...

T &	y () noexcept
	Returns the y value. More...

const T &	z () const noexcept
	Returns the z value. More...

T &	z () noexcept
	Returns the z value. More...

const T &	w () const noexcept
	Returns the w value. More...

T &	w () noexcept
	Returns the w value. More...

VectorT2< T >	xy () const noexcept
	Returns the x and y component of the vector as new 2D vector. More...

VectorT3< T >	xyz () const noexcept
	Returns the x, y and z component of the vector as new 3D vector. More...

const T *	data () const noexcept
	Returns an pointer to the vector elements. More...

T *	data () noexcept
	Returns an pointer to the vector elements. More...

bool	isNull () const
	Returns whether this vector is a null vector up to a small epsilon. More...

bool	isUnit (const T eps=NumericT< T >::eps()) const
	Returns whether this vector is a unit vector (whether the vector has the length 1). More...

bool	isEqual (const VectorT4< T > &vector, const T eps) const
	Returns whether two vectors are equal up to a specified epsilon. More...

VectorT4< T > &	operator= (const VectorT4< T > &vector)
	Copy assigns a vector. More...

bool	operator== (const VectorT4< T > &vector) const
	Returns whether two vectors are identical up to a small epsilon. More...

bool	operator!= (const VectorT4< T > &vector) const
	Returns whether two vectors are not identical up to a small epsilon. More...

VectorT4< T >	operator+ (const VectorT4< T > &vector) const
	Adds two vectors. More...

VectorT4< T > &	operator+= (const VectorT4< T > &vector)
	Adds and assigns two vectors. More...

VectorT4< T >	operator- (const VectorT4< T > &vector) const
	Subtracts two vectors. More...

VectorT4< T > &	operator-= (const VectorT4< T > &vector)
	Subtracts and assigns two vectors. More...

VectorT4< T >	operator- () const
	Returns the negated vector. More...

T	operator* (const VectorT4< T > &vector) const
	Returns the dot product of two vectors. More...

VectorT4< T >	operator* (const T &value) const
	Multiplies this vector with a scalar. More...

VectorT4< T > &	operator*= (const T &value)
	Multiplies and assigns this vector with a scalar. More...

VectorT4< T >	operator/ (const T &value) const
	Divides this vector by a scalar. More...

VectorT4< T > &	operator/= (const T &value)
	Divides and assigns this vector by a scalar. More...

bool	operator< (const VectorT4< T > &vector) const
	Compares two vector objects and returns whether the left vector represents a smaller value than the right vector. More...

const T &	operator[] (const unsigned int index) const noexcept
	Element access operator. More...

T &	operator[] (const unsigned int index) noexcept
	Element access operator. More...

const T &	operator() (const unsigned int index) const noexcept
	Element access operator. More...

T &	operator() (const unsigned int index) noexcept
	Element access operator. More...

const T *	operator() () const noexcept
	Access operator. More...

T *	operator() () noexcept
	Access operator. More...

size_t	operator() (const VectorT4< T > &vector) const
	Hash function. More...

std::vector< VectorT4< float > >	vectors2vectors (std::vector< VectorT4< float >> &&vectors)

std::vector< VectorT4< double > >	vectors2vectors (std::vector< VectorT4< double >> &&vectors)

std::vector< VectorT4< float > >	vectors2vectors (const std::vector< VectorT4< float >> &vectors)

std::vector< VectorT4< double > >	vectors2vectors (const std::vector< VectorT4< double >> &vectors)

Static Public Member Functions
template<typename U >
static std::vector< VectorT4< T > >	vectors2vectors (std::vector< VectorT4< U >> &&vectors)
	Converts vectors with specific data type to vectors with different data type. More...

template<typename U >
static std::vector< VectorT4< T > >	vectors2vectors (const std::vector< VectorT4< U >> &vectors)
	Converts vectors with specific data type to vectors with different data type. More...

template<typename U >
static std::vector< VectorT4< T > >	vectors2vectors (const VectorT4< U > *vectors, const size_t size)
	Converts vectors with specific data type to vectors with different data type. More...

Protected Attributes
T	values_ [4] = {T(0), T(0), T(0), T(0)}
	The four values of the vector, with element order x, y, z, w. More...

Detailed Description

template<typename T>
class Ocean::VectorT4< T >

This class implements a vector with four elements.

The element order is: (x, y, z, w).

Template Parameters

T	Data type of the vector elements.

See also: Vector4, VectorF4, VectorD4.

Member Typedef Documentation

◆ Type

template<typename T >

typedef T Ocean::VectorT4< T >::Type

Definition of the used data type.

Constructor & Destructor Documentation

◆ VectorT4() [1/7]

template<typename T >

Ocean::VectorT4< T >::VectorT4 ( )

default

Creates a new 2D vector with zeros as default values.

◆ VectorT4() [2/7]

template<typename T >

Ocean::VectorT4< T >::VectorT4	(	const T &	x,
		const T &	y,
		const T &	z,
		const T &	w
	)

inlinenoexcept

Creates a new 4D vector with four given elements.

Parameters

x	X value
y	Y value
z	Z value
w	W value

◆ VectorT4() [3/7]

template<typename T >

Ocean::VectorT4< T >::VectorT4 ( const VectorT3< T > & vector )

inlineexplicitnoexcept

Creates a new homogeneous 4D vector by a 3D vector.

The fourth parameter will be 1.

Parameters

vector The vector for the first three elements

◆ VectorT4() [4/7]

template<typename T >

Ocean::VectorT4< T >::VectorT4	(	const VectorT3< T > &	vector,
		const T &	w
	)

inlinenoexcept

Creates a new 4D vector by a 3D vector and a following scalar.

Parameters

vector	The vector for the first three elements
w	Scalar value for the last element

◆ VectorT4() [5/7]

template<typename T >

Ocean::VectorT4< T >::VectorT4 ( const T * valueArray )

inlineexplicitnoexcept

Creates a new 4D vector with a given array of elements.

Parameters

valueArray Array with at least four elements

◆ VectorT4() [6/7]

template<typename T >

Ocean::VectorT4< T >::VectorT4 ( const VectorT4< T > & vector )

inlinenoexcept

Copies a vector.

Parameters

vector 4D vector that is copied

◆ VectorT4() [7/7]

template<typename T >

template<typename U >

Ocean::VectorT4< T >::VectorT4 ( const VectorT4< U > & vector )

inlineexplicitnoexcept

Copies a vector with different element data type than T.

Parameters

vector The 4D vector to copy

Template Parameters

U	The element data type of the second vector

Member Function Documentation

◆ angle()

template<typename T >

T Ocean::VectorT4< T >::angle ( const VectorT4< T > & right ) const

Returns the angle between this vector and a second vectors.

Beware: This vector must not be zero.
Beware: This function does not throw an exception if one or both vectors are zero.
In case, the angle cannot be determined -1 will be returned.

Parameters

right Second vector, must not be zero

Returns: Angle between both vectors in radian, with range [0, PI], -1 in case of an error

◆ data() [1/2]

template<typename T >

const T * Ocean::VectorT4< T >::data

inlinenoexcept

Returns an pointer to the vector elements.

Returns: Pointer to elements

◆ data() [2/2]

template<typename T >

T * Ocean::VectorT4< T >::data

inlinenoexcept

Returns an pointer to the vector elements.

Returns: Pointer to elements

◆ isEqual()

template<typename T >

bool Ocean::VectorT4< T >::isEqual	(	const VectorT4< T > &	vector,
		const T	eps
	)		const

inline

Returns whether two vectors are equal up to a specified epsilon.

Parameters

vector	Second vector
eps	Epsilon to be used, with range [0, infinity)

Returns: True, if so

◆ isNull()

template<typename T >

bool Ocean::VectorT4< T >::isNull

inline

Returns whether this vector is a null vector up to a small epsilon.

Returns: True, if so

◆ isOrthogonal()

template<typename T >

bool Ocean::VectorT4< T >::isOrthogonal ( const VectorT4< T > & right ) const

Returns whether two vectors are orthogonal.

A zero vector will not be orthogonal.

Parameters

right The right vector

Returns: True, if so

◆ isParallel()

template<typename T >

bool Ocean::VectorT4< T >::isParallel ( const VectorT4< T > & right ) const

Returns whether two vectors are parallel.

A zero vector will not be parallel.

Parameters

right The right vector

Returns: True, if so

◆ isUnit()

template<typename T >

bool Ocean::VectorT4< T >::isUnit ( const T eps = NumericT<T>::eps() ) const

inline

Returns whether this vector is a unit vector (whether the vector has the length 1).

Parameters

eps	Epsilon to be used, with range [0, infinity)

Returns: True, if so

◆ length()

template<typename T >

T Ocean::VectorT4< T >::length

inline

Returns the length of the vector.

Returns: Vector length

◆ normalize()

template<typename T >

bool Ocean::VectorT4< T >::normalize

inline

Normalizes this vector.

Returns: True, if the vector could be normalized

◆ normalized()

template<typename T >

VectorT4< T > Ocean::VectorT4< T >::normalized

inline

Returns the normalized vector.

Beware: This function does not throw an exception if this vector cannot be normalized.
Thus, ensure that this vector is not zero before calling this function.
Or even better, use different normalization functions like: normalizedOrZero(), normalizedOrValue(), or normalize().
In case, the vector cannot be normalized, an uninitialized vector will be returned (due to performance reasons).

Returns: This vector as unit vector (vector with length 1)

See also: normalizedOrZero(), normalizedOrValue(), normalize().

◆ normalizedOrValue()

template<typename T >

VectorT4< T > Ocean::VectorT4< T >::normalizedOrValue ( const VectorT4< T > & value ) const

inline

Returns the normalized vector.

If this vector cannot be normalized the given vector is returned.

Parameters

value Vector that will be returned if the vector cannot be normalized

Returns: Vector with length 1

◆ normalizedOrZero()

template<typename T >

VectorT4< T > Ocean::VectorT4< T >::normalizedOrZero

inline

Returns the normalized vector.

If this vector cannot be normalized the zero vector is returned.

Returns: Vector with length 1

◆ operator!=()

template<typename T >

bool Ocean::VectorT4< T >::operator!= ( const VectorT4< T > & vector ) const

inline

Returns whether two vectors are not identical up to a small epsilon.

Parameters

vector Right vector

Returns: True, if so

◆ operator()() [1/5]

template<typename T >

const T * Ocean::VectorT4< T >::operator()

inlinenoexcept

Access operator.

Returns: Pointer to the elements

◆ operator()() [2/5]

template<typename T >

T * Ocean::VectorT4< T >::operator()

inlinenoexcept

Access operator.

Returns: Pointer to the elements

◆ operator()() [3/5]

template<typename T >

const T & Ocean::VectorT4< T >::operator() ( const unsigned int index ) const

inlinenoexcept

Element access operator.

Parameters

index The index of the element to access, with range [0, 3]

Returns: Element of the vector

◆ operator()() [4/5]

template<typename T >

T & Ocean::VectorT4< T >::operator() ( const unsigned int index )

inlinenoexcept

Element access operator.

Parameters

index The index of the element to access, with range [0, 3]

Returns: Element of the vector

◆ operator()() [5/5]

template<typename T >

size_t Ocean::VectorT4< T >::operator() ( const VectorT4< T > & vector ) const

inline

Hash function.

Parameters

vector The vector for which the hash value will be determined

Returns: The resulting hash value

◆ operator*() [1/2]

template<typename T >

VectorT4< T > Ocean::VectorT4< T >::operator* ( const T & value ) const

inline

Multiplies this vector with a scalar.

Parameters

value Scalar value

Returns: Resulting vector

◆ operator*() [2/2]

template<typename T >

T Ocean::VectorT4< T >::operator* ( const VectorT4< T > & vector ) const

inline

Returns the dot product of two vectors.

Parameters

vector Right vector

Returns: Dot product

◆ operator*=()

template<typename T >

VectorT4< T > & Ocean::VectorT4< T >::operator*= ( const T & value )

inline

Multiplies and assigns this vector with a scalar.

Parameters

value Scalar value

Returns: Reference to this vector

◆ operator+()

template<typename T >

VectorT4< T > Ocean::VectorT4< T >::operator+ ( const VectorT4< T > & vector ) const

inline

Adds two vectors.

Parameters

vector Right vector

Returns: Sum vector

◆ operator+=()

template<typename T >

VectorT4< T > & Ocean::VectorT4< T >::operator+= ( const VectorT4< T > & vector )

inline

Adds and assigns two vectors.

Parameters

vector Right vector

Returns: Reference to this vector

◆ operator-() [1/2]

template<typename T >

VectorT4< T > Ocean::VectorT4< T >::operator-

inline

Returns the negated vector.

Returns: Negated vector

◆ operator-() [2/2]

template<typename T >

VectorT4< T > Ocean::VectorT4< T >::operator- ( const VectorT4< T > & vector ) const

inline

Subtracts two vectors.

Parameters

vector Right vector

Returns: Difference vector

◆ operator-=()

template<typename T >

VectorT4< T > & Ocean::VectorT4< T >::operator-= ( const VectorT4< T > & vector )

inline

Subtracts and assigns two vectors.

Parameters

vector Right vector

Returns: Reference to this vector

◆ operator/()

template<typename T >

VectorT4< T > Ocean::VectorT4< T >::operator/ ( const T & value ) const

inline

Divides this vector by a scalar.

Beware: This function does not throw an exception if the given value is zero.
Thus, ensure that given value is not zero before calling this function.
In case, the given value is zero, the result is undefined.

Parameters

value Scalar value to be used as denominator, must not be zero

Returns: Resulting vector

◆ operator/=()

template<typename T >

VectorT4< T > & Ocean::VectorT4< T >::operator/= ( const T & value )

inline

Divides and assigns this vector by a scalar.

Beware: This function does not throw an exception if the given value is zero.
Thus, ensure that given value is not zero before calling this function.
In case, the given value is zero, the result is undefined.

Parameters

value Scalar value to be used as denominator, must not be zero

Returns: Reference to this vector

◆ operator<()

template<typename T >

bool Ocean::VectorT4< T >::operator< ( const VectorT4< T > & vector ) const

inline

Compares two vector objects and returns whether the left vector represents a smaller value than the right vector.

First the first component of both vectors are compared, if these values are equal then the next components are compares and so on.

Parameters

vector The second vector to compare

Returns: True, if so

◆ operator=()

template<typename T >

VectorT4< T > & Ocean::VectorT4< T >::operator= ( const VectorT4< T > & vector )

inline

Copy assigns a vector.

Parameters

vector 4D vector that is copied

◆ operator==()

template<typename T >

bool Ocean::VectorT4< T >::operator== ( const VectorT4< T > & vector ) const

inline

Returns whether two vectors are identical up to a small epsilon.

Parameters

vector Right vector

Returns: True, if so

◆ operator[]() [1/2]

template<typename T >

const T & Ocean::VectorT4< T >::operator[] ( const unsigned int index ) const

inlinenoexcept

Element access operator.

Parameters

index The index of the element to access, with range [0, 3]

Returns: Element of the vector

◆ operator[]() [2/2]

template<typename T >

T & Ocean::VectorT4< T >::operator[] ( const unsigned int index )

inlinenoexcept

Element access operator.

Parameters

index The index of the element to access, with range [0, 3]

Returns: Element of the vector

◆ sqr()

template<typename T >

T Ocean::VectorT4< T >::sqr

inline

Returns the square of the vector length.

Returns: Square of vector length

◆ vectors2vectors() [1/7]

std::vector< VectorT4< double > > Ocean::VectorT4< double >::vectors2vectors ( const std::vector< VectorT4< double >> & vectors )

inline

◆ vectors2vectors() [2/7]

std::vector< VectorT4< float > > Ocean::VectorT4< float >::vectors2vectors ( const std::vector< VectorT4< float >> & vectors )

inline

◆ vectors2vectors() [3/7]

template<typename T >

template<typename U >

std::vector< VectorT4< T > > Ocean::VectorT4< T >::vectors2vectors ( const std::vector< VectorT4< U >> & vectors )

inlinestatic

Converts vectors with specific data type to vectors with different data type.

Parameters

vectors The vectors to convert

Returns: The converted vectors

Template Parameters

U	The element data type of the vectors to convert

◆ vectors2vectors() [4/7]

template<typename T >

template<typename U >

std::vector< VectorT4< T > > Ocean::VectorT4< T >::vectors2vectors	(	const VectorT4< U > *	vectors,
		const size_t	size
	)

inlinestatic

Converts vectors with specific data type to vectors with different data type.

Parameters

vectors	The vectors to convert
size	The number of vector to convert

Returns: The converted vectors

Template Parameters

U	The element data type of the vectors to convert

◆ vectors2vectors() [5/7]

std::vector< VectorT4< double > > Ocean::VectorT4< double >::vectors2vectors ( std::vector< VectorT4< double >> && vectors )

inline

◆ vectors2vectors() [6/7]

std::vector< VectorT4< float > > Ocean::VectorT4< float >::vectors2vectors ( std::vector< VectorT4< float >> && vectors )

inline

◆ vectors2vectors() [7/7]

template<typename T >

template<typename U >

std::vector< VectorT4< T > > Ocean::VectorT4< T >::vectors2vectors ( std::vector< VectorT4< U >> && vectors )

inlinestatic

Converts vectors with specific data type to vectors with different data type.

Parameters

vectors The vectors to convert

Returns: The converted vectors

Template Parameters

U	The element data type of the vectors to convert

◆ w() [1/2]

template<typename T >

const T & Ocean::VectorT4< T >::w

inlinenoexcept

Returns the w value.

Returns: W value

◆ w() [2/2]

template<typename T >

T & Ocean::VectorT4< T >::w

inlinenoexcept

Returns the w value.

Returns: W value

◆ x() [1/2]

template<typename T >

const T & Ocean::VectorT4< T >::x

inlinenoexcept

Returns the x value.

Returns: X value

◆ x() [2/2]

template<typename T >

T & Ocean::VectorT4< T >::x

inlinenoexcept

Returns the x value.

Returns: X value

◆ xy()

template<typename T >

VectorT2< T > Ocean::VectorT4< T >::xy

inlinenoexcept

Returns the x and y component of the vector as new 2D vector.

Returns: New 2D vector

◆ xyz()

template<typename T >

VectorT3< T > Ocean::VectorT4< T >::xyz

inlinenoexcept

Returns the x, y and z component of the vector as new 3D vector.

Returns: New 3D vector

◆ y() [1/2]

template<typename T >

const T & Ocean::VectorT4< T >::y

inlinenoexcept

Returns the y value.

Returns: Y value

◆ y() [2/2]

template<typename T >

T & Ocean::VectorT4< T >::y

inlinenoexcept

Returns the y value.

Returns: Y value

◆ z() [1/2]

template<typename T >

const T & Ocean::VectorT4< T >::z

inlinenoexcept

Returns the z value.

Returns: Z value

◆ z() [2/2]

template<typename T >

T & Ocean::VectorT4< T >::z

inlinenoexcept

Returns the z value.

Returns: Z value

Field Documentation

◆ values_

template<typename T >

T Ocean::VectorT4< T >::values_[4] = {T(0), T(0), T(0), T(0)}

protected

The four values of the vector, with element order x, y, z, w.

The documentation for this class was generated from the following file:

Vector4.h

Public Types

Public Member Functions

Static Public Member Functions

Protected Attributes

Detailed Description

template<typename T> class Ocean::VectorT4< T >

Member Typedef Documentation

◆ Type

Constructor & Destructor Documentation

◆ VectorT4() [1/7]

◆ VectorT4() [2/7]

◆ VectorT4() [3/7]

◆ VectorT4() [4/7]

◆ VectorT4() [5/7]

◆ VectorT4() [6/7]

◆ VectorT4() [7/7]

Member Function Documentation

◆ angle()

◆ data() [1/2]

◆ data() [2/2]

◆ isEqual()

◆ isNull()

◆ isOrthogonal()

◆ isParallel()

◆ isUnit()

◆ length()

◆ normalize()

◆ normalized()

◆ normalizedOrValue()

◆ normalizedOrZero()

◆ operator!=()

◆ operator()() [1/5]

◆ operator()() [2/5]

◆ operator()() [3/5]

◆ operator()() [4/5]

◆ operator()() [5/5]

◆ operator*() [1/2]

◆ operator*() [2/2]

◆ operator*=()

◆ operator+()

◆ operator+=()

◆ operator-() [1/2]

◆ operator-() [2/2]

◆ operator-=()

◆ operator/()

◆ operator/=()

◆ operator<()

◆ operator=()

◆ operator==()

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ sqr()

◆ vectors2vectors() [1/7]

◆ vectors2vectors() [2/7]

◆ vectors2vectors() [3/7]

◆ vectors2vectors() [4/7]

◆ vectors2vectors() [5/7]

◆ vectors2vectors() [6/7]

◆ vectors2vectors() [7/7]

◆ w() [1/2]

◆ w() [2/2]

◆ x() [1/2]

◆ x() [2/2]

◆ xy()

◆ xyz()

◆ y() [1/2]

◆ y() [2/2]

◆ z() [1/2]

◆ z() [2/2]

Field Documentation

◆ values_

template<typename T>
class Ocean::VectorT4< T >