/usr/include/osgEarthUtil/Shadowing 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 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 | /* -*-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.
*
* 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_SHADOWING_H
#define OSGEARTH_UTIL_SHADOWING_H 1
#include <osgEarthUtil/Common>
#include <osg/Camera>
#include <osg/Texture2DArray>
#include <osg/Matrix>
#include <osg/Uniform>
#include <osg/Light>
namespace osgEarth { namespace Util
{
/**
* Group that casts shadows on its subgraph.
*
* NOTE!! This object is not multi-camera aware yet.
*/
class OSGEARTHUTIL_EXPORT ShadowCaster : public osg::Group
{
public:
ShadowCaster();
/** Whether shadows are supported (requires GLSL) */
bool supported() const { return _supported; }
/**
* The light that will cast shadows.
* NOTE: Only works for point lights, like the sun.
*/
void setLight(osg::Light* light) { _light = light; }
osg::Light* getLight() { return _light.get(); }
/**
* Group of geometry that should cast shadows on this node's children.
* You must add geometry here in order to cast shadows. The geometry
* you add here will only be used to generate shadows - it must still
* exist elsewhere in the scene graph for rendering.
*/
osg::Group* getShadowCastingGroup() { return _castingGroup.get(); }
/**
* Slice ranges. Each slice (the space beteen each value in the list)
* represents a single shadow map in the Cascading Shadow Maps
* implementation.
*/
const std::vector<float>& getRanges() { return _ranges; }
void setRanges(const std::vector<float>& ranges);
/**
* The GPU texture image unit that will store the shadow map while
* rendering the subgraph.
*/
int getTextureImageUnit() const { return _texImageUnit; }
void setTextureImageUnit(int unit);
/**
* The size (in both dimensions) of the shadow depth texture. Bigger
* is sharper. Default is 1024. The total texture size used will be
* size * # of range slices * 3 bytes.
*/
unsigned getTextureSize() const { return _size; }
void setTextureSize(unsigned size);
/**
* The ambient color of the shadow. This is blended with the fragment
* color to achieve shadowing. Default is 0x7f7f7fff
*/
void setShadowColor(const osg::Vec4f& value);
const osg::Vec4f& getShadowColor() const { return _color; }
/**
* The blurring factor to apply to shadow PCF sampling. Using a blurring
* factor will incur a GPU performance penalty. Default is 0.0.
* Decent values are [0.0 -> 0.001].
*/
void setBlurFactor(float value);
float getBlurFactor() const { return _blurFactor; }
public: // osg::Node
virtual void traverse(osg::NodeVisitor& nv);
protected:
virtual ~ShadowCaster() { }
void reinitialize();
bool _supported;
osg::ref_ptr<osg::Group> _castingGroup;
unsigned _size;
float _blurFactor;
osg::Vec4f _color;
osg::ref_ptr<osg::Light> _light;
osg::ref_ptr<osg::Texture2DArray> _shadowmap;
osg::ref_ptr<osg::StateSet> _rttStateSet;
std::vector<float> _ranges;
std::vector<osg::ref_ptr<osg::Camera> > _rttCameras;
osg::Matrix _prevProjMatrix;
int _texImageUnit;
osg::ref_ptr<osg::StateSet> _renderStateSet;
osg::ref_ptr<osg::Uniform> _shadowMapTexGenUniform;
osg::ref_ptr<osg::Uniform> _shadowBlurUniform;
osg::ref_ptr<osg::Uniform> _shadowColorUniform;
};
} } // namespace osgEarth::Util
#endif // OSGEARTH_UTIL_SHADOWING_H
|