QGIS API Documentation 4.0.0-Norrköping (1ddcee3d0e4)
Loading...
Searching...
No Matches
qgsmatrix4x4.h
Go to the documentation of this file.
1/***************************************************************************
2 qgsmatrix4x4.h
3 --------------------------------------
4 Date : July 2023
5 Copyright : (C) 2023 by Martin Dobias
6 Email : wonder dot sk at gmail dot com
7 ***************************************************************************
8 * *
9 * This program is free software; you can redistribute it and/or modify *
10 * it under the terms of the GNU General Public License as published by *
11 * the Free Software Foundation; either version 2 of the License, or *
12 * (at your option) any later version. *
13 * *
14 ***************************************************************************/
15
16#ifndef QGSMATRIX4X4_H
17#define QGSMATRIX4X4_H
18
19#include "qgis_core.h"
20#include "qgis_sip.h"
21#include "qgsvector3d.h"
22
23#include <QString>
24
25using namespace Qt::StringLiterals;
26
41class CORE_EXPORT QgsMatrix4x4
42{
43 public:
47 // clang-format off
49 double m11, double m12, double m13, double m14,
50 double m21, double m22, double m23, double m24,
51 double m31, double m32, double m33, double m34,
52 double m41, double m42, double m43, double m44
53 );
54 // clang-format on
55
56 bool operator==( const QgsMatrix4x4 &other ) const
57 {
58 const double *data = *m;
59 const double *otherData = *( other.m );
60 for ( int i = 0; i < 16; ++i, data++, otherData++ )
61 {
62 if ( !qgsDoubleNear( *data, *otherData ) )
63 return false;
64 }
65 return true;
66 }
67
68 bool operator!=( const QgsMatrix4x4 &other ) const { return !( *this == other ); }
69
71 const double *constData() const SIP_SKIP { return *m; }
73 double *data() SIP_SKIP { return *m; }
74 // clang-format off
76 QList< double > dataList() const SIP_PYNAME( data ) SIP_HOLDGIL;
77 // clang-format on
78
82 void translate( const QgsVector3D &vector );
83
85 QgsVector3D map( const QgsVector3D &vector ) const SIP_HOLDGIL
86 {
87 return *this * vector;
88 }
89
91 bool isIdentity() const SIP_HOLDGIL;
93 void setToIdentity() SIP_HOLDGIL;
94
95#ifdef SIP_RUN
96// clang-format off
97 SIP_PYOBJECT __repr__();
98 % MethodCode
99 QString str = u"<QgsMatrix4x4(%1, %2, %3, %4, %5, %6, %7, %8, %9, %10, %11, %12, %13, %14, %15, %16)>"_s
100 .arg( sipCpp->data()[0] )
101 .arg( sipCpp->data()[4] )
102 .arg( sipCpp->data()[8] )
103 .arg( sipCpp->data()[12] )
104 .arg( sipCpp->data()[1] )
105 .arg( sipCpp->data()[5] )
106 .arg( sipCpp->data()[9] )
107 .arg( sipCpp->data()[13] )
108 .arg( sipCpp->data()[2] )
109 .arg( sipCpp->data()[6] )
110 .arg( sipCpp->data()[10] )
111 .arg( sipCpp->data()[14] )
112 .arg( sipCpp->data()[3] )
113 .arg( sipCpp->data()[7] )
114 .arg( sipCpp->data()[11] )
115 .arg( sipCpp->data()[15] );
116 sipRes = PyUnicode_FromString( str.toUtf8().constData() );
117 % End
118// clang-format on
119#endif
120
121#ifndef SIP_RUN
122 friend CORE_EXPORT QgsMatrix4x4 operator*( const QgsMatrix4x4 &m1, const QgsMatrix4x4 &m2 );
123 friend CORE_EXPORT QgsVector3D operator*( const QgsMatrix4x4 &matrix, const QgsVector3D &vector );
124#endif
125
126 private:
127 // Matrix data - in column-major order
128 double m[4][4];
129
131 explicit QgsMatrix4x4( int ) { } // cppcheck-suppress uninitMemberVarPrivate
132};
133
135CORE_EXPORT QgsVector3D operator*( const QgsMatrix4x4 &matrix, const QgsVector3D &vector );
137CORE_EXPORT QgsMatrix4x4 operator*( const QgsMatrix4x4 &m1, const QgsMatrix4x4 &m2 );
138
139
140#endif
A simple 4x4 matrix implementation useful for transformation in 3D space.
bool operator==(const QgsMatrix4x4 &other) const
QgsMatrix4x4()
Initializes identity matrix.
void setToIdentity()
Sets matrix to be identity matrix.
QgsVector3D map(const QgsVector3D &vector) const
Matrix-vector multiplication (vector is converted to homogeneous coordinates [X,Y,...
bool operator!=(const QgsMatrix4x4 &other) const
double * data()
Returns pointer to the matrix data (stored in column-major order).
const double * constData() const
Returns pointer to the matrix data (stored in column-major order).
A 3D vector (similar to QVector3D) with the difference that it uses double precision instead of singl...
Definition qgsvector3d.h:33
bool qgsDoubleNear(double a, double b, double epsilon=4 *std::numeric_limits< double >::epsilon())
Compare two doubles (but allow some difference).
Definition qgis.h:6975
#define SIP_SKIP
Definition qgis_sip.h:133
#define SIP_PYNAME(name)
Definition qgis_sip.h:88
#define SIP_HOLDGIL
Definition qgis_sip.h:178
QgsMargins operator*(const QgsMargins &margins, double factor)
Returns a QgsMargins object that is formed by multiplying each component of the given margins by fact...
Definition qgsmargins.h:245
CORE_EXPORT QgsVector3D operator*(const QgsMatrix4x4 &matrix, const QgsVector3D &vector)
Matrix-matrix multiplication (useful to concatenate transforms).