MeshLib C++ Docs
Loading...
Searching...
No Matches
MRMatrix4.h
Go to the documentation of this file.
1#pragma once
2
3#include "MRMacros.h"
4#include "MRVector4.h"
5#include <cassert>
6#include <iosfwd>
7#include <limits>
8
9namespace MR
10{
13
14
15#ifdef _MSC_VER
16#pragma warning(push)
17#pragma warning(disable: 4804)
18#pragma warning(disable: 4146)
19#endif
20
23template <typename T>
24struct Matrix4
25{
26 using ValueType = T;
28
30 Vector4<T> x{ 1, 0, 0, 0 };
31 Vector4<T> y{ 0, 1, 0, 0 };
32 Vector4<T> z{ 0, 0, 1, 0 };
33 Vector4<T> w{ 0, 0, 0, 1 };
34
35 constexpr Matrix4() noexcept
36 {
37 static_assert( sizeof( Matrix4<ValueType> ) == 4 * sizeof( VectorType ), "Struct size invalid" );
38 }
40 constexpr Matrix4( const Vector4<T>& x, const Vector4<T>& y, const Vector4<T>& z, const Vector4<T>& w ) : x( x ), y( y ), z( z ), w( w ) { }
41
43 constexpr Matrix4( const Matrix3<T>& r, const Vector3<T>& t )
44 {
45 x = Vector4<T>( r.x.x, r.x.y, r.x.z, t.x );
46 y = Vector4<T>( r.y.x, r.y.y, r.y.z, t.y );
47 z = Vector4<T>( r.z.x, r.z.y, r.z.z, t.z );
48 w = Vector4<T>( 0, 0, 0, 1 );
49 }
50
53 template <MR_SAME_TYPE_TEMPLATE_PARAM(T, TT)>
54 constexpr Matrix4( const AffineXf3<TT>& xf ) MR_REQUIRES_IF_SUPPORTED( std::floating_point<T> ) : Matrix4( xf.A, xf.b ) {}
55
58 template <typename U> MR_REQUIRES_IF_SUPPORTED( !std::is_same_v<T, U> )
59 constexpr explicit Matrix4( const Matrix4<U> & m ) : x( m.x ), y( m.y ), z( m.z ), w( m.w ) { }
60
61 static constexpr Matrix4 zero() noexcept { return Matrix4( Vector4<T>(), Vector4<T>(), Vector4<T>(), Vector4<T>() ); }
62 static constexpr Matrix4 identity() noexcept { return Matrix4(); }
64 static constexpr Matrix4 scale( T s ) noexcept { return Matrix4( { s, T(0), T(0), T(0) }, { T(0), s, T(0), T(0) }, { T(0), T(0), s, T(0) }, { T(0), T(0), T(0), s } ); }
65
67 constexpr const T& operator ()( int row, int col ) const noexcept { return operator[]( row )[col]; }
68 constexpr T& operator ()( int row, int col ) noexcept { return operator[]( row )[col]; }
69
71 constexpr const Vector4<T> & operator []( int row ) const noexcept { return *( ( VectorType* )this + row ); }
72 constexpr Vector4<T> & operator []( int row ) noexcept { return *( ( VectorType* )this + row ); }
73
75 constexpr Vector4<T> col( int i ) const noexcept { return { x[i], y[i], z[i], w[i] }; }
76
78 constexpr T trace() const noexcept { return x.x + y.y + z.z + w.w; }
80 constexpr T normSq() const noexcept { return x.lengthSq() + y.lengthSq() + z.lengthSq() + w.lengthSq(); }
81 constexpr auto norm() const noexcept
82 {
85 using std::sqrt;
86 return sqrt( normSq() );
87 }
89 Matrix3<T> submatrix3( int i, int j ) const noexcept;
91 T det() const noexcept;
93 constexpr Matrix4<T> inverse() const noexcept MR_REQUIRES_IF_SUPPORTED( !std::is_integral_v<T> );
95 constexpr Matrix4<T> transposed() const noexcept;
96
97 constexpr Matrix3<T> getRotation() const noexcept;
98 void setRotation( const Matrix3<T>& rot) noexcept;
99 constexpr Vector3<T> getTranslation() const noexcept;
100 void setTranslation( const Vector3<T>& t ) noexcept;
101
102 constexpr T* data() { return (T*) (&x); };
103 constexpr const T* data() const { return (T*) (&x); };
104
105 template <MR_SAME_TYPE_TEMPLATE_PARAM(T, TT)>
106 operator AffineXf3<TT>() const MR_REQUIRES_IF_SUPPORTED( std::floating_point<T> )
107 {
108 assert( std::abs( w.x ) < std::numeric_limits<T>::epsilon() * 1000 );
109 assert( std::abs( w.y ) < std::numeric_limits<T>::epsilon() * 1000 );
110 assert( std::abs( w.z ) < std::numeric_limits<T>::epsilon() * 1000 );
111 assert( std::abs( 1 - w.w ) < std::numeric_limits<T>::epsilon() * 1000 );
112 AffineXf3<T> res;
113 res.A.x.x = x.x; res.A.x.y = x.y; res.A.x.z = x.z; res.b.x = x.w;
114 res.A.y.x = y.x; res.A.y.y = y.y; res.A.y.z = y.z; res.b.y = y.w;
115 res.A.z.x = z.x; res.A.z.y = z.y; res.A.z.z = z.z; res.b.z = z.w;
116 return res;
117 }
118
121 Vector3<T> operator ()( const Vector3<T> & b ) const MR_REQUIRES_IF_SUPPORTED( !std::is_integral_v<T> );
122
123 [[nodiscard]] friend constexpr bool operator ==( const Matrix4<T> & a, const Matrix4<T> & b ) { return a.x == b.x && a.y == b.y && a.z == b.z && a.w == b.w; }
124 [[nodiscard]] friend constexpr bool operator !=( const Matrix4<T> & a, const Matrix4<T> & b ) { return !( a == b ); }
125
127
128 [[nodiscard]] friend constexpr auto operator +( const Matrix4<T> & a, const Matrix4<T> & b ) -> Matrix4<decltype( std::declval<T>() + std::declval<T>() )> { return { a.x + b.x, a.y + b.y, a.z + b.z, a.w + b.w }; }
129 [[nodiscard]] friend constexpr auto operator -( const Matrix4<T> & a, const Matrix4<T> & b ) -> Matrix4<decltype( std::declval<T>() - std::declval<T>() )> { return { a.x - b.x, a.y - b.y, a.z - b.z, a.w - b.w }; }
130 [[nodiscard]] friend constexpr auto operator *( T a, const Matrix4<T> & b ) -> Matrix4<decltype( std::declval<T>() * std::declval<T>() )> { return { a * b.x, a * b.y, a * b.z, a * b.w }; }
131 [[nodiscard]] friend constexpr auto operator *( const Matrix4<T> & b, T a ) -> Matrix4<decltype( std::declval<T>() * std::declval<T>() )> { return { a * b.x, a * b.y, a * b.z, a * b.z }; }
132 [[nodiscard]] friend constexpr auto operator /( Matrix4<T> b, T a ) -> Matrix4<decltype( std::declval<T>() / std::declval<T>() )>
133 {
134 if constexpr ( std::is_integral_v<T> )
135 return { b.x / a, b.y / a, b.z / a, b.w / a };
136 else
137 return b * ( 1 / a );
138 }
139
140 friend constexpr Matrix4<T> & operator +=( Matrix4<T> & a, const Matrix4<T> & b ) { a.x += b.x; a.y += b.y; a.z += b.z; a.w += b.w; return a; }
141 friend constexpr Matrix4<T> & operator -=( Matrix4<T> & a, const Matrix4<T> & b ) { a.x -= b.x; a.y -= b.y; a.z -= b.z; a.w -= b.w; return a; }
142 friend constexpr Matrix4<T> & operator *=( Matrix4<T> & a, T b ) { a.x *= b; a.y *= b; a.z *= b; a.w *= b; return a; }
143 friend constexpr Matrix4<T> & operator /=( Matrix4<T> & a, T b )
144 {
145 if constexpr ( std::is_integral_v<T> )
146 { a.x /= b; a.y /= b; a.z /= b; a.w /= b; return a; }
147 else
148 return a *= ( 1 / b );
149 }
150
152 [[nodiscard]] friend constexpr auto operator *( const Matrix4<T> & a, const Vector4<T> & b ) -> Vector4<decltype( dot( std::declval<Vector4<T>>(), std::declval<Vector4<T>>() ) )>
153 {
154 return { dot( a.x, b ), dot( a.y, b ), dot( a.z, b ), dot( a.w, b ) };
155 }
156
158 [[nodiscard]] friend constexpr auto operator *( const Matrix4<T> & a, const Matrix4<T> & b ) -> Matrix4<decltype( dot( std::declval<Vector4<T>>(), std::declval<Vector4<T>>() ) )>
159 {
160 Matrix4<decltype( dot( std::declval<Vector4<T>>(), std::declval<Vector4<T>>() ) )> res;
161 for ( int i = 0; i < 4; ++i )
162 for ( int j = 0; j < 4; ++j )
163 res[i][j] = dot( a[i], b.col(j) );
164 return res;
165 }
166
167 friend std::ostream& operator<<( std::ostream& s, const Matrix4& mat )
168 {
169 return s << mat.x << '\n' << mat.y << '\n' << mat.z << '\n' << mat.w << '\n';
170 }
171
172 friend std::istream& operator>>( std::istream& s, Matrix4& mat )
173 {
174 return s >> mat.x >> mat.y >> mat.z >> mat.w;
175 }
176};
177
180
182template <typename T>
183inline auto dot( const Matrix4<T> & a, const Matrix4<T> & b ) -> decltype( dot( a.x, b.x ) )
184{
185 return dot( a.x, b.x ) + dot( a.y, b.y ) + dot( a.z, b.z ) + dot( a.w, b.w );
186}
187
188template <typename T>
189inline Vector3<T> Matrix4<T>::operator ()( const Vector3<T> & b ) const MR_REQUIRES_IF_SUPPORTED( !std::is_integral_v<T> )
190{
191 return ( *this * Vector4<T>{ b.x, b.y, b.z, T(1) } ).proj3d();
192}
193
195template <typename T>
196inline Matrix4<T> outer( const Vector4<T> & a, const Vector4<T> & b )
197{
198 return { a.x * b, a.y * b, a.z * b, a.w * b };
199}
200
201template <typename T>
202Matrix3<T> Matrix4<T>::submatrix3( int i, int j ) const noexcept
203{
204 Matrix3<T> res;
205 int nrow = 0;
206 for ( int m = 0; m < 4; m++ )
207 {
208 if ( m == i )
209 continue;
210 auto & row = res[nrow++];
211 int ncol = 0;
212 for ( int n = 0; n < 4; n++ )
213 {
214 if ( n == j )
215 continue;
216 row[ncol++] = ( *this )[m][n];
217 }
218 assert( ncol == 3 );
219 }
220 assert( nrow == 3 );
221 return res;
222}
223
224template <typename T>
225T Matrix4<T>::det() const noexcept
226{
227 return
228 x.x * submatrix3( 0, 0 ).det()
229 - x.y * submatrix3( 0, 1 ).det()
230 + x.z * submatrix3( 0, 2 ).det()
231 - x.w * submatrix3( 0, 3 ).det();
232}
233
234template <typename T>
235constexpr Matrix4<T> Matrix4<T>::transposed() const noexcept
236{
237 return Matrix4<T>
238 {
239 { x.x, y.x, z.x, w.x },
240 { x.y, y.y, z.y, w.y },
241 { x.z, y.z, z.z, w.z },
242 { x.w, y.w, z.w, w.w },
243 };
244}
245
246template <typename T>
247constexpr Matrix4<T> Matrix4<T>::inverse() const noexcept MR_REQUIRES_IF_SUPPORTED( !std::is_integral_v<T> )
248{
249 Matrix4<T> inv;
250 T* m = (T*) (&x);
251 T det;
252
253 inv[0][0] = m[5] * m[10] * m[15] -
254 m[5] * m[11] * m[14] -
255 m[9] * m[6] * m[15] +
256 m[9] * m[7] * m[14] +
257 m[13] * m[6] * m[11] -
258 m[13] * m[7] * m[10];
259
260 inv[1][0] = -m[4] * m[10] * m[15] +
261 m[4] * m[11] * m[14] +
262 m[8] * m[6] * m[15] -
263 m[8] * m[7] * m[14] -
264 m[12] * m[6] * m[11] +
265 m[12] * m[7] * m[10];
266
267 inv[2][0] = m[4] * m[9] * m[15] -
268 m[4] * m[11] * m[13] -
269 m[8] * m[5] * m[15] +
270 m[8] * m[7] * m[13] +
271 m[12] * m[5] * m[11] -
272 m[12] * m[7] * m[9];
273
274 inv[3][0] = -m[4] * m[9] * m[14] +
275 m[4] * m[10] * m[13] +
276 m[8] * m[5] * m[14] -
277 m[8] * m[6] * m[13] -
278 m[12] * m[5] * m[10] +
279 m[12] * m[6] * m[9];
280
281 inv[0][1] = -m[1] * m[10] * m[15] +
282 m[1] * m[11] * m[14] +
283 m[9] * m[2] * m[15] -
284 m[9] * m[3] * m[14] -
285 m[13] * m[2] * m[11] +
286 m[13] * m[3] * m[10];
287
288 inv[1][1] = m[0] * m[10] * m[15] -
289 m[0] * m[11] * m[14] -
290 m[8] * m[2] * m[15] +
291 m[8] * m[3] * m[14] +
292 m[12] * m[2] * m[11] -
293 m[12] * m[3] * m[10];
294
295 inv[2][1] = -m[0] * m[9] * m[15] +
296 m[0] * m[11] * m[13] +
297 m[8] * m[1] * m[15] -
298 m[8] * m[3] * m[13] -
299 m[12] * m[1] * m[11] +
300 m[12] * m[3] * m[9];
301
302 inv[3][1] = m[0] * m[9] * m[14] -
303 m[0] * m[10] * m[13] -
304 m[8] * m[1] * m[14] +
305 m[8] * m[2] * m[13] +
306 m[12] * m[1] * m[10] -
307 m[12] * m[2] * m[9];
308
309 inv[0][2] = m[1] * m[6] * m[15] -
310 m[1] * m[7] * m[14] -
311 m[5] * m[2] * m[15] +
312 m[5] * m[3] * m[14] +
313 m[13] * m[2] * m[7] -
314 m[13] * m[3] * m[6];
315
316 inv[1][2] = -m[0] * m[6] * m[15] +
317 m[0] * m[7] * m[14] +
318 m[4] * m[2] * m[15] -
319 m[4] * m[3] * m[14] -
320 m[12] * m[2] * m[7] +
321 m[12] * m[3] * m[6];
322
323 inv[2][2] = m[0] * m[5] * m[15] -
324 m[0] * m[7] * m[13] -
325 m[4] * m[1] * m[15] +
326 m[4] * m[3] * m[13] +
327 m[12] * m[1] * m[7] -
328 m[12] * m[3] * m[5];
329
330 inv[3][2] = -m[0] * m[5] * m[14] +
331 m[0] * m[6] * m[13] +
332 m[4] * m[1] * m[14] -
333 m[4] * m[2] * m[13] -
334 m[12] * m[1] * m[6] +
335 m[12] * m[2] * m[5];
336
337 inv[0][3] = -m[1] * m[6] * m[11] +
338 m[1] * m[7] * m[10] +
339 m[5] * m[2] * m[11] -
340 m[5] * m[3] * m[10] -
341 m[9] * m[2] * m[7] +
342 m[9] * m[3] * m[6];
343
344 inv[1][3] = m[0] * m[6] * m[11] -
345 m[0] * m[7] * m[10] -
346 m[4] * m[2] * m[11] +
347 m[4] * m[3] * m[10] +
348 m[8] * m[2] * m[7] -
349 m[8] * m[3] * m[6];
350
351 inv[2][3] = -m[0] * m[5] * m[11] +
352 m[0] * m[7] * m[9] +
353 m[4] * m[1] * m[11] -
354 m[4] * m[3] * m[9] -
355 m[8] * m[1] * m[7] +
356 m[8] * m[3] * m[5];
357
358 inv[3][3] = m[0] * m[5] * m[10] -
359 m[0] * m[6] * m[9] -
360 m[4] * m[1] * m[10] +
361 m[4] * m[2] * m[9] +
362 m[8] * m[1] * m[6] -
363 m[8] * m[2] * m[5];
364
365 det = m[0] * inv[0][0] + m[1] * inv[1][0] + m[2] * inv[2][0] + m[3] * inv[3][0];
366
367 if( det == 0 )
368 {
370 assert( false );
371 return Matrix4<T>();
372 }
373
374 inv /= det;
375
376 return inv;
377}
378
379template <typename T>
380constexpr Matrix3<T> Matrix4<T>::getRotation() const noexcept
381{
382 return Matrix3<T>
383 {
384 { x.x, x.y, x.z },
385 { y.x, y.y, y.z },
386 { z.x, z.y, z.z }
387 };
388}
389
390template <typename T>
391void Matrix4<T>::setRotation( const Matrix3<T>& rot ) noexcept
392{
393 x.x = rot.x.x; x.y = rot.x.y; x.z = rot.x.z;
394 y.x = rot.y.x; y.y = rot.y.y; y.z = rot.y.z;
395 z.x = rot.z.x; z.y = rot.z.y; z.z = rot.z.z;
396}
397
398template <typename T>
399constexpr Vector3<T> Matrix4<T>::getTranslation() const noexcept
400{
401 return Vector3<T>{ x.w, y.w, z.w };
402}
403
404template <typename T>
405void Matrix4<T>::setTranslation( const Vector3<T>& t ) noexcept
406{
407 x.w = t.x; y.w = t.y; z.w = t.z;
408}
409
411
412#ifdef _MSC_VER
413#pragma warning(pop)
414#endif
415
416}
#define MR_REQUIRES_IF_SUPPORTED(...)
Definition MRMacros.h:34
T y
Definition MRVector4.h:32
friend constexpr bool operator!=(const Matrix4< T > &a, const Matrix4< T > &b)
Definition MRMatrix4.h:124
T z
Definition MRVector4.h:32
Vector4< T > z
Definition MRMatrix4.h:32
T x
Definition MRVector4.h:32
Vector3< T > operator()(const Vector3< T > &b) const MR_REQUIRES_IF_SUPPORTED(!std friend constexpr bool operator==(const Matrix4< T > &a, const Matrix4< T > &b)
Definition MRMatrix4.h:123
constexpr T * data()
Definition MRMatrix4.h:102
T w
Definition MRVector4.h:32
Vector3< T > x
rows, identity matrix by default
Definition MRMatrix3.h:29
T ValueType
Definition MRMatrix4.h:26
T x
Definition MRVector3.h:39
constexpr T trace() const noexcept
computes trace of the matrix
Definition MRMatrix4.h:78
void setTranslation(const Vector3< T > &t) noexcept
T y
Definition MRVector3.h:39
friend constexpr auto operator*(T a, const Matrix4< T > &b) -> Matrix4< decltype(std::declval< T >() *std::declval< T >())>
Definition MRMatrix4.h:130
Matrix3< T > submatrix3(int i, int j) const noexcept
computes submatrix of the matrix with excluded i-th row and j-th column
static constexpr Matrix4 zero() noexcept
Definition MRMatrix4.h:61
constexpr T normSq() const noexcept
compute sum of squared matrix elements
Definition MRMatrix4.h:80
constexpr const T & operator()(int row, int col) const noexcept
element access
Definition MRMatrix4.h:67
Vector4< T > y
Definition MRMatrix4.h:31
static constexpr Matrix4 scale(T s) noexcept
returns a matrix that scales uniformly
Definition MRMatrix4.h:64
void setRotation(const Matrix3< T > &rot) noexcept
constexpr Matrix3< T > getRotation() const noexcept
constexpr Matrix4(const Matrix3< T > &r, const Vector3< T > &t)
construct from rotation matrix and translation vector
Definition MRMatrix4.h:43
friend constexpr auto operator/(Matrix4< T > b, T a) -> Matrix4< decltype(std::declval< T >()/std::declval< T >())>
Definition MRMatrix4.h:132
T det() const noexcept
computes determinant of the matrix
Vector4< T > w
Definition MRMatrix4.h:33
constexpr auto norm() const noexcept
Definition MRMatrix4.h:81
constexpr Matrix4(const AffineXf3< TT > &xf) MR_REQUIRES_IF_SUPPORTED(std
Definition MRMatrix4.h:54
constexpr Matrix4< T > inverse() const noexcept MR_REQUIRES_IF_SUPPORTED(!std constexpr Matrix4< T > transposed() const noexcept
computes inverse matrix
MR_REQUIRES_IF_SUPPORTED(!std::is_same_v< T, U >) const expr explicit Matrix4(const Matrix4< U > &m)
Definition MRMatrix4.h:58
Vector3< T > y
Definition MRMatrix3.h:30
auto dot(const Matrix4< T > &a, const Matrix4< T > &b) -> decltype(dot(a.x, b.x))
double-dot product: x = a : b
Definition MRMatrix4.h:183
constexpr Matrix4() noexcept
Definition MRMatrix4.h:35
friend constexpr auto operator+(const Matrix4< T > &a, const Matrix4< T > &b) -> Matrix4< decltype(std::declval< T >()+std::declval< T >())>
NOTE: We use std::declval() in the operators below because libclang 18 in our binding generator is bu...
Definition MRMatrix4.h:128
constexpr Matrix4(const Vector4< T > &x, const Vector4< T > &y, const Vector4< T > &z, const Vector4< T > &w)
initializes matrix from 4 row-vectors
Definition MRMatrix4.h:40
constexpr const Vector4< T > & operator[](int row) const noexcept
row access
Definition MRMatrix4.h:71
friend constexpr Matrix4< T > & operator+=(Matrix4< T > &a, const Matrix4< T > &b)
Definition MRMatrix4.h:140
constexpr Vector4< T > col(int i) const noexcept
column access
Definition MRMatrix4.h:75
friend constexpr Matrix4< T > & operator*=(Matrix4< T > &a, T b)
Definition MRMatrix4.h:142
friend constexpr Matrix4< T > & operator-=(Matrix4< T > &a, const Matrix4< T > &b)
Definition MRMatrix4.h:141
friend constexpr auto operator-(const Matrix4< T > &a, const Matrix4< T > &b) -> Matrix4< decltype(std::declval< T >() - std::declval< T >())>
Definition MRMatrix4.h:129
Vector3< T > z
Definition MRMatrix3.h:31
constexpr const T * data() const
Definition MRMatrix4.h:103
friend std::ostream & operator<<(std::ostream &s, const Matrix4 &mat)
Definition MRMatrix4.h:167
T z
Definition MRVector3.h:39
static constexpr Matrix4 identity() noexcept
Definition MRMatrix4.h:62
friend std::istream & operator>>(std::istream &s, Matrix4 &mat)
Definition MRMatrix4.h:172
friend constexpr Matrix4< T > & operator/=(Matrix4< T > &a, T b)
Definition MRMatrix4.h:143
constexpr Vector3< T > getTranslation() const noexcept
Vector4< T > x
rows, identity matrix by default
Definition MRMatrix4.h:30
Matrix4< T > outer(const Vector4< T > &a, const Vector4< T > &b)
x = a * b^T
Definition MRMatrix4.h:196
only for bindings generation
Definition MRCameraOrientationPlugin.h:8
Definition MRMatrix3.h:24
Definition MRMatrix4.h:25
Definition MRVector3.h:33
Definition MRVector4.h:26