#include <hikogui/geometry/matrix3.hpp>

Public Member Functions
constexpr	matrix3 (matrix3 const &) noexcept=default

constexpr	matrix3 (matrix3 &&) noexcept=default

constexpr matrix3 &	operator= (matrix3 const &) noexcept=default

constexpr matrix3 &	operator= (matrix3 &&) noexcept=default

constexpr	matrix3 () noexcept
	Constructs an identity matrix.

constexpr	matrix3 (f32x4 col0, f32x4 col1, f32x4 col2, f32x4 col3=f32x4{0.0f, 0.0f, 0.0f, 1.0f}) noexcept
	Construct a matrix from four columns.

constexpr	matrix3 (vector3 col0, vector3 col1, vector3 col2, vector3 col3=vector3{}) noexcept
	Construct a matrix from four vectors.

constexpr	matrix3 (float c0r0, float c1r0, float c2r0, float c0r1, float c1r1, float c2r1, float c0r2, float c1r2, float c2r2) noexcept
	Construct a matrix from two vectors.

constexpr	matrix3 (float c0r0, float c1r0, float c2r0, float c3r0, float c0r1, float c1r1, float c2r1, float c3r1, float c0r2, float c1r2, float c2r2, float c3r2, float c0r3, float c1r3, float c2r3, float c3r3) noexcept
	Construct a 4x4 matrix from scalar values.

constexpr	matrix3 (matrix2 const &other) noexcept
	Copy-construct a matrix from a smaller matrix.

constexpr	operator matrix2 () const noexcept

constexpr	matrix3 (scale3 const &rhs) noexcept

constexpr	matrix3 (translate3 const &rhs) noexcept

constexpr	matrix3 (rotate3 const &rhs) noexcept
	Convert quaternion to matrix.

constexpr	operator std::array< f32x4, 4 > () const noexcept
	Convert a point to its f32x4-nummeric_array.

constexpr bool	holds_invariant () const noexcept

constexpr f32x4	operator* (f32x4 const &rhs) const noexcept
	Transform a `f32x4` numeric array by the matrix.

constexpr matrix3	operator~ () const
	Invert matrix.

Static Public Member Functions
static constexpr matrix3	uniform (aarectangle src_rectangle, aarectangle dst_rectangle, alignment alignment) noexcept
	Create a transformation matrix to translate and uniformly-scale a src_rectangle to a dst_rectangle.

Friends
template<int I>
constexpr f32x4 const &	get (matrix3 const &rhs) noexcept
	Get a column.

template<int I>
constexpr f32x4 &	get (matrix3 &rhs) noexcept
	Get a column.

constexpr matrix3	transpose (matrix3 const &rhs) noexcept
	Matrix transpose.

template<char DstX, char DstY, char DstZ, char DstW = 'w'>
constexpr matrix3	reflect (matrix3 const &rhs) noexcept
	Reflect axis of a matrix.

constexpr friend bool	operator== (matrix3 const &lhs, matrix3 const &rhs) noexcept
	Compare two matrices potentially of different dimensions.

Detailed Description

A 2D or 3D homogenius matrix for transforming homogenious vectors and points.

This matrix is in column major order. It is implemented as 4 columns made from a f32x4 numeric-array.

Constructor & Destructor Documentation

◆ matrix3() [1/7]

constexpr hi::v1::matrix3::matrix3 ( )

inlineconstexprnoexcept

Constructs an identity matrix.

◆ matrix3() [2/7]

constexpr hi::v1::matrix3::matrix3	(	f32x4	col0,
		f32x4	col1,
		f32x4	col2,
		f32x4	col3 = f32x4{0.0f, 0.0f, 0.0f, 1.0f} )

inlineconstexprnoexcept

Construct a matrix from four columns.

Parameters

col0	The 1st `f32x4` column.
col1	The 2nd `f32x4` column.
col2	The 3rd `f32x4` column.
col3	The 4th `f32x4` column.

◆ matrix3() [3/7]

constexpr hi::v1::matrix3::matrix3	(	vector3	col0,
		vector3	col1,
		vector3	col2,
		vector3	col3 = vector3{} )

inlineconstexprnoexcept

Construct a matrix from four vectors.

Parameters

col0	The 1st `vector3` column.
col1	The 2nd `vector3` column.
col2	The 3rd `vector3` column.
col3	The 4th `vector3` column.

◆ matrix3() [4/7]

constexpr hi::v1::matrix3::matrix3	(	float	c0r0,
		float	c1r0,
		float	c2r0,
		float	c0r1,
		float	c1r1,
		float	c2r1,
		float	c0r2,
		float	c1r2,
		float	c2r2 )

inlineconstexprnoexcept

Construct a matrix from two vectors.

Parameters

col0	The 1st `vector2` column.
col1	The 2nd `vector2` column. Construct a 3x3 matrix from scalar values.

The function parameters are in row-major order for pretty formatting in source code. The matrix itself remains in column-major order.

Parameters

c0r0	Value for column 0, row 0
c1r0	Value for column 1, row 0
c2r0	Value for column 2, row 0
c0r1	Value for column 0, row 1
c1r1	Value for column 1, row 1
c2r1	Value for column 2, row 1
c0r2	Value for column 0, row 2
c1r2	Value for column 1, row 2
c2r2	Value for column 2, row 2

◆ matrix3() [5/7]

constexpr hi::v1::matrix3::matrix3	(	float	c0r0,
		float	c1r0,
		float	c2r0,
		float	c3r0,
		float	c0r1,
		float	c1r1,
		float	c2r1,
		float	c3r1,
		float	c0r2,
		float	c1r2,
		float	c2r2,
		float	c3r2,
		float	c0r3,
		float	c1r3,
		float	c2r3,
		float	c3r3 )

inlineconstexprnoexcept

Construct a 4x4 matrix from scalar values.

The function parameters are in row-major order for pretty formatting in source code. The matrix itself remains in column-major order.

Parameters

c0r0	Value for column 0, row 0
c1r0	Value for column 1, row 0
c2r0	Value for column 2, row 0
c3r0	Value for column 3, row 0
c0r1	Value for column 0, row 1
c1r1	Value for column 1, row 1
c2r1	Value for column 2, row 1
c3r1	Value for column 3, row 1
c0r2	Value for column 0, row 2
c1r2	Value for column 1, row 2
c2r2	Value for column 2, row 2
c3r2	Value for column 3, row 2
c0r3	Value for column 0, row 3
c1r3	Value for column 1, row 3
c2r3	Value for column 2, row 3
c3r3	Value for column 3, row 3

◆ matrix3() [6/7]

constexpr hi::v1::matrix3::matrix3 ( matrix2 const & other )

inlineconstexprnoexcept

Copy-construct a matrix from a smaller matrix.

◆ matrix3() [7/7]

constexpr hi::v1::matrix3::matrix3 ( rotate3 const & rhs )

inlineconstexprnoexcept

Convert quaternion to matrix.

Member Function Documentation

◆ operator std::array< f32x4, 4 >()

constexpr hi::v1::matrix3::operator std::array< f32x4, 4 > ( ) const

inlineexplicitconstexprnoexcept

Convert a point to its f32x4-nummeric_array.

◆ operator*()

constexpr f32x4 hi::v1::matrix3::operator* ( f32x4 const & rhs ) const

inlineconstexprnoexcept

Transform a f32x4 numeric array by the matrix.

Parameters

rhs	The `f32x4` numeric array to transform.

Returns: The transformed numeric array.

◆ operator~()

constexpr matrix3 hi::v1::matrix3::operator~ ( ) const

inlineconstexpr

Invert matrix.

◆ uniform()

static constexpr matrix3 hi::v1::matrix3::uniform	(	aarectangle	src_rectangle,
		aarectangle	dst_rectangle,
		alignment	alignment )

inlinestaticconstexprnoexcept

Create a transformation matrix to translate and uniformly-scale a src_rectangle to a dst_rectangle.

The implementation is located in scale.hpp since the definition requires both scale and translate.

Parameters

src_rectangle	The rectangle to be transformed.
dst_rectangle	The rectangle after transformation.
alignment	How the src_rectangle should be aligned inside the dst_rectangle after scaling and moving.

Returns: A transformation matrix to move and scale the src_rectangle to the dst_rectangle.

Friends And Related Symbol Documentation

◆ get [1/2]

template<int I>

constexpr f32x4 & get ( matrix3 & rhs )

friend

Get a column.

Template Parameters

I	The index of the column.

Returns: A reference to the selected column as a f32x4.

◆ get [2/2]

template<int I>

constexpr f32x4 const & get ( matrix3 const & rhs )

friend

Get a column.

Template Parameters

I	The index of the column.

Returns: A const reference to the selected column as a f32x4.

◆ operator==

constexpr friend bool operator==	(	matrix3 const &	lhs,
		matrix3 const &	rhs )

friend

Compare two matrices potentially of different dimensions.

Parameters

rhs	The right-hand-side matrix.

Return values

true	When the two matrices compare equal.

◆ reflect

template<char DstX, char DstY, char DstZ, char DstW = 'w'>

constexpr matrix3 reflect ( matrix3 const & rhs )

friend

Reflect axis of a matrix.

The default axis of HikoGUI's geometry system are:

       +y
       |   -z (away from camera)
       |  /
       | /
       |/
-x ----+---- +x
      /|
     / |
    /  |
  +z   |
       -y

In Vulkan the Y axis is downward; so to translate a matrix from HikoGUI to Vulkan you can use:

auto vulkan_M = reflect<'x', 'Y', 'z'>(hikogui_M);

The original axis are defined as the lower-case characters 'x', 'y', 'z' and 'w'; or for the negated axis as the upper-case characters 'X', 'Y', 'Z' and 'W'.

Template Parameters

DstX	Which of the original axis to use for the new matrix's x-axis.
DstY	Which of the original axis to use for the new matrix's y-axis.
DstZ	Which of the original axis to use for the new matrix's z-axis.
DstW	Which of the original axis to use for the new matrix's w-axis.

Parameters

rhs	The matrix to reflect

Returns: The reflected matrix.

◆ transpose

constexpr matrix3 transpose ( matrix3 const & rhs )

friend

Matrix transpose.

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

hikogui/src/hikogui/geometry/matrix3.hpp

Public Member Functions

Static Public Member Functions

Friends

Detailed Description

Constructor & Destructor Documentation

◆ matrix3() [1/7]

◆ matrix3() [2/7]

◆ matrix3() [3/7]

◆ matrix3() [4/7]

◆ matrix3() [5/7]

◆ matrix3() [6/7]

◆ matrix3() [7/7]

Member Function Documentation

◆ operator std::array< f32x4, 4 >()

◆ operator*()

◆ operator~()

◆ uniform()

Friends And Related Symbol Documentation

◆ get [1/2]

◆ get [2/2]

◆ operator==

◆ reflect

◆ transpose