qgsellipse.h

Go to the documentation of this file.

/***************************************************************************
                         qgsellipse.h
                         --------------
    begin                : March 2017
    copyright            : (C) 2017 by Loîc Bartoletti
    email                : lbartoletti at tuxfamily dot org
 ***************************************************************************/

/***************************************************************************
 *                                                                         *
 *   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 QGSELLIPSE_H
#define QGSELLIPSE_H

#include <QString>

#include "qgis_core.h"
#include "qgspoint.h"
#include "qgspolygon.h"
#include "qgslinestring.h"
#include "qgsrectangle.h"

class CORE_EXPORT QgsEllipse
{

  public:

    QgsEllipse() = default;

    virtual ~QgsEllipse() = default;

    QgsEllipse( const QgsPoint &center, double semiMajorAxis, double semiMinorAxis, double azimuth = 90 );

    static QgsEllipse fromFoci( const QgsPoint &pt1, const QgsPoint &pt2, const QgsPoint &pt3 );

    static QgsEllipse fromExtent( const QgsPoint &pt1, const QgsPoint &pt2 );

    static QgsEllipse fromCenterPoint( const QgsPoint &ptc, const QgsPoint &pt1 );

    static QgsEllipse fromCenter2Points( const QgsPoint &ptc, const QgsPoint &pt1, const QgsPoint &pt2 );

    virtual bool operator ==( const QgsEllipse &elp ) const;
    virtual bool operator !=( const QgsEllipse &elp ) const;

    virtual bool isEmpty() const;

    QgsPoint center() const {return mCenter; }

    double semiMajorAxis() const {return mSemiMajorAxis; }

    double semiMinorAxis() const {return mSemiMinorAxis; }

    double azimuth() const {return mAzimuth; }

    QgsPoint &rcenter() SIP_SKIP { return mCenter; }

    void setCenter( const QgsPoint &center ) {mCenter = center; }

    virtual void setSemiMajorAxis( double semiMajorAxis );

    virtual void setSemiMinorAxis( double semiMinorAxis );

    void setAzimuth( double azimuth );

    virtual double focusDistance() const;

    virtual QVector<QgsPoint> foci() const;

    virtual double eccentricity() const;
    virtual double area() const;
    virtual double perimeter() const;

    virtual QVector<QgsPoint> quadrant() const;

    virtual QgsPointSequence points( unsigned int segments = 36 ) const;

    virtual QgsPolygon *toPolygon( unsigned int segments = 36 ) const SIP_FACTORY;

    virtual QgsLineString *toLineString( unsigned int segments = 36 ) const SIP_FACTORY;
    //virtual QgsCurvePolygon toCurvePolygon() const;

    virtual QgsPolygon *orientedBoundingBox() const SIP_FACTORY;

    virtual QgsRectangle boundingBox() const;

    virtual QString toString( int pointPrecision = 17, int axisPrecision = 17, int azimuthPrecision = 2 ) const;

#ifdef SIP_RUN
    SIP_PYOBJECT __repr__();
    % MethodCode
    QString str = QStringLiteral( "<QgsEllipse: %1>" ).arg( sipCpp->toString() );
    sipRes = PyUnicode_FromString( str.toUtf8().constData() );
    % End
#endif

  protected:
    QgsPoint mCenter;
    double mSemiMajorAxis = 0.0;
    double mSemiMinorAxis = 0.0;
    double mAzimuth = 90.0;

  private:
    void normalizeAxis();
};

#endif // QGSELLIPSE_H