This file is indexed.

/usr/include/osgEarthUtil/LatLongFormatter is in libosgearth-dev 2.7.0+dfsg-2+b3.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
/* -*-c++-*- */
/* osgEarth - Dynamic map generation toolkit for OpenSceneGraph
 * Copyright 2015 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_LATLONG_FORMATTER_H
#define OSGEARTH_UTIL_LATLONG_FORMATTER_H

#include <osgEarthUtil/Formatter>
#include <osgEarth/StringUtils>
#include <osgEarth/Units>

namespace osgEarth { namespace Util
{
    using namespace osgEarth;

    /**
     * Formats geodetic (latitude/longitude) coordinates.
     */
    class OSGEARTHUTIL_EXPORT LatLongFormatter : public Formatter
    {
    public:
        /** Output format for angles. */
        enum AngularFormat {
            FORMAT_DEFAULT,
            FORMAT_DECIMAL_DEGREES,
            FORMAT_DEGREES_DECIMAL_MINUTES,
            FORMAT_DEGREES_MINUTES_SECONDS,
            FORMAT_DEGREES_MINUTES_SECONDS_TERSE // Display degrees minutes seconds but don't display values that are 0 and don't show fractional values.
        };

        /** Formatting options. */
        enum Options {
            USE_SYMBOLS     = 1 << 0,   // whether to use symbols
            USE_COLONS      = 1 << 1,   // whether to separate components with colons
            USE_SPACES      = 1 << 2,   // whether to separate components with spaces
            USE_PREFIXES    = 1 << 3,   // whether to use E/W/N/S prefixes
            USE_SUFFIXES    = 1 << 4,   // whether to use E/W/N/S suffixes
        };

    public:
        /**
         * Constructs a lat-long formatter.
         */
        LatLongFormatter(          
            const AngularFormat& defaultFormat =FORMAT_DECIMAL_DEGREES,
            unsigned             optionsMask   =0u );

        /** dtor */
        virtual ~LatLongFormatter() { }

        /**
         * Sets the output precision for decimal numbers  (default is 5)
         */
        void setPrecision( int value ) { _prec = value; }

        /**
         * Sets the formatting options
         */
        void setOptions( const Options& options ) { _options = options; }

        /** 
         * Formats an angle into one of the supported angular formats
         */
        std::string format(
            const Angular&       angle,
            bool                 latitude,
            int                  precision    =-1, 
            const AngularFormat& outputFormat =FORMAT_DEFAULT) const;

        /**
         * Parses a string into an angle (returning false if parsing fails).
         */
        bool parseAngle( const std::string& input, Angular& out_value );

    public: // Formatter

        virtual std::string format( const GeoPoint& p ) const;


    protected:
        unsigned      _options;
        AngularFormat _defaultFormat;
        int           _prec;
    };

} } // namespace osgEarth::Util

#endif // OSGEARTH_UTIL_LATLONG_FORMATTER_H