v1::geo::vector< D > Class Template Reference

#include <hikogui/geometry/vector.hpp>

Public Member Functions
constexpr	vector (vector const &) noexcept=default
constexpr	vector (vector &&) noexcept=default
constexpr vector &	operator= (vector const &) noexcept=default
constexpr vector &	operator= (vector &&) noexcept=default
template<int E> requires (E < D)
constexpr	vector (vector< E > const &other) noexcept
	Construct a vector from a lower dimension vector.
template<int E> requires (E > D)
constexpr	vector (vector< E > const &other) noexcept
	Construct a vector from a higher dimension vector.
constexpr	operator f32x4 () const noexcept
	Convert a vector to its f32x4-nummeric_array.
constexpr	vector (f32x4 const &other) noexcept
	Construct a vector from a f32x4-numeric_array.
constexpr	vector () noexcept
	Construct a empty vector / zero length.
constexpr	vector (float x, float y) noexcept
	Construct a 2D vector from x and y elements.
constexpr	vector (float x, float y, float z=0.0f) noexcept
	Construct a 3D vector from x, y and z elements.
constexpr float &	x () noexcept
	Access the x element from the vector.
constexpr float &	y () noexcept
	Access the y element from the vector.
constexpr float &	z () noexcept
	Access the z element from the vector.
constexpr float const &	x () const noexcept
	Access the x element from the vector.
constexpr float const &	y () const noexcept
	Access the y element from the vector.
constexpr float const &	z () const noexcept
	Access the z element from the vector.
constexpr vector	operator- () const noexcept
	Mirror this vector.
template<int E> requires (E <= D)
constexpr vector &	operator+= (vector< E > const &rhs) noexcept
constexpr bool	holds_invariant () const noexcept
	Check if the vector is valid.

Friends
constexpr friend vector	operator+ (vector const &lhs, vector const &rhs) noexcept
	Add two vectors from each other.
constexpr friend vector	operator- (vector const &lhs, vector const &rhs) noexcept
	Subtract two vectors from each other.
constexpr friend vector	operator* (vector const &lhs, float const &rhs) noexcept
	Scale the vector by a scaler.
constexpr friend vector	operator* (float const &lhs, vector const &rhs) noexcept
	Scale the vector by a scaler.
constexpr friend bool	operator== (vector const &lhs, vector const &rhs) noexcept
	Compare if two vectors are equal.
constexpr friend float	squared_hypot (vector const &rhs) noexcept
	Get the squared length of the vector.
constexpr friend float	hypot (vector const &rhs) noexcept
	Get the length of the vector.
constexpr friend float	rcp_hypot (vector const &rhs) noexcept
	Get the length of the vector.
constexpr friend vector	normalize (vector const &rhs) noexcept
	Normalize a vector to a unit vector.
constexpr friend float	dot (vector const &lhs, vector const &rhs) noexcept
	Get the dot product between two vectors.
constexpr friend float	det (vector const &lhs, vector const &rhs) noexcept
	Get the determinate between two vectors.
template<int E>
constexpr auto	min (vector const &lhs, vector< E > const &rhs) noexcept
	Mix the two vectors and get the lowest value of each element.
template<int E>
constexpr auto	max (vector const &lhs, vector< E > const &rhs) noexcept
	Mix the two vectors and get the highest value of each element.
constexpr vector	round (vector const &rhs) noexcept
	Round the elements of the vector toward nearest integer.
constexpr vector	ceil (vector const &rhs) noexcept
	Round the elements of the vector toward upward and to the right.
constexpr vector	floor (vector const &rhs) noexcept
	Round the elements of the vector toward downward and to the left.
std::string	to_string (vector const &rhs) noexcept
std::ostream &	operator<< (std::ostream &lhs, vector const &rhs) noexcept

Detailed Description

template<int D>
class v1::geo::vector< D >

A high-level geometric vector Part of the high-level vector, point, mat and color types.

A vector, for both 2D or 3D is internally represented as a 4D homogeneous vector. Which can be efficiently implemented as a __m128 SSE register.

Constructor & Destructor Documentation

vector() [1/6]

template<int D>

template<int E>
requires (E < D)

constexpr v1::geo::vector< D >::vector ( vector< E > const & other )

inlineconstexprnoexcept

Construct a vector from a lower dimension vector.

vector() [2/6]

template<int D>

template<int E>
requires (E > D)

constexpr v1::geo::vector< D >::vector ( vector< E > const & other )

inlineexplicitconstexprnoexcept

Construct a vector from a higher dimension vector.

This will clear the values in the higher dimensions.

vector() [3/6]

template<int D>

constexpr v1::geo::vector< D >::vector ( f32x4 const & other )

inlineexplicitconstexprnoexcept

Construct a vector from a f32x4-numeric_array.

vector() [4/6]

template<int D>

constexpr v1::geo::vector< D >::vector ( )

inlineconstexprnoexcept

Construct a empty vector / zero length.

vector() [5/6]

template<int D>

constexpr v1::geo::vector< D >::vector ( float x, float y )

inlineconstexprnoexcept

Construct a 2D vector from x and y elements.

Parameters

x	The x element.
y	The y element.

vector() [6/6]

template<int D>

constexpr v1::geo::vector< D >::vector ( float x, float y, float z = 0.0f )

inlineconstexprnoexcept

Construct a 3D vector from x, y and z elements.

Parameters

x	The x element.
y	The y element.
z	The z element.

Member Function Documentation

holds_invariant()

template<int D>

constexpr bool v1::geo::vector< D >::holds_invariant ( ) const

inlineconstexprnoexcept

Check if the vector is valid.

This function will check if w is zero, and with 2D vector is z is zero.

operator f32x4()

template<int D>

constexpr v1::geo::vector< D >::operator f32x4 ( ) const

inlineexplicitconstexprnoexcept

Convert a vector to its f32x4-nummeric_array.

operator-()

template<int D>

constexpr vector v1::geo::vector< D >::operator- ( ) const

inlineconstexprnoexcept

Mirror this vector.

Returns

The mirrored vector.

x() [1/2]

template<int D>

constexpr float const & v1::geo::vector< D >::x ( ) const

inlineconstexprnoexcept

Access the x element from the vector.

Returns

a reference to the x element.

x() [2/2]

template<int D>

constexpr float & v1::geo::vector< D >::x ( )

inlineconstexprnoexcept

Access the x element from the vector.

Returns

a reference to the x element.

y() [1/2]

template<int D>

constexpr float const & v1::geo::vector< D >::y ( ) const

inlineconstexprnoexcept

Access the y element from the vector.

Returns

a reference to the y element.

y() [2/2]

template<int D>

constexpr float & v1::geo::vector< D >::y ( )

inlineconstexprnoexcept

Access the y element from the vector.

Returns

a reference to the y element.

z() [1/2]

template<int D>

constexpr float const & v1::geo::vector< D >::z ( ) const

inlineconstexprnoexcept

Access the z element from the vector.

Returns

a reference to the z element.

z() [2/2]

template<int D>

constexpr float & v1::geo::vector< D >::z ( )

inlineconstexprnoexcept

Access the z element from the vector.

Returns

a reference to the z element.

Friends And Related Symbol Documentation

ceil

template<int D>

constexpr vector ceil ( vector< D > const & rhs )

friend

Round the elements of the vector toward upward and to the right.

det

template<int D>

constexpr friend float det ( vector< D > const & lhs, vector< D > const & rhs )

friend

Get the determinate between two vectors.

Parameters

lhs	The first vector.
rhs	The second vector.

Returns

The dot product from the two given vectors.

dot

template<int D>

constexpr friend float dot ( vector< D > const & lhs, vector< D > const & rhs )

friend

Get the dot product between two vectors.

Parameters

lhs	The first vector.
rhs	The second vector.

Returns

The dot product from the two given vectors.

floor

template<int D>

constexpr vector floor ( vector< D > const & rhs )

friend

Round the elements of the vector toward downward and to the left.

hypot

template<int D>

constexpr friend float hypot ( vector< D > const & rhs )

friend

Get the length of the vector.

Parameters

rhs	The vector.

Returns

The length of the vector.

max

template<int D>

template<int E>

constexpr auto max ( vector< D > const & lhs, vector< E > const & rhs )

friend

Mix the two vectors and get the highest value of each element.

Parameters

lhs	The first vector.
rhs	The first vector.

Returns

A vector that points the most right of both vectors, and most upward of both vectors.

min

template<int D>

template<int E>

constexpr auto min ( vector< D > const & lhs, vector< E > const & rhs )

friend

Mix the two vectors and get the lowest value of each element.

Parameters

lhs	The first vector.
rhs	The first vector.

Returns

A vector that points the most left of both vectors, and most downward of both vectors.

normalize

template<int D>

constexpr friend vector normalize ( vector< D > const & rhs )

friend

Normalize a vector to a unit vector.

Parameters

rhs	The vector.

Returns

A vector with the same direction as the given vector, but its length is 1.0.

operator* [1/2]

template<int D>

constexpr friend vector operator* ( float const & lhs, vector< D > const & rhs )

friend

Scale the vector by a scaler.

Parameters

lhs	The vector to scale.
rhs	The scaling factor.

Returns

The scaled vector.

operator* [2/2]

template<int D>

constexpr friend vector operator* ( vector< D > const & lhs, float const & rhs )

friend

Scale the vector by a scaler.

Parameters

lhs	The vector to scale.
rhs	The scaling factor.

Returns

The scaled vector.

operator+

template<int D>

constexpr friend vector operator+ ( vector< D > const & lhs, vector< D > const & rhs )

friend

Add two vectors from each other.

Parameters

lhs	The first vector.
rhs	The second vector.

Returns

A new vector.

operator-

template<int D>

constexpr friend vector operator- ( vector< D > const & lhs, vector< D > const & rhs )

friend

Subtract two vectors from each other.

Parameters

lhs	The first vector.
rhs	The second vector.

Returns

A new vector.

operator==

template<int D>

constexpr friend bool operator== ( vector< D > const & lhs, vector< D > const & rhs )

friend

Compare if two vectors are equal.

Parameters

lhs	The first vector.
rhs	The second vector.

Returns

True if both vectors are completely equal to each other.

rcp_hypot

template<int D>

constexpr friend float rcp_hypot ( vector< D > const & rhs )

friend

Get the length of the vector.

Parameters

rhs	The vector.

Returns

One over the length of the vector.

round

template<int D>

constexpr vector round ( vector< D > const & rhs )

friend

Round the elements of the vector toward nearest integer.

squared_hypot

template<int D>

constexpr friend float squared_hypot ( vector< D > const & rhs )

friend

Get the squared length of the vector.

Parameters

rhs	The vector.

Returns

The length of the vector.

---

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

• hikogui/src/hikogui/geometry/vector.hpp