110 lines
3.6 KiB
Plaintext
110 lines
3.6 KiB
Plaintext
|
/* -*-c++-*- */
|
||
|
|
/* osgEarth - Geospatial SDK for OpenSceneGraph
|
||
|
|
* Copyright 2020 Pelican Mapping
|
||
|
|
* http://osgearth.org
|
||
|
|
*
|
||
|
|
* osgEarth is free software; you can redistribute it and/or modify
|
||
|
|
* it under the terms of the GNU Lesser General Public License as published by
|
||
|
|
* the Free Software Foundation; either version 2 of the License, or
|
||
|
|
* (at your option) any later version.
|
||
|
|
*
|
||
|
|
* This program is distributed in the hope that it will be useful,
|
||
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
|
|
* GNU Lesser General Public License for more details.
|
||
|
|
*
|
||
|
|
* You should have received a copy of the GNU Lesser General Public License
|
||
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>
|
||
|
|
*/
|
||
|
|
#ifndef OSGEARTH_UTIL_MGRS_FORMATTER_H
|
||
|
|
#define OSGEARTH_UTIL_MGRS_FORMATTER_H
|
||
|
|
|
||
|
|
#include <osgEarth/Formatter>
|
||
|
|
#include <osgEarth/StringUtils>
|
||
|
|
#include <osgEarth/Units>
|
||
|
|
|
||
|
|
namespace osgEarth { namespace Util
|
||
|
|
{
|
||
|
|
using namespace osgEarth;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Represents an MGRS coordinate in its parts
|
||
|
|
*/
|
||
|
|
struct MGRSCoord
|
||
|
|
{
|
||
|
|
std::string gzd;
|
||
|
|
std::string sqid;
|
||
|
|
unsigned x;
|
||
|
|
unsigned y;
|
||
|
|
};
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Formats coordinate data as MGRS.
|
||
|
|
*
|
||
|
|
* NOTE: This class does not yet handle the special UTM zone exceptions for
|
||
|
|
* southwest Norway (zone 32V) and Svalbard (31X, 33X, 35X, 37X)..
|
||
|
|
* mainly because I have not found sufficient documentation on them
|
||
|
|
*
|
||
|
|
* See: http://en.wikipedia.org/wiki/Military_grid_reference_system
|
||
|
|
*/
|
||
|
|
class OSGEARTH_EXPORT MGRSFormatter : public Formatter
|
||
|
|
{
|
||
|
|
public:
|
||
|
|
enum Precision
|
||
|
|
{
|
||
|
|
PRECISION_100000M = 100000, // i.e., omit the numerical offsets altogether
|
||
|
|
PRECISION_10000M = 10000,
|
||
|
|
PRECISION_1000M = 1000,
|
||
|
|
PRECISION_100M = 100,
|
||
|
|
PRECISION_10M = 10,
|
||
|
|
PRECISION_1M = 1
|
||
|
|
};
|
||
|
|
|
||
|
|
enum Options
|
||
|
|
{
|
||
|
|
USE_SPACES = 1 << 0, // insert spaces between MGRS elements
|
||
|
|
FORCE_AA_SCHEME = 1 << 1, // use the AA row lettering scheme regardless of ellipsoid
|
||
|
|
FORCE_AL_SCHEME = 1 << 2 // use the AL row lettering scheme regardless of ellipsoid
|
||
|
|
};
|
||
|
|
|
||
|
|
public:
|
||
|
|
/**
|
||
|
|
* Initialized an MGRS formatter.
|
||
|
|
*
|
||
|
|
* @param precision Precision with which to print the MGRS string (see Precision above)
|
||
|
|
* @param refSRS Reference geographic SRS for MGRS encoding. Older datums
|
||
|
|
* (Clark and Bessel) change the row lettering scheme. Default=WGS84.
|
||
|
|
* @param options Formatting options (see Options above)
|
||
|
|
*/
|
||
|
|
MGRSFormatter(
|
||
|
|
Precision precision =PRECISION_1M,
|
||
|
|
const SpatialReference* refSRS =0L,
|
||
|
|
unsigned options =0);
|
||
|
|
|
||
|
|
/** dtor */
|
||
|
|
virtual ~MGRSFormatter() { }
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Transforms input coords into MGRS.
|
||
|
|
*/
|
||
|
|
bool transform( const GeoPoint& input, MGRSCoord& out_mgrs ) const;
|
||
|
|
|
||
|
|
|
||
|
|
public: // Formatter
|
||
|
|
|
||
|
|
virtual std::string format( const GeoPoint& coords ) const;
|
||
|
|
|
||
|
|
|
||
|
|
private:
|
||
|
|
osg::ref_ptr<const SpatialReference> _refSRS;
|
||
|
|
bool _useAL;
|
||
|
|
Precision _precision;
|
||
|
|
unsigned _options;
|
||
|
|
|
||
|
|
std::unordered_map< std::string, osg::ref_ptr<const SpatialReference> > _srsCache;
|
||
|
|
};
|
||
|
|
|
||
|
|
} } // namespace osgEarth::Util
|
||
|
|
|
||
|
|
#endif // OSGEARTH_UTIL_MGRS_FORMATTER_H
|