qgscamerapose.h

Go to the documentation of this file.

/***************************************************************************
  qgscamerapose.h
  --------------------------------------
  Date                 : July 2018
  Copyright            : (C) 2018 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 QGSCAMERAPOSE_H
#define QGSCAMERAPOSE_H
 
#include "qgis_3d.h"
 
#include "qgsvector3d.h"
 
#ifndef SIP_RUN
namespace Qt3DRender
{
  class QCamera;
}
#endif
 
class QDomDocument;
class QDomElement;
 
class _3D_EXPORT QgsCameraPose
{
  public:
 
    QgsVector3D centerPoint() const { return mCenterPoint; }
    void setCenterPoint( const QgsVector3D &point );
 
    float distanceFromCenterPoint() const { return mDistanceFromCenterPoint; }
    void setDistanceFromCenterPoint( float distance );
 
    float pitchAngle() const { return mPitchAngle; }
    void setPitchAngle( float pitch );
 
    float headingAngle() const { return mHeadingAngle; }
    void setHeadingAngle( float heading ) { mHeadingAngle = heading; }
 
    void updateCamera( Qt3DRender::QCamera *camera ) SIP_SKIP;
 
    QDomElement writeXml( QDomDocument &doc ) const;
    void readXml( const QDomElement &elem );
 
    // TODO c++20 - replace with = default
    bool operator==( const QgsCameraPose &other ) const
    {
      return mCenterPoint == other.mCenterPoint &&
             mDistanceFromCenterPoint == other.mDistanceFromCenterPoint &&
             mPitchAngle == other.mPitchAngle &&
             mHeadingAngle == other.mHeadingAngle;
    }
    bool operator!=( const QgsCameraPose &other ) const
    {
      return !operator==( other );
    }
 
  private:
    QgsVector3D mCenterPoint;
    float mDistanceFromCenterPoint = 1000;
    // prevent bug in QgsCameraPose::updateCamera when updating camera rotation.
    // With a mPitchAngle < 0.2 or > 179.8, QQuaternion::fromEulerAngles( mPitchAngle, mHeadingAngle, 0 )
    // will return bad rotation angle.
    // See https://bugreports.qt.io/browse/QTBUG-72103
#if QT_VERSION < QT_VERSION_CHECK(6, 0, 0)
    float mPitchAngle = 0.2f;
#else
    float mPitchAngle = 0.0f;
#endif
 
    float mHeadingAngle = 0;
};
 
 
#endif // QGSCAMERAPOSE_H