VRS - The Virtual Rendering System

version 3.3

depthmapshadowtechniquegl.h

Go to the documentation of this file.

 /**********************************************************************
 VRS - The Virtual Rendering System
 Copyright (C) 2001 Computer Graphics Systems Group at the 
 Hasso-Plattner-Institute, Potsdam, Germany.
 This library 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.1 of the License, or (at your option) any later version.
 This library 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 library; if not, write to the FreeSoftware 
 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA, 02111-1307, USA.
 **********************************************************************/
// $Id: depthmapshadowtechniquegl.h 6014 2007-08-09 07:51:16Z Konstantin_Baumann $
// $Date: 2007-08-09 09:51:16 +0200 (Thu, 09 Aug 2007) $
// $Revision: 6014 $
// $State$
// $Author: Konstantin_Baumann $
//
// $Log$
// Revision 1.46  2005/01/03 01:43:09  klimetschek
// - modified win32 project layout, splitted vrs.vcproj into vrs_container, vrs_core, vrs_sg, vrs_image, vrs_opengl and vrs_io
// - removed vrs.vcproj
// minor things:
// - added all glutexamples to vrs4glut.sln
// - fixed some problems in glutexamples
// - removed all project references from all VS projects (using solution wide project dependencies instead)
//
// Revision 1.45  2004/10/26 18:53:13  kirsch
// added static and dynamic shadow map calculation modes
//
// Revision 1.44  2004/10/21 14:53:27  kirsch
// use cached resource for holding internal textures
//
// Revision 1.43  2004/08/05 14:47:10  kirsch
// numerous cleanups and minor changes
//
// Revision 1.42  2004/06/25 13:52:03  kirsch
// updated comments
//
// Revision 1.41  2004/06/17 14:34:53  kirsch
// cleanup: made pass_ and passArray_ private; added trivial accesor methods for them
// removed hack to collapse shadow map projection and light application pass
// (made more trouble than it was worth)
//
// Revision 1.40  2004/05/06 15:43:33  kirsch
// made some internal methods static such that they can be used from other places
//
// Revision 1.39  2004/03/12 16:28:40  baumann
// macros VRS_NAMESPACE_BEGIN/_END expanded and removed
//
// Revision 1.38  2004/02/01 10:10:35  kirsch
// fix for bug #6: initialize depthMapResolution in constructor
//
// Revision 1.37  2004/01/19 11:43:58  baumann
// serialization mechanism improved
//
// Revision 1.36  2003/11/07 14:19:25  kirsch
// removed leading underscore from include guards
//
// Revision 1.35  2003/07/03 16:21:58  kirsch
// added a hack that allows to collapse depthmap projection and light
// application in a single pass
//
// Revision 1.34  2003/07/03 12:14:03  kirsch
// fixed accuracy issue that showed up when using the lookat maniupulator
//
// Revision 1.33  2002/12/12 15:25:54  kirsch
// changed order of includes, due to errors when used in external projects
//
// Revision 1.32  2002/12/12 09:06:38  kirsch
// removed OpenGL extension ifdefs
// added isSupported() to allow silent extension check.
//     rate() now checks extensions silently, canBeUsed() is verbose
// serialization was incomplete
//
// Revision 1.31  2002/12/12 08:06:04  kirsch
// comment fixed
//
// Revision 1.30  2002/12/11 16:22:25  kirsch
// merged with more advanced private version of shadow technique
// - ShadowTechniqueGL is now a factory that choses between the "best" shadow technique
//   You best use this technique in the scene graph.
// - ShadowTechniqueTemplateGL is a template pattern which should be used for concrete shadow techniques
// - DepthmapShadowTechniqueGL is abstract base class for
//   - DepthTextureShadowTechniqueGL (shadows with depth-textures)
//   - AlphaTextureShadowTechniqueGL (shadows with alpha-textures)
//
// Revision 1.29  2002/12/02 16:40:46  kirsch
// cleanup, use TextureUnitSettingGL for texture related settings
//
// Revision 1.28  2002/11/29 09:52:17  kirsch
// partly merged with more advanced private version of shadow technique
// (results in changes to protected methods)
// set shadinghint
//
// Revision 1.27  2002/10/29 10:32:52  baumann
// macros VRS_CLASSNAME_* and VRS_IMPL_TYPEINFO_* removed
//
// Revision 1.26  2002/10/28 14:23:17  kirsch
// use static versions of pbuffermanagergl::prepareContext / releaseContext
//
// Revision 1.25  2002/10/24 10:56:26  kirsch
// use PBufferManagerGL
//
// Revision 1.24  2002/10/10 14:43:42  kirsch
// comparison between signed/unsigned warning fix
//
// Revision 1.23  2002/09/03 09:35:36  kirsch
// various changes:
// - use TextureUnitSelectorGL instead of switching textures manually
// - use TexEnvGL::SubtractWithBiasOneHalf instead of manual setup
// - disregard TextureGL (because of texture - category() changes)
//
// Revision 1.22  2002/07/04 14:23:57  kirsch
// removed IteratorWrapper
//
// Revision 1.21  2002/07/02 06:12:34  baumann
// VRS::Iterator<T> completely rewritten
//
// Revision 1.20  2002/05/14 12:41:30  kirsch
// ameliorate resolution of depth map by regarding only shadow casting
// shapes for it
// interface cleanup
//
// Revision 1.19  2002/04/25 08:29:43  kirsch
// added persistency
//
// Revision 1.18  2002/04/12 12:29:58  kirsch
// updated due to p-buffer changes
// seperated lookat-calculation for camera at light source
//
// Revision 1.17  2002/04/11 09:04:28  baumann
// changed ctx from Canvas* to GLCanvas*
//
// Revision 1.16  2002/03/04 12:00:26  kersting
// directory structure changes
//
// Revision 1.15  2002/03/03 21:44:25  kosta
// VRS_TYPEINFO-macro rewritten
//
// Revision 1.14  2002/02/19 10:34:17  kosta
// undone all changes since 2002-02-15
//
// Revision 1.11  2002/02/04 12:58:41  kirsch
// moved setting of light in shadow application pass to ShadowTechniqueGL
// other minor changes
//
// Revision 1.10  2002/01/25 16:42:06  kirsch
// added canBeUsed() for techniques, and properly react in some OpenGL
// techniques when needed extensions are missing
//
// Revision 1.9  2002/01/15 16:25:55  kosta
// macros rewritten for a better namespace support
//
// Revision 1.8  2002/01/08 16:02:49  kosta
// dir structure for textures changed
//
// Revision 1.7  2001/11/21 10:26:11  nienhaus
// combine mode moved to opengl texture environment attribute
//
// Revision 1.6  2001/11/13 16:36:31  kirsch
// changed line feed to unix style (removed control-M)
//
// Revision 1.5  2001/11/07 12:34:42  kirsch
// setAlphaMapResolution did not change size of PBufferCanvasGL
//
// Revision 1.4  2001/09/05 14:14:36  kirsch
// Documentation updates
//
// Revision 1.3  2001/08/13 16:23:01  kirsch
// small performance improvements
//
// Revision 1.2  2001/08/09 15:37:10  kirsch
// Added shadows in OpenGL, created with alpha depthmaps.
// Still experimental, some flaws
//
// Revision 1.1.2.2  2001/06/28 12:26:11  kirsch
// Removed BLEND_MIN_MAX, i.E., application of
// alpha-textures in two passes. Cleaned up code a bit.
//
// Revision 1.1.2.1  2001/06/22 15:28:40  kirsch
// Added shadow-attributes and depthmapshadowtechniquegl.
// Still broken! Don't Use! Only for Distributing!
//

#ifndef VRS_OPENGL_DEPTHMAPSHADOWTECHNIQUEGL_H
#define VRS_OPENGL_DEPTHMAPSHADOWTECHNIQUEGL_H

// This header file defines                                                 //
//    * DepthmapShadowTechniqueGL                                           //
//    * AlphaTextureShadowTechniqueGL                                       //
//    * DepthTextureShadowTechniqueGL                                       //

#include <vrs/opengl/shadowtechniquegl.h>
#include <vrs/bounds.h>
#include <vrs/matrix.h>

namespace VRS {

class PBufferCanvasGL;
class PBufferManagerGL;
class Texture2DGL;
class TextureUnitSettingGL;
template <typename T, typename V> class CachedResource;

//                       DepthmapShadowTechniqueGL                          //

class VRS_CORE_API DepthmapShadowTechniqueGL : public ShadowTechniqueTemplateGL {
public: 
    DepthmapShadowTechniqueGL(int resolution);
    void setDepthmapResolution(int);
    int getDepthmapResolution() const;

    VRS_TYPEINFO(DepthmapShadowTechniqueGL, ShadowTechniqueTemplateGL);
    VRS_SERIALIZABLE_ABSTRACT_CLASS(DepthmapShadowTechniqueGL);

protected:

    struct DepthMapInfo {
        DepthMapInfo() : depthMap_(NULL), transaction_(currentTransactionNo()) { }
        SO<Texture2DGL> depthMap_;
        TransactionNo transaction_;
        Matrix projection_; 
        Matrix view_;
    };

    SO<CachedResource<SO<Light>, DepthMapInfo> > depthMapDict_;

    virtual bool addNextBuildDepthMapPass(Iterator<SO<Light> >* lightItr, Engine* engine);

    void createPBuffer(Engine*);
    void freePBuffer(Engine*);
    PBufferCanvasGL* PBuffer();
    void preparePBuffer(Engine*);
    void releasePBuffer(Engine*);
public:
    static int getViewFromLight(const Light*, Engine*, const Bounds&, 
        Matrix& proj, Matrix& view);
    static double getAngleOfPerspectiveFrustum(const Vector&, const Bounds&);
private:

    int depthmapResolution_;

    bool pbufferIsPrepared_;

    SO<PBufferManagerGL> pbuffermgr_;
    SO<PBufferCanvasGL>  pbuffer_;
};

inline int DepthmapShadowTechniqueGL::getDepthmapResolution() const {
    return depthmapResolution_;
}

inline PBufferCanvasGL* DepthmapShadowTechniqueGL::PBuffer() { 
    return pbuffer_; 
}

//                     AlphaTextureShadowTechniqueGL                        //

class VRS_CORE_API AlphaTextureShadowTechniqueGL : public DepthmapShadowTechniqueGL  {
public: 
    AlphaTextureShadowTechniqueGL(int alphaMapResolution = 512);
    virtual bool isSupported(Engine*, bool verbose) const;
    virtual int rate(Engine*) const;
    VRS_TYPEINFO(AlphaTextureShadowTechniqueGL, ShadowTechniqueTemplateGL);
    VRS_SERIALIZABLE(AlphaTextureShadowTechniqueGL);

protected:

        // Implementations of the hooks defined by the ShadowTechniqueTemplateGL
    virtual void startHook(Engine*);
    virtual void stopHook(Engine*);

    virtual bool preparePassHook(Engine*);
    virtual void finishPassHook(Engine*);
    virtual void nextPassHook(Engine*);

    virtual bool prepareEvalHook(Engine* engine, const Shape* shape);
    virtual void finishEvalHook(Engine* engine, const Shape* shape, bool render);

    virtual void setupShadowTest(bool onOff, Engine*);
    virtual void toggleShadowTest(bool receiving, Engine*);

private:
    
    SO<TextureUnitSettingGL> alphaDepthTextureSetting_;
    SO<TextureUnitSettingGL> alphaRampTextureSetting_;

    int stencilValue_;

    Matrix originalModelview_;
    Matrix originalProjection_;
    Matrix orientInverse_;

    Bounds sceneBoundingBox_;
};

//                     DepthTextureShadowTechniqueGL                        //

class VRS_CORE_API DepthTextureShadowTechniqueGL : public DepthmapShadowTechniqueGL {
public: 
    DepthTextureShadowTechniqueGL(int depthTextureResolution = 512, double roffset = 0.01);
    virtual bool isSupported(Engine*, bool verbose) const;
    virtual int rate(Engine*) const;
    VRS_TYPEINFO(DepthTextureShadowTechniqueGL, ShadowTechniqueTemplateGL);
    VRS_SERIALIZABLE(DepthTextureShadowTechniqueGL);

protected:

        // Implementations of the hooks defined by the ShadowTechniqueTemplateGL
    virtual void startHook(Engine*);
    virtual void stopHook(Engine*);

    virtual bool preparePassHook(Engine*);
    virtual void finishPassHook(Engine*);

    virtual void nextPassHook(Engine*);

    virtual bool prepareEvalHook(Engine* engine, const Shape* shape);
    virtual void finishEvalHook(Engine* engine, const Shape* shape, bool render);

    virtual void setupShadowTest(bool onOff, Engine*);
    virtual void toggleShadowTest(bool receiving, Engine*);

private:
    double roffset_;

    mutable bool haveStencil_;
    mutable bool haveAlpha_;

    SO<TextureUnitSettingGL> depthTextureSetting_;

    int stencilValue_;

    Matrix originalModelview_;
    Matrix originalProjection_;
    Matrix orientInverse_;

    Bounds sceneBoundingBox_;
};

} // namespace VRS

#endif // VRS_OPENGL_DEPTHMAPSHADOWTECHNIQUEGL_H

---

Generated on Fri May 24 06:00:16 2013 by Doxygen 1.5.6

© 2001-2010 Hasso-Plattner-Institut | Impressum | Contact