VRS - The Virtual Rendering System

version 3.3

technique.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: technique.h 4633 2005-01-03 01:43:11Z klimetschek $
// $Date: 2005-01-03 02:43:11 +0100 (Mon, 03 Jan 2005) $
// $Revision: 4633 $
// $State$
// $Author: klimetschek $
//
// $Log$
// Revision 1.33  2005/01/03 01:43:08  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.32  2004/11/05 13:58:09  basch
// Class comment changed (Doxygen style)
//
// Revision 1.31  2004/07/09 13:26:10  kirsch
// made getPass() const
//
// Revision 1.30  2004/06/17 14:33:09  kirsch
// cleanup: made pass_ and passArray_ private; added trivial accesor methods for them
//
// Revision 1.29  2004/03/12 16:28:39  baumann
// macros VRS_NAMESPACE_BEGIN/_END expanded and removed
//
// Revision 1.28  2004/01/19 11:43:57  baumann
// serialization mechanism improved
//
// Revision 1.27  2004/01/19 07:28:03  baumann
// serialization mechanism improved
//
// Revision 1.26  2003/11/30 14:40:57  kirsch
// reduced include dependencies
//
// Revision 1.25  2003/11/29 11:29:23  kirsch
// - added support for local poly attributes
// - removed PolyAttribute::switchDefault() and Attribute::rememberTransform()
// - renamed Engine::SwType: On/Off/All to Engine::SwitchType: ON/OFF/ALL
// - changed class hierarchy of TechniqueProcessor and Technique
// - GLCanvas::prepareRedisplay() / finishRedisplay() now push / pop standard attributes
//
// Revision 1.24  2003/11/07 14:19:24  kirsch
// removed leading underscore from include guards
//
// Revision 1.23  2003/07/23 17:04:49  baumann
// code cleanup (especially untabified)
//
// Revision 1.22  2003/01/14 08:20:47  kirsch
// made addPass() static
//
// Revision 1.21  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.20  2002/12/11 11:09:12  kirsch
// made activatePass virtual
//
// Revision 1.19  2002/11/30 17:01:12  kirsch
// cleaned up includes
//
// Revision 1.18  2002/11/29 09:54:49  kirsch
// cleaned up includes
//
// Revision 1.17  2002/10/29 10:32:52  baumann
// macros VRS_CLASSNAME_* and VRS_IMPL_TYPEINFO_* removed
//
// Revision 1.16  2002/04/12 12:28:14  kirsch
// removed numberOfPasses_
//
// Revision 1.15  2002/03/03 21:44:25  kosta
// VRS_TYPEINFO-macro rewritten
//
// Revision 1.14  2002/02/19 10:34:13  kosta
// undone all changes since 2002-02-15
//
// Revision 1.11  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.10  2002/01/15 16:25:54  kosta
// macros rewritten for a better namespace support
//
// Revision 1.9  2001/11/13 16:36:31  kirsch
// changed line feed to unix style (removed control-M)
//
// Revision 1.8  2001/09/13 11:11:36  kirsch
// made usesPass() virtual
//
// Revision 1.7  2001/09/05 10:56:11  kirsch
// Documentation updates
//
// Revision 1.6  2001/09/04 15:17:25  kirsch
// documentation updates, code cleanup
//
// Revision 1.5  2001/08/31 15:45:10  kirsch
// changed List to Array for faster access
// Post/Pretraversal is computed simplier
//
// Revision 1.4  2001/08/20 13:47:37  kirsch
// Stencilbuffer was cleared unnecessarily in TechniqueGL
//
// Revision 1.3  2001/08/01 12:36:51  kirsch
// removed REMOVECAMERA pass, now using posttraversal. This way,
// a problem with the trackball is fixed
//
// Revision 1.2  2001/07/26 15:23:22  kirsch
// enhanced engine to support rendering techniques
//
// Revision 1.1.2.3  2001/06/26 20:24:38  kirsch
// Added camera-attribute, painter and technique
//
// Revision 1.1.2.2  2001/06/20 17:34:01  kirsch
// Switches and TransformTable in Engine totally rewritten,
// posttraversal added. SceneConfiguration nodes are now
// properly installed.
//
// Revision 1.1.2.1  2001/06/14 10:23:40  kirsch
// techniques and techniqueprocessor, initial revision
//

#ifndef VRS_TECHNIQUE_H
#define VRS_TECHNIQUE_H

#include <vrs/renderobj.h>

namespace VRS {

class Engine;
class Shape;
template<typename T> class NonPersistentArray;

class VRS_CORE_API Technique : public RenderObj  {
    
public:
    Technique();

    virtual void start(Engine*);
    virtual void stop(Engine*);
    virtual void activatePass(int pass);
    virtual bool preparePass(Engine*) = 0;
    virtual void finishPass(Engine*) = 0;
    virtual void nextPass(Engine*);
    virtual bool usesPass(int pass) const;
    virtual bool prepareEval(Engine* engine, const Shape* shape) = 0;
    virtual void finishEval(Engine* engine, const Shape* shape) = 0;
    virtual ID target() const;
    virtual bool canBeUsed(Engine*) const;
    enum PassNumbers {
        PRE = 0,
        INITCAMERA = 1,
        MAIN = 100,
        POST = 1000
    };
    VRS_SERIALIZABLE_CLASS_ENUM(PassNumbers);
    VRS_TYPEINFO(Technique, RenderObj);

protected:

    void registerPass(int pass);
    int getPass() const;

    static void addPass(Engine*, int pass);
private:
    int pass_;
    SO<NonPersistentArray<int> > passArray_;
};

inline int Technique::getPass() const {
    return pass_;
}

} // namespace VRS

#endif // VRS_TECHNIQUE_H

---

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

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