This file is indexed.

/usr/include/osgEarthUtil/AtlasBuilder is in libosgearth-dev 2.9.0+dfsg-1.

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
/* -*-c++-*- */
/* osgEarth - Dynamic map generation toolkit for OpenSceneGraph
* Copyright 2016 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.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
* IN THE SOFTWARE.
*
* 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 OSGEARTHUTIL_ATLAS_BUILDER_H
#define OSGEARTHUTIL_ATLAS_BUILDER_H

#include <osgEarthUtil/Common>
#include <osgEarthSymbology/ResourceLibrary>
#include <osg/Vec4f>
#include <vector>

namespace osgDB {
    class Options;
}

namespace osgEarth { namespace Util
{
    /**
     * Compiles a resource library into a texture atlas.
     */
    class OSGEARTHUTIL_EXPORT AtlasBuilder
    {
    public:
        struct Atlas
        {
            // resulting atlas images. The first one is the master atlas image;
            // any following ones correspond to images created based on auxiliary
            // patterns added with addAuxFilePattern.
            std::vector<osg::ref_ptr<osg::Image> >             _images;

            // resulting resource library for the atlas
            osg::ref_ptr<osgEarth::Symbology::ResourceLibrary> _lib;
        };

    public:
        /** Construct a new atlas builder */
        AtlasBuilder(const osgDB::Options* options =0L);

        /** Sets the maximum size of each layer in the output atlas */
        void setSize(unsigned width, unsigned height);

        /** Adds an auxiliary file pattern that should be built, along with the
            default RGBA to use when the aux file doesn't exist. */
        void addAuxFilePattern(const std::string& pattern, const osg::Vec4f& defRGBA);

        /** List of aux file patterns */
        const std::vector<std::string>& auxFilePatterns() const { return _auxPatterns; }
        const std::vector<osg::Vec4f>& auxDefaultValues() const { return _auxDefaults; }

        /**
         * Whether to generate an RGB texture.  By default RGBA textures are created.
         */
        bool getRGB() const { return _rgb; }
        void setRGB( bool rgb ) { _rgb = rgb; }

        /** Builds an atlas. */
        bool build(
            const osgEarth::Symbology::ResourceLibrary* input,
            const std::string&                          newAtlasURI,
            Atlas&                                      output) const;


    protected:
        unsigned _width;
        unsigned _height;
        osg::ref_ptr<const osgDB::Options> _options;
        std::vector<std::string> _auxPatterns;
        std::vector<osg::Vec4f>  _auxDefaults;
        bool _debug;
        bool _rgb;
    };

} } // namespace osgEarth::Util

#endif // OSGEARTHUTIL_ATLAS_BUILDER_H