qgsellipsoidutils.h

Go to the documentation of this file.

/***************************************************************************
  qgsellipsoidutils.h
 --------------------
  Date                 : April 2017
  Copyright            : (C) 2017 by Nyall Dawson
  email                : nyall dot dawson 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 QGSELLIPSOIDUTILS_H
#define QGSELLIPSOIDUTILS_H

#include "qgis_core.h"
#include "qgis_sip.h"
#include "qgscoordinatereferencesystem.h"
#include <QStringList>

class CORE_EXPORT QgsEllipsoidUtils
{
  public:

    struct EllipsoidParameters
    {
      bool valid{ true };

      double semiMajor{ -1.0 };
      double semiMinor{ -1.0 };

      bool useCustomParameters{ false };

      double inverseFlattening{ -1.0 };

      QgsCoordinateReferenceSystem crs;
    };

    struct EllipsoidDefinition
    {
      QString acronym;
      QString description;
      QgsEllipsoidUtils::EllipsoidParameters parameters;
    };

    static EllipsoidParameters ellipsoidParameters( const QString &ellipsoid );

    static QList< QgsEllipsoidUtils::EllipsoidDefinition > definitions();

    static QStringList acronyms();

#ifndef SIP_RUN

    static void invalidateCache( bool disableCache = false );
#endif

  private:

    // ellipsoid cache
    static QReadWriteLock sEllipsoidCacheLock;
    static QHash< QString, EllipsoidParameters > sEllipsoidCache;
    static QReadWriteLock sDefinitionCacheLock;
    static QList< QgsEllipsoidUtils::EllipsoidDefinition > sDefinitionCache;

};

#endif // QGSELLIPSOIDUTILS_H