Vector representing a point in four-dimensional space. More...

#include <ptems/vector.hpp>

Public Types
using	ConjugateType = BasicVector< typename std::conditional_t< is_complex_v< V >, V, std::complex< V > >, 4 >
	The type of the conjugate of the vector. More...

Public Member Functions
constexpr	BasicVector ()
	Construct a zero vector. More...

constexpr	BasicVector (V value)
	Construct a vector with all components equal to the specified value. More...

constexpr	BasicVector (V x, V y, V z, V t)
	Construct a vector for the specified point. More...

template<typename U >
constexpr	BasicVector (const BasicVector< U, 4 > rhs)
	Construct a vector by copying the specified vector. More...

template<typename U >
constexpr BasicVector &	operator= (const BasicVector< U, 4 > rhs)
	Copy the specified vector to this. More...

constexpr BasicVector &	operator= (V rhs)
	Set all components tof vector equal to a constants. More...

BasicVector< V, 3 >	XYZ () const
	Swizzle function to get 3D vector containing x, y & z components. More...

BasicVector< V, 3 >	XYT () const
	Swizzle function to get 3D vector containing x, y & t components. More...

BasicVector< V, 3 >	XZT () const
	Swizzle function to get 3D vector containing x, z & t components. More...

BasicVector< V, 3 >	YZT () const
	Swizzle function to get 3D vector containing y, z & t components. More...

BasicVector< V, 2 >	XY () const
	Swizzle function to get 2D vector containing x & y components. More...

BasicVector< V, 2 >	XZ () const
	Swizzle function to get 2D vector containing x & z components. More...

BasicVector< V, 2 >	XT () const
	Swizzle function to get 2D vector containing x & t components. More...

BasicVector< V, 2 >	YZ () const
	Swizzle function to get 2D vector containing y & z components. More...

BasicVector< V, 2 >	YT () const
	Swizzle function to get 2D vector containing y & t components. More...

BasicVector< V, 2 >	ZT () const
	Swizzle function to get 2D vector containing z & t components. More...

template<typename U >
constexpr BasicVector &	operator+= (const BasicVector< U, 4 > &rhs)
	Adds another 4D vector to this vector. More...

constexpr BasicVector &	operator+= (V rhs)
	Adds a scalar to this vector. More...

template<typename U >
constexpr BasicVector &	operator-= (const BasicVector< U, 4 > &rhs)
	Subtracts another 4D vector to this vector. More...

constexpr BasicVector &	operator-= (V rhs)
	Subtracts a scalar from this vector. More...

template<typename U >
constexpr BasicVector &	operator/= (U rhs)
	Divides all components of this vector by a constant. More...

template<typename U >
constexpr BasicVector &	operator/= (const BasicVector< U, 4 > &rhs)
	Performs elementwise division of all components of this vector by the other vector. More...

template<typename U >
constexpr BasicVector &	operator*= (U rhs)
	Multiplies all components of this vector by a constant. More...

template<typename U >
constexpr BasicVector &	operator*= (const BasicVector< U, 4 > &rhs)
	Performs elementwise multiplication of all components of this vector by the other vector. More...

constexpr BasicVector	operator- () const
	Returns the negated vector. More...

template<typename U >
constexpr std::common_type_t< V, U >	Dot (const BasicVector< U, 4 > &rhs) const
	Computes the dot product of this vector with the specified vector. More...

constexpr BasicVector &	Normalise ()
	Normalises the current vector. More...

constexpr BasicVector	Normalised () const
	Gets a new vector which is the normalised version of this vector. More...

constexpr V	operator[] (std::size_t i) const
	Gets a component of the vector by index. More...

constexpr V &	operator[] (std::size_t i)
	Gets a mutable reference to the component of the vector by index. More...

constexpr remove_complex_t< V >	Length () const
	Computes the length of the vector. More...

constexpr remove_complex_t< V >	LengthSquared () const
	Gets the square of the length of the vector. More...

ConjugateType	Conjugate () const
	Computes the complex conjugate of the vector. More...

BasicVector &	ConjugateOverwrite () const
	Overwrites the vector with its complex conjugate. More...

std::size_t	size () const
	Gets the number of elements in the vector. More...

Public Attributes
V	X
	The x-component of the vector. More...

V	Y
	The y-component of the vector. More...

V	Z
	The z-component of the vector. More...

V	T
	The 4th (t)-component of the vector. More...

Detailed Description

template<typename V>
struct ptems::BasicVector< V, 4 >

Vector representing a point in four-dimensional space.

Member Typedef Documentation

◆ ConjugateType

template<typename V >

using ptems::BasicVector< V, 4 >::ConjugateType = BasicVector<typename std::conditional_t<is_complex_v<V>, V, std::complex<V> >,4>

The type of the conjugate of the vector.

Will either be the same type if T is complex, otherwise a vector of std::complex<T>.

Constructor & Destructor Documentation

◆ BasicVector() [1/4]

template<typename V >

constexpr ptems::BasicVector< V, 4 >::BasicVector ( )

inlineconstexpr

Construct a zero vector.

◆ BasicVector() [2/4]

template<typename V >

constexpr ptems::BasicVector< V, 4 >::BasicVector ( V value )

inlineexplicitconstexpr

Construct a vector with all components equal to the specified value.

Parameters

value Value to fill in each component of the vector

◆ BasicVector() [3/4]

template<typename V >

constexpr ptems::BasicVector< V, 4 >::BasicVector	(	V	x,
		V	y,
		V	z,
		V	t
	)

inlineconstexpr

Construct a vector for the specified point.

Parameters

x	The x-component of the vector
y	The y-component of the vector
z	The z-component of the vector
t	The 4th component (t) of the vector

◆ BasicVector() [4/4]

template<typename V >

template<typename U >

constexpr ptems::BasicVector< V, 4 >::BasicVector ( const BasicVector< U, 4 > rhs )

inlineconstexpr

Construct a vector by copying the specified vector.

Template Parameters

U	Type of the vector to copy

Parameters

rhs	Vector to copy

Member Function Documentation

◆ Conjugate()

template<typename V >

ConjugateType ptems::BasicVector< V, 4 >::Conjugate ( ) const

inline

Computes the complex conjugate of the vector.

Returns: The complex conjugate of the vector

◆ ConjugateOverwrite()

template<typename V >

BasicVector& ptems::BasicVector< V, 4 >::ConjugateOverwrite ( ) const

inline

Overwrites the vector with its complex conjugate.

Returns: this

◆ Dot()

template<typename V >

template<typename U >

constexpr std::common_type_t<V,U> ptems::BasicVector< V, 4 >::Dot ( const BasicVector< U, 4 > & rhs ) const

inlineconstexpr

Computes the dot product of this vector with the specified vector.

Template Parameters

U	Type of the components of the vector to dot product with

Parameters

rhs	Vector to dot product with this vector

Returns: The result of the dot product

◆ Length()

template<typename V >

constexpr remove_complex_t<V> ptems::BasicVector< V, 4 >::Length ( ) const

inlineconstexpr

Computes the length of the vector.

Returns: The vector length.

◆ LengthSquared()

template<typename V >

constexpr remove_complex_t<V> ptems::BasicVector< V, 4 >::LengthSquared ( ) const

inlineconstexpr

Gets the square of the length of the vector.

Returns: The length squared.

◆ Normalise()

template<typename V >

constexpr BasicVector& ptems::BasicVector< V, 4 >::Normalise ( )

inlineconstexpr

Normalises the current vector.

Returns: Reference to this vector after normalisation.

◆ Normalised()

template<typename V >

constexpr BasicVector ptems::BasicVector< V, 4 >::Normalised ( ) const

inlineconstexpr

Gets a new vector which is the normalised version of this vector.

Returns: The normalised vector

◆ operator*=() [1/2]

template<typename V >

template<typename U >

constexpr BasicVector& ptems::BasicVector< V, 4 >::operator*= ( const BasicVector< U, 4 > & rhs )

inlineconstexpr

Performs elementwise multiplication of all components of this vector by the other vector.

Template Parameters

U	Type of the components of the vector to multiply by

Parameters

rhs	Vector to multiply by elementwise

Returns: Reference to this vector after multiplying by rhs

◆ operator*=() [2/2]

template<typename V >

template<typename U >

constexpr BasicVector& ptems::BasicVector< V, 4 >::operator*= ( U rhs )

inlineconstexpr

Multiplies all components of this vector by a constant.

Template Parameters

U	Type of right hand side

Parameters

rhs	Constant to multiple vector by

Returns: Reference to this vector after multiplying by rhs

◆ operator+=() [1/2]

template<typename V >

template<typename U >

constexpr BasicVector& ptems::BasicVector< V, 4 >::operator+= ( const BasicVector< U, 4 > & rhs )

inlineconstexpr

Adds another 4D vector to this vector.

Template Parameters

U	Type of the components of the vector to add

Parameters

rhs	Vector to add

Returns: Reference to this vector after adding rhs

◆ operator+=() [2/2]

template<typename V >

constexpr BasicVector& ptems::BasicVector< V, 4 >::operator+= ( V rhs )

inlineconstexpr

Adds a scalar to this vector.

Parameters

rhs	Scalar value to add

Returns: Reference to this vector after adding rhs

◆ operator-()

template<typename V >

constexpr BasicVector ptems::BasicVector< V, 4 >::operator- ( ) const

inlineconstexpr

Returns the negated vector.

Parameters

rhs	Vector to negate

Returns: The negated vector

◆ operator-=() [1/2]

template<typename V >

template<typename U >

constexpr BasicVector& ptems::BasicVector< V, 4 >::operator-= ( const BasicVector< U, 4 > & rhs )

inlineconstexpr

Subtracts another 4D vector to this vector.

Template Parameters

U	Type of the components of the vector to subtract

Parameters

rhs	Vector to subtract

Returns: Reference to this vector after subtracting rhs

◆ operator-=() [2/2]

template<typename V >

constexpr BasicVector& ptems::BasicVector< V, 4 >::operator-= ( V rhs )

inlineconstexpr

Subtracts a scalar from this vector.

Parameters

rhs	Scalar value to subtract

Returns: Reference to this vector after subtracting rhs

◆ operator/=() [1/2]

template<typename V >

template<typename U >

constexpr BasicVector& ptems::BasicVector< V, 4 >::operator/= ( const BasicVector< U, 4 > & rhs )

inlineconstexpr

Performs elementwise division of all components of this vector by the other vector.

Template Parameters

U	Type of the components of the vector to divide by

Parameters

rhs	Vector to divide by elementwise

Returns: Reference to this vector after dividing by rhs

◆ operator/=() [2/2]

template<typename V >

template<typename U >

constexpr BasicVector& ptems::BasicVector< V, 4 >::operator/= ( U rhs )

inlineconstexpr

Divides all components of this vector by a constant.

Template Parameters

U	Type of right hand side

Parameters

rhs	Constant to divide vector by

Returns: Reference to this vector after dividing by rhs

◆ operator=() [1/2]

template<typename V >

template<typename U >

constexpr BasicVector& ptems::BasicVector< V, 4 >::operator= ( const BasicVector< U, 4 > rhs )

inlineconstexpr

Copy the specified vector to this.

Template Parameters

U	Type of the vector to copy

Parameters

rhs	Vector to copy

◆ operator=() [2/2]

template<typename V >

constexpr BasicVector& ptems::BasicVector< V, 4 >::operator= ( V rhs )

inlineconstexpr

Set all components tof vector equal to a constants.

Parameters

rhs	Scalar to set vector to

◆ operator[]() [1/2]

template<typename V >

constexpr V& ptems::BasicVector< V, 4 >::operator[] ( std::size_t i )

inlineconstexpr

Gets a mutable reference to the component of the vector by index.

Parameters

i	The index of the component of the vector to get (must be 0, 1, 2, or 3).

Exceptions

std::out_of_range If i is not 0, 1, 2, or 3.

Returns: Mutable reference to the value at the specified component

◆ operator[]() [2/2]

template<typename V >

constexpr V ptems::BasicVector< V, 4 >::operator[] ( std::size_t i ) const

inlineconstexpr

Gets a component of the vector by index.

Parameters

i	The index of the component of the vector to get (must be 0, 1, 2, or 3).

Exceptions

std::out_of_range If i is not 0, 1, 2, or 3.

Returns: Value at the specified component

◆ size()

template<typename V >

std::size_t ptems::BasicVector< V, 4 >::size ( ) const

inline

Gets the number of elements in the vector.

Returns: 4

◆ XT()

template<typename V >

BasicVector<V, 2> ptems::BasicVector< V, 4 >::XT ( ) const

inline

Swizzle function to get 2D vector containing x & t components.

Returns: 2D vector containing X and T components

◆ XY()

template<typename V >

BasicVector<V, 2> ptems::BasicVector< V, 4 >::XY ( ) const

inline

Swizzle function to get 2D vector containing x & y components.

Returns: 2D vector containing X and Y components

◆ XYT()

template<typename V >

BasicVector<V, 3> ptems::BasicVector< V, 4 >::XYT ( ) const

inline

Swizzle function to get 3D vector containing x, y & t components.

Returns: 3D vector containing X, Y, and T components

◆ XYZ()

template<typename V >

BasicVector<V, 3> ptems::BasicVector< V, 4 >::XYZ ( ) const

inline

Swizzle function to get 3D vector containing x, y & z components.

Returns: 3D vector containing X, Y, and Z components

◆ XZ()

template<typename V >

BasicVector<V, 2> ptems::BasicVector< V, 4 >::XZ ( ) const

inline

Swizzle function to get 2D vector containing x & z components.

Returns: 2D vector containing X and Z components

◆ XZT()

template<typename V >

BasicVector<V, 3> ptems::BasicVector< V, 4 >::XZT ( ) const

inline

Swizzle function to get 3D vector containing x, z & t components.

Returns: 3D vector containing X, Z, and T components

◆ YT()

template<typename V >

BasicVector<V, 2> ptems::BasicVector< V, 4 >::YT ( ) const

inline

Swizzle function to get 2D vector containing y & t components.

Returns: 2D vector containing Y and T components

◆ YZ()

template<typename V >

BasicVector<V, 2> ptems::BasicVector< V, 4 >::YZ ( ) const

inline

Swizzle function to get 2D vector containing y & z components.

Returns: 2D vector containing Y and Z components

◆ YZT()

template<typename V >

BasicVector<V, 3> ptems::BasicVector< V, 4 >::YZT ( ) const

inline

Swizzle function to get 3D vector containing y, z & t components.

Returns: 3D vector containing Y, Z, and T components

◆ ZT()

template<typename V >

BasicVector<V, 2> ptems::BasicVector< V, 4 >::ZT ( ) const

inline

Swizzle function to get 2D vector containing z & t components.

Returns: 2D vector containing Z and T components

Member Data Documentation

◆ T

template<typename V >

V ptems::BasicVector< V, 4 >::T

The 4th (t)-component of the vector.

◆ X

template<typename V >

V ptems::BasicVector< V, 4 >::X

The x-component of the vector.

◆ Y

template<typename V >

V ptems::BasicVector< V, 4 >::Y

The y-component of the vector.

◆ Z

template<typename V >

V ptems::BasicVector< V, 4 >::Z

The z-component of the vector.

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

ptems/vector.hpp

Public Types

Public Member Functions

Public Attributes

Detailed Description

template<typename V> struct ptems::BasicVector< V, 4 >

Member Typedef Documentation

◆ ConjugateType

Constructor & Destructor Documentation

◆ BasicVector() [1/4]

◆ BasicVector() [2/4]

◆ BasicVector() [3/4]

◆ BasicVector() [4/4]

Member Function Documentation

◆ Conjugate()

◆ ConjugateOverwrite()

◆ Dot()

◆ Length()

◆ LengthSquared()

◆ Normalise()

◆ Normalised()

◆ operator*=() [1/2]

◆ operator*=() [2/2]

◆ operator+=() [1/2]

◆ operator+=() [2/2]

◆ operator-()

◆ operator-=() [1/2]

◆ operator-=() [2/2]

◆ operator/=() [1/2]

◆ operator/=() [2/2]

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ size()

◆ XT()

◆ XY()

◆ XYT()

◆ XYZ()

◆ XZ()

◆ XZT()

◆ YT()

◆ YZ()

◆ YZT()

◆ ZT()

Member Data Documentation

◆ T

◆ X

◆ Y

◆ Z

template<typename V>
struct ptems::BasicVector< V, 4 >