VRS - The Virtual Rendering System

version 3.3

shadowtechniquegl.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: shadowtechniquegl.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.28  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.27  2004/11/09 15:07:24  kirsch
// further changes to class comments due to doxygen
//
// Revision 1.26  2004/08/05 14:47:10  kirsch
// numerous cleanups and minor changes
//
// Revision 1.25  2004/03/12 16:28:40  baumann
// macros VRS_NAMESPACE_BEGIN/_END expanded and removed
//
// Revision 1.24  2004/01/19 11:43:58  baumann
// serialization mechanism improved
//
// Revision 1.23  2004/01/19 07:28:02  baumann
// serialization mechanism improved
//
// Revision 1.22  2003/11/07 14:19:25  kirsch
// removed leading underscore from include guards
//
// Revision 1.21  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.20  2002/12/13 09:32:34  kirsch
// fixed typeinfo bug
//
// Revision 1.19  2002/12/12 13:04:07  kirsch
// Technique constructor does not get a number denoting the number of rendering
// passes anymore, only an empty array of passes is created by default.
//
// Revision 1.18  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.17  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.16  2002/10/29 10:32:52  baumann
// macros VRS_CLASSNAME_* and VRS_IMPL_TYPEINFO_* removed
//
// Revision 1.15  2002/07/04 14:23:56  kirsch
// removed IteratorWrapper
//
// Revision 1.14  2002/06/24 14:03:38  baumann
// changed List<T> to Array<T>
//
// Revision 1.13  2002/06/12 09:48:46  kirsch
// added constructLightIterator() ( functionality formerly in start() )
//
// Revision 1.12  2002/03/04 12:00:26  kersting
// directory structure changes
//
// Revision 1.11  2002/03/03 21:44:26  kosta
// VRS_TYPEINFO-macro rewritten
//
// Revision 1.10  2002/02/19 10:34:19  kosta
// undone all changes since 2002-02-15
//
// Revision 1.7  2002/02/04 12:58:41  kirsch
// moved setting of light in shadow application pass to ShadowTechniqueGL
// other minor changes
//
// Revision 1.6  2002/01/15 16:25:55  kosta
// macros rewritten for a better namespace support
//
// Revision 1.5  2001/11/13 16:36:31  kirsch
// changed line feed to unix style (removed control-M)
//
// Revision 1.4  2001/09/05 14:14:36  kirsch
// Documentation updates
//
// Revision 1.3  2001/08/20 13:47:37  kirsch
// Stencilbuffer was cleared unnecessarily in TechniqueGL
//
// 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.1  2001/06/22 15:28:40  kirsch
// Added shadow-attributes and depthmapshadowtechniquegl.
// Still broken! Don't Use! Only for Distributing!
//

#ifndef VRS_OPENGL_SHADOWTECHNIQUEGL_H
#define VRS_OPENGL_SHADOWTECHNIQUEGL_H

// This header file defines ShadowTechniqueGL and ShadowTechniqueTemplateGL //

#include <vrs/light.h>
#include <vrs/opengl/techniquegl.h>

namespace VRS {

//                          ShadowTechniqueGL                               //

class ShadowCaster;
class Shadowed;
class ShadowTechniqueTemplateGL;
template<typename T> class NonPersistentArray;

class VRS_CORE_API ShadowTechniqueGL : public TechniqueGL {
public:
    ShadowTechniqueGL();
    static void install(ShadowTechniqueTemplateGL*);
    static bool uninstall(ShadowTechniqueTemplateGL*);
    static Iterator<SO<ShadowTechniqueTemplateGL> >* shadowTechniques();

    virtual bool canBeUsed(Engine*) const;
    virtual void start(Engine*);
    virtual void stop(Engine*);
    virtual void activatePass(int pass);
    virtual bool usesPass(int pass) const;
    virtual bool preparePass(Engine*);
    virtual void finishPass(Engine*);
    virtual void nextPass(Engine*);
    virtual bool prepareEval(Engine*, const Shape*);
    virtual void finishEval(Engine*, const Shape*);
    VRS_TYPEINFO(ShadowTechniqueGL, TechniqueGL);
    VRS_SERIALIZABLE(ShadowTechniqueGL);

private:
    mutable SO<ShadowTechniqueTemplateGL> realShadowTechnique_;
    bool started_;
};

//                          ShadowTechniqueTemplateGL                       //

class VRS_CORE_API ShadowTechniqueTemplateGL : public TechniqueGL  {
public: 
    ShadowTechniqueTemplateGL();
    virtual bool isSupported(Engine*, bool verbose) const = 0;
    virtual int rate(Engine*) const = 0;
    virtual bool canBeUsed(Engine*) const;
    virtual void start(Engine*);
    virtual void stop(Engine*);
    virtual bool preparePass(Engine*);
    virtual void finishPass(Engine*);
    virtual void nextPass(Engine*);
    virtual bool prepareEval(Engine*, const Shape*);
    virtual void finishEval(Engine*, const Shape*);
    VRS_TYPEINFO(ShadowTechniqueTemplateGL, TechniqueGL);
    VRS_SERIALIZABLE_ABSTRACT_CLASS(ShadowTechniqueTemplateGL);

protected:

    virtual void startHook(Engine*) = 0;
    virtual void stopHook(Engine*) = 0;
    
    virtual bool preparePassHook(Engine*) = 0;
    virtual void finishPassHook(Engine*) = 0;
    virtual void nextPassHook(Engine*) = 0;

    virtual bool prepareEvalHook(Engine*, const Shape*) = 0;
    virtual void finishEvalHook(Engine*, const Shape*, bool render) = 0;
    void singleLightAddSettings(Engine* engine, bool on);

    virtual void setupShadowTest(bool onOff, Engine*) = 0;
    virtual void toggleShadowTest(bool receiving, Engine*) = 0;
    virtual Iterator<SO<Light> >* newLightIterator() const;
    void setLight(Light* mylight, bool am, bool df, bool sp, Engine* engine);
    virtual void resetLight(Engine*);
    enum LightAdjustment { OnlyAmbient, OnlyDiffuseAndSpecular };
    VRS_SERIALIZABLE_CLASS_ENUM(LightAdjustment);
    virtual void adjustLights(Engine*, LightAdjustment, Light* = 0);

protected:
    unsigned int lightIndex_;
    Light* currentLight() const;

    virtual Iterator<SO<ShadowCaster> >* getShadowCasterAttributesInScene() const;
    virtual Iterator<SO<Shadowed> >* getShadowedAttributesInScene() const;

private:
    SO<NonPersistentArray<SO<Light> > > lightsWithShadows_;
    // list of shadowed lights contained in the scene graph (valid after GATHERLIGHTS)

    SO<NonPersistentArray<SO<Light> > > lightsInScene_;
    // temp. light list (valid after GATHERLIGHTS)    
    SO<NonPersistentArray<SO<ShadowCaster> > > castersInScene_;
    // shadow casting attributes in the scene graph (valid after GATHERLIGHTS)
    SO<NonPersistentArray<SO<Shadowed> > > receiversInScene_;
    // shadowed attributes in the scene graph (valid after GATHERLIGHTS)

    bool render_;
    int recursions_;
};

template <class T>
class ReferencesTo {
public:
    ReferencesTo(const Light* light) : light_(light) {};
    bool operator() (const PolyAttribute* attr) const { 
        const T* shadowattr = VRS_Cast(T, attr);
        return light_ == shadowattr->getLightSource();
    }
private:
    const Light* light_;
};

// usage:
//      SO<Iterator<SO<PolyAttribute> > > itr = 
//          engine->newPolyAttributeIterator(Shadowed::ClassNameVRS(), ...);
//
//      found = std::find_if(itr->beginSTL(), itr->endSTL(), 
//          ReferencesTo<Shadowed>(currentLight())) != itr->endSTL();
//
//      this means a shadow casting attribute that aggregates currentLight() is contained
//      in the iterator. 
//
//      works for shadow casting attribute and shadowed attributes. 

} // namespace VRS

#endif // VRS_OPENGL_SHADOWTECHNIQUEGL_H

---

Generated on Thu May 24 06:00:15 2012 by Doxygen 1.5.6

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