This file is indexed.

/usr/include/osgEarthUtil/LogarithmicDepthBuffer 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
/* -*-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_UTIL_LOG_DEPTH_BUFFER_H
#define OSGEARTH_UTIL_LOG_DEPTH_BUFFER_H  1

#include <osgEarthUtil/Common>
#include <osg/Camera>

namespace osgEarth { namespace Util 
{
    /**
     * Installs and controls a logarithmic depth buffer that improves
     * rendering of close and far objects in the same view without
     * z-fighting artifacts.
     *
     * Note: Only works with perspective projections. For an orthographic
     * projection it is a NOP.
     *
     * Note: If you have any RTT cameras that deal with depth data,
     * they need to use a log buffer as well! (e.g., ClampingTechnique)
     *
     * Another Note: For this to work properly, sufficient tessellation
     * of objects very close to the camera is necessary. Huge polygons
     * that intersect the near plane are likely to be clipped in their
     * entirely. Increasing the tessellation can resolve that issue.
     */
    class OSGEARTHUTIL_EXPORT LogarithmicDepthBuffer
    {
    public:
        /** Constructs a logarithmic depth buffer controller. */
        LogarithmicDepthBuffer();

        /**
         * Whether to write to gl_FragDepth. (default = true)
         * Pro: accurate clipping near the camera regardless of weak tessellation
         * Con: writes to gl_FragDepth defeats early-Z testing on the GPU (hurting
         *      performance in fill-limited scenarios)
         *
         * Set this before calling install().
         */
        void setUseFragDepth(bool value);
        bool getUseFragDepth() const { return _useFragDepth; }

        /** is it supported on this platform? */
        bool supported() const { return _supported; }

        /** Installs a logarithmic depth buffer on a camera. */
        void install(osg::Camera* camera);

        /** Uninstalls a logarithmic depth buffer from a camera. */
        void uninstall(osg::Camera* camera);

    protected:
        osg::ref_ptr<osg::NodeCallback> _cullCallback;
        bool _supported;
        bool _useFragDepth;
        osg::ref_ptr<osg::Uniform> _FCUniform;
    };

} } // namespace osgEarth::Util

#endif // OSGEARTH_UTIL_LOG_DEPTH_BUFFER_H