Multi-purpose 3D vector class (homogeneous). More...

#include <cvb/point_3d_h.hpp>

Public Member Functions
	Point3DH () noexcept=default
	Creates a default point at (0, 0).

	Point3DH (T x, T y, T z) noexcept
	Create a point from the x-, y- and z-component.

	Point3DH (T x, T y, T z, T w) noexcept
	Create a point from the x-, y-, z- and w-component.

	Point3DH (Point3D< T > point3d) noexcept
	Create a homogeneous point from a point.

template<std::size_t N>
	Point3DH (const T(&list)[N]) noexcept
	Construct a point with an initializer list.

T	X () const noexcept
	Gets the x-component of the point.

void	SetX (T x) noexcept
	Sets the x-component of the point.

T	Y () const noexcept
	Gets the y-component of the point.

void	SetY (T y)
	Sets the y-component of the point.

T	Z () const noexcept
	Gets the z-component of the point.

void	SetZ (T z)
	Sets the z-component of the point.

T	W () const noexcept
	Gets the w-component of the point.

void	SetW (T w)
	Sets the w-component of the point.

void	Normalize () noexcept
	Normalize the x-, y-, and z- with the w-component.

bool	operator== (const Point3DH< T > &other) const noexcept
	Compares to an other point.

bool	operator!= (const Point3DH< T > &other) const noexcept
	Compares to an other point.

template<class C>
	operator Point3DH< C > () const noexcept
	Enable casting.

Point3DH< T > &	operator+= (const Point3DH< T > &point) noexcept
	Adds and assigns to this point.

Point3DH< T > &	operator-= (const Point3DH< T > &point) noexcept
	Subtracts and assigns to this point.

Point3DH< T > &	operator*= (const T &value) noexcept
	Multiplies by a scalar and assigns to this point.

Point3DH< T > &	operator/= (const T &value) noexcept
	Divide by a scalar and assigns to this point.

const T &	operator[] (int index) const noexcept
	Index based element access.

T &	operator[] (int index) noexcept
	Index based element access.

Related Symbols
(Note that these are not member symbols.)
template<size_t I, class T, std::enable_if_t< less< I, 4 >::value, int > = 0>
auto	get (const Point3DH< T > &point) noexcept -> decltype(point[I])
	Get's the I-th element of the Point3DH<T>.

template<size_t I, class T, std::enable_if_t< less< I, 4 >::value, int > = 0>
void	set (Point3DH< T > &point, const T &val) noexcept
	Set's the value of the I-th element in the Point3DH<T> point.

template<class T>
Point3DH< T >	operator+ (const Point3DH< T > &lhs, const Point3DH< T > &rhs)
	Add two points.

template<class T>
Point3DH< T >	operator- (const Point3DH< T > &lhs, const Point3DH< T > &rhs)
	Subtracts two points.

template<class T>
T	operator* (const Point3DH< T > &lhs, const Point3DH< T > &rhs)
	Inner product of two point vectors.

template<class T>
Point3DH< T >	operator* (const Point3DH< T > &lhs, const T &rhs)
	Multiply point with scalar.

template<class T>
Point3DH< T >	operator/ (const Point3DH< T > &lhs, const T &rhs)
	Divide point by scalar.

Detailed Description

template<class T, class ENABLE = void>
class Cvb::Point3DH< T, ENABLE >

Multi-purpose 3D vector class (homogeneous).

Constructor & Destructor Documentation

◆ Point3DH() [1/5]

template<class T, class ENABLE = void>

Point3DH ( )

defaultnoexcept

Creates a default point at (0, 0).

Exceptions

Does	not throw any exception.

◆ Point3DH() [2/5]

template<class T, class ENABLE = void>

Point3DH	(	T	x,
		T	y,
		T	z )

inlinenoexcept

Create a point from the x-, y- and z-component.

Parameters

[in]	x	Data to initialize with.
[in]	y	Data to initialize with.
[in]	z	Data to initialize with.

Exceptions

Does	not throw any exception.

◆ Point3DH() [3/5]

template<class T, class ENABLE = void>

Point3DH	(	T	x,
		T	y,
		T	z,
		T	w )

inlinenoexcept

Create a point from the x-, y-, z- and w-component.

Parameters

[in]	x	Data to initialize with.
[in]	y	Data to initialize with.
[in]	z	Data to initialize with.
[in]	w	Data to initialize with.

Exceptions

Does	not throw any exception.

◆ Point3DH() [4/5]

template<class T, class ENABLE = void>

Point3DH ( Point3D< T > point3d )

inlineexplicitnoexcept

Create a homogeneous point from a point.

Parameters

[in] point3d 3D Point with x-, y- and z-component.

Exceptions

Does	not throw any exception.

◆ Point3DH() [5/5]

template<class T, class ENABLE = void>

template<std::size_t N>

Point3DH ( const T(&) list[N] )

inlinenoexcept

Construct a point with an initializer list.

Parameters

[in] list Containing exactly 4 elements.

Exceptions

Does	not throw any exception.

Member Function Documentation

◆ Normalize()

template<class T, class ENABLE = void>

void Normalize ( )

inlinenoexcept

Normalize the x-, y-, and z- with the w-component.

Exceptions

Does	not throw any exception.

◆ operator!=()

template<class T, class ENABLE = void>

bool operator!= ( const Point3DH< T > & other ) const

inlinenoexcept

Compares to an other point.

Parameters

[in] other Other point.

Returns: True if not equal, otherwise false.

Exceptions

Does	not throw any exception.

◆ operator*=()

template<class T, class ENABLE = void>

Point3DH< T > & operator*= ( const T & value )

inlinenoexcept

Multiplies by a scalar and assigns to this point.

Parameters

[in] value The scalar.

Returns: This point.

Exceptions

Does	not throw any exception.

◆ operator+=()

template<class T, class ENABLE = void>

Point3DH< T > & operator+= ( const Point3DH< T > & point )

inlinenoexcept

Adds and assigns to this point.

Parameters

[in] point Other point.

Returns: This point.

Exceptions

Does	not throw any exception.

◆ operator-=()

template<class T, class ENABLE = void>

Point3DH< T > & operator-= ( const Point3DH< T > & point )

inlinenoexcept

Subtracts and assigns to this point.

Parameters

[in] point Other point.

Returns: This point.

Exceptions

Does	not throw any exception.

◆ operator/=()

template<class T, class ENABLE = void>

Point3DH< T > & operator/= ( const T & value )

inlinenoexcept

Divide by a scalar and assigns to this point.

Parameters

[in] value The scalar.

Returns: This point.

Exceptions

Does	not throw any exception.

◆ operator==()

template<class T, class ENABLE = void>

bool operator== ( const Point3DH< T > & other ) const

inlinenoexcept

Compares to an other point.

Parameters

[in] other Other point.

Returns: True if equal, otherwise false.

Exceptions

Does	not throw any exception.

◆ operator[]() [1/2]

template<class T, class ENABLE = void>

const T & operator[] ( int index ) const

inlinenoexcept

Index based element access.

Parameters

[in] index Index of the element.

Returns: A const reference to the element.

Exceptions

Does	not throw any exception.

◆ operator[]() [2/2]

template<class T, class ENABLE = void>

T & operator[] ( int index )

inlinenoexcept

Index based element access.

Parameters

[in] index Index of the element.

Returns: A reference to the element.

Exceptions

Does	not throw any exception.

◆ SetW()

template<class T, class ENABLE = void>

void SetW ( T w )

inline

Sets the w-component of the point.

Parameters

[in] w W-component.

Exceptions

Does	not throw any exception.

◆ SetX()

template<class T, class ENABLE = void>

void SetX ( T x )

inlinenoexcept

Sets the x-component of the point.

Parameters

[in] x X-component.

Exceptions

Does	not throw any exception.

◆ SetY()

template<class T, class ENABLE = void>

void SetY ( T y )

inline

Sets the y-component of the point.

Parameters

[in] y Y-component.

Exceptions

Does	not throw any exception.

◆ SetZ()

template<class T, class ENABLE = void>

void SetZ ( T z )

inline

Sets the z-component of the point.

Parameters

[in] z Z-component.

Exceptions

Does	not throw any exception.

◆ W()

template<class T, class ENABLE = void>

T W ( ) const

inlinenoexcept

Gets the w-component of the point.

Returns: W-component.

Exceptions

Does	not throw any exception.

◆ X()

template<class T, class ENABLE = void>

T X ( ) const

inlinenoexcept

Gets the x-component of the point.

Returns: X-component.

Exceptions

Does	not throw any exception.

◆ Y()

template<class T, class ENABLE = void>

T Y ( ) const

inlinenoexcept

Gets the y-component of the point.

Returns: Y-component.

Exceptions

Does	not throw any exception.

◆ Z()

template<class T, class ENABLE = void>

T Z ( ) const

inlinenoexcept

Gets the z-component of the point.

Returns: Z-component.

Exceptions

Does	not throw any exception.

Friends And Related Symbol Documentation

◆ get()

template<size_t I, class T, std::enable_if_t< less< I, 4 >::value, int > = 0>

auto get ( const Point3DH< T > & point ) -> decltype(point[I])

Get's the I-th element of the Point3DH<T>.

See also: Block, Visit

Precondition: I < 4

Template Parameters

I	The index of the element.

Parameters

point The Point3DH<T> to retrieve the I-th element from.

Returns: The I-th element of point.

◆ operator*() [1/2]

template<class T>

T operator*	(	const Point3DH< T > &	lhs,
		const Point3DH< T > &	rhs )

Inner product of two point vectors.

Parameters

[in]	lhs	Right hand side point.
[in]	rhs	Left hand side value.

Returns: The computation result.

Exceptions

Does	not throw any exception.

◆ operator*() [2/2]

template<class T>

Point3DH< T > operator*	(	const Point3DH< T > &	lhs,
		const T &	rhs )

Multiply point with scalar.

Parameters

[in]	lhs	Right hand side point.
[in]	rhs	Left hand side value.

Returns: The computation result.

Exceptions

Does	not throw any exception.

◆ operator+()

template<class T>

Point3DH< T > operator+	(	const Point3DH< T > &	lhs,
		const Point3DH< T > &	rhs )

Add two points.

Parameters

[in]	lhs	Right hand side point.
[in]	rhs	Left hand side point.

Returns: The computation result.

Exceptions

Does	not throw any exception.

◆ operator-()

template<class T>

Point3DH< T > operator-	(	const Point3DH< T > &	lhs,
		const Point3DH< T > &	rhs )

Subtracts two points.

Parameters

[in]	lhs	Right hand side point.
[in]	rhs	Left hand side point.

Returns: The computation result.

Exceptions

Does	not throw any exception.

◆ operator/()

template<class T>

Point3DH< T > operator/	(	const Point3DH< T > &	lhs,
		const T &	rhs )

Divide point by scalar.

Parameters

[in]	lhs	Right hand side matrix.
[in]	rhs	Left hand side value.

Returns: The computation result.

Exceptions

Does	not throw any exception.

◆ set()

template<size_t I, class T, std::enable_if_t< less< I, 4 >::value, int > = 0>

void set	(	Point3DH< T > &	point,
		const T &	val )

Set's the value of the I-th element in the Point3DH<T> point.

See also: Block, Visit

Precondition: I < 4

Template Parameters

I	The index of the element.

Parameters

point	The Point3DH<T,K> to set the I-th value in.
val	The value to be written to the I-th element of point.

Public Member Functions

Related Symbols

Detailed Description

Constructor & Destructor Documentation

◆ Point3DH() [1/5]

◆ Point3DH() [2/5]

◆ Point3DH() [3/5]

◆ Point3DH() [4/5]

◆ Point3DH() [5/5]

Member Function Documentation

◆ Normalize()

◆ operator!=()

◆ operator*=()

◆ operator+=()

◆ operator-=()

◆ operator/=()

◆ operator==()

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ SetW()

◆ SetX()

◆ SetY()

◆ SetZ()

◆ W()

◆ X()

◆ Y()

◆ Z()

Friends And Related Symbol Documentation

◆ get()

◆ operator*() [1/2]

◆ operator*() [2/2]

◆ operator+()

◆ operator-()

◆ operator/()

◆ set()