qgsmatrix4x4.h

Go to the documentation of this file.

/***************************************************************************
  qgsmatrix4x4.h
  --------------------------------------
  Date                 : July 2023
  Copyright            : (C) 2023 by Martin Dobias
  Email                : wonder dot sk at gmail dot com
 ***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
 
#ifndef QGSMATRIX4X4_H
#define QGSMATRIX4X4_H
 
#include "qgis_core.h"
#include "qgis_sip.h"
#include "qgsvector3d.h"
 
#include <QString>
 
using namespace Qt::StringLiterals;

class CORE_EXPORT QgsMatrix4x4
{
  public:
    QgsMatrix4x4() { setToIdentity(); }
    // clang-format off
    QgsMatrix4x4(
      double m11, double m12, double m13, double m14,
      double m21, double m22, double m23, double m24,
      double m31, double m32, double m33, double m34,
      double m41, double m42, double m43, double m44
    );
    // clang-format on
 
    bool operator==( const QgsMatrix4x4 &other ) const { return fuzzyEqual( other, 4 * std::numeric_limits<double>::epsilon() ); }
 
    bool operator!=( const QgsMatrix4x4 &other ) const { return !( *this == other ); }
 

    bool fuzzyEqual( const QgsMatrix4x4 &other, double epsilon = 1e-8 ) const
    SIP_HOLDGIL;

    const double *constData() const SIP_SKIP { return *m; }
    double *data() SIP_SKIP { return *m; }
    // clang-format off
    QList< double > dataList() const SIP_PYNAME( data ) SIP_HOLDGIL;
    // clang-format on

    void translate( const QgsVector3D &vector );

    QgsVector3D map( const QgsVector3D &vector ) const SIP_HOLDGIL
    {
      return *this * vector;
    }

    QgsVector3D mapVector( const QgsVector3D &vector ) const SIP_HOLDGIL;
 

    bool isIdentity() const SIP_HOLDGIL;
    void setToIdentity() SIP_HOLDGIL;

    void scale( const QgsVector3D &vector );

    void rotate( double angle, double x, double y, double z );

    void rotate( double angle, const QgsVector3D &vector );

    double determinant() const;
 
#ifdef SIP_RUN
// clang-format off
    SIP_PYOBJECT __repr__();
    % MethodCode
    QString str = u"<QgsMatrix4x4(%1, %2, %3, %4, %5, %6, %7, %8, %9, %10, %11, %12, %13, %14, %15, %16)>"_s
                  .arg( sipCpp->data()[0] )
                  .arg( sipCpp->data()[4] )
                  .arg( sipCpp->data()[8] )
                  .arg( sipCpp->data()[12] )
                  .arg( sipCpp->data()[1] )
                  .arg( sipCpp->data()[5] )
                  .arg( sipCpp->data()[9] )
                  .arg( sipCpp->data()[13] )
                  .arg( sipCpp->data()[2] )
                  .arg( sipCpp->data()[6] )
                  .arg( sipCpp->data()[10] )
                  .arg( sipCpp->data()[14] )
                  .arg( sipCpp->data()[3] )
                  .arg( sipCpp->data()[7] )
                  .arg( sipCpp->data()[11] )
                  .arg( sipCpp->data()[15] );
    sipRes = PyUnicode_FromString( str.toUtf8().constData() );
    % End
// clang-format on
#endif
 
#ifndef SIP_RUN
    friend CORE_EXPORT QgsMatrix4x4 operator*( const QgsMatrix4x4 &m1, const QgsMatrix4x4 &m2 );
    friend CORE_EXPORT QgsVector3D operator*( const QgsMatrix4x4 &matrix, const QgsVector3D &vector );
#endif
 
  private:
    // Matrix data - in column-major order
    double m[4][4];

    explicit QgsMatrix4x4( int ) { }   // cppcheck-suppress uninitMemberVarPrivate
};

CORE_EXPORT QgsVector3D operator*( const QgsMatrix4x4 &matrix, const QgsVector3D &vector );
CORE_EXPORT QgsMatrix4x4 operator*( const QgsMatrix4x4 &m1, const QgsMatrix4x4 &m2 );
 
 
#endif