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;

    void updateCameraGlobe( Qt3DRender::QCamera *camera, double lat, double lon ) 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
    float mPitchAngle = 0.0f;

    float mHeadingAngle = 0;
};
 
 
#endif // QGSCAMERAPOSE_H