This file is indexed.

/usr/include/osgEarth/Random 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 OSGEARTH_RANDOM_H
#define OSGEARTH_RANDOM_H 1

#include <osgEarth/Common>

namespace osgEarth
{
    /**
     * Psuedo random number generator. Results are guaranteed to be consistent across
     * machines given the same seed value.
     */
    class OSGEARTH_EXPORT Random
    {
    public:
        enum Method
        {
            METHOD_FAST        // not great, but super-fast and cheap.
        };

    public:
        /**
         * Constructs a new random number generator. It is seeded with
         * the system clock.
         * @param method RNG method to use
         */
        Random( Method method =METHOD_FAST );

        /**
         * Constucts a new random number generator with a user-specified seed.
         * The results are guaranteed to be globally consistent.
         * @param seed   RNG seed value
         * @param method RNG method to use
         */
        Random( unsigned seed, Method method =METHOD_FAST );

        /**
         * Copy constructor.
         */
        Random( const Random& rhs );

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

        /**
         * Seeds the PRNG with a new seed.
         */
        void seed(unsigned s);

        /**
         * Resets the PRNG to its initial state (initial seed).
         */
        void reset();

        /**
         * Gets the next random number as an unsigned int.
         * @param mod Modulus value. The result will fall within the range [0..mod)
         */
        unsigned next( unsigned mod );

        /**
         * Gets the next random number as a double in the range [0..1].
         */
        double next();

    private:
        Method   _method;
        unsigned _seed;
        unsigned _next;
    };
}

#endif // OSGEARTH_RANDOM_H