Open Inventor Reference
MeVis/ThirdParty/Sources/Inventor/inventor/lib/database/include/Inventor/elements/SoElement.h
Go to the documentation of this file.
00001 /*
00002  *
00003  *  Copyright (C) 2000 Silicon Graphics, Inc.  All Rights Reserved. 
00004  *
00005  *  This library is free software; you can redistribute it and/or
00006  *  modify it under the terms of the GNU Lesser General Public
00007  *  License as published by the Free Software Foundation; either
00008  *  version 2.1 of the License, or (at your option) any later version.
00009  *
00010  *  This library is distributed in the hope that it will be useful,
00011  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
00012  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00013  *  Lesser General Public License for more details.
00014  *
00015  *  Further, this software is distributed without any warranty that it is
00016  *  free of the rightful claim of any third person regarding infringement
00017  *  or the like.  Any license provided herein, whether implied or
00018  *  otherwise, applies only to this software file.  Patent licenses, if
00019  *  any, provided herein do not apply to combinations of this program with
00020  *  other software, or any other product whatsoever.
00021  * 
00022  *  You should have received a copy of the GNU Lesser General Public
00023  *  License along with this library; if not, write to the Free Software
00024  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
00025  *
00026  *  Contact information: Silicon Graphics, Inc., 1600 Amphitheatre Pkwy,
00027  *  Mountain View, CA  94043, or:
00028  * 
00029  *  http://www.sgi.com 
00030  * 
00031  *  For further information regarding this notice, see: 
00032  * 
00033  *  http://oss.sgi.com/projects/GenInfo/NoticeExplan/
00034  *
00035  */
00036 
00037 
00038 /*
00039  * Copyright (C) 1990,91   Silicon Graphics, Inc.
00040  *
00041  _______________________________________________________________________
00042  ______________  S I L I C O N   G R A P H I C S   I N C .  ____________
00043  |
00044  |   $Revision: 1.1.1.1 $
00045  |
00046  |   Description:
00047  |      This file defines the abstract base SoEXTENDER SoElement class.
00048  |
00049  |   Classes:
00050  |      SoElement
00051  |
00052  |   Author(s)          : Paul S. Strauss
00053  |
00054  ______________  S I L I C O N   G R A P H I C S   I N C .  ____________
00055  _______________________________________________________________________
00056  */
00057 
00058 #ifndef  _SO_ELEMENT
00059 #define  _SO_ELEMENT
00060 
00061 #include <Inventor/system/SbSystem.h>
00089 
00090 #include <Inventor/SoType.h>
00091 #include <Inventor/misc/SoState.h>
00092 #include <Inventor/nodes/SoNode.h>
00093 
00094 class SoTypeList;
00095 
00096 SoEXTENDER class INVENTOR_API SoElement {
00097 
00098   public:
00101     virtual void        init(SoState *state);
00102 
00105     virtual void        push(SoState *state);
00106     virtual void        pop(SoState *state, const SoElement *prevTopElement);
00107 
00109     virtual void        print(FILE *fp) const;
00110 
00114     virtual SbBool      matches(const SoElement *elt) const = 0;
00115 
00118     virtual SoElement   *copyMatchInfo() const = 0;
00119 
00121     static SoType       getClassTypeId()        { return classTypeId; }
00122 
00124     SoType              getTypeId() const       { return typeId; }
00125 
00126   SoINTERNAL public:
00128     static void         initElements();
00129 
00131     static void         initClass();
00132 
00134     static int          getNumStackIndices()    { return nextStackIndex; }
00135 
00137     static SoType       getIdFromStackIndex(int stackIndex);
00138 
00140     int                 getStackIndex() const   { return stackIndex; }
00141 
00143     void                setDepth(int dpth)              { depth = dpth; }
00144     void                setNext(SoElement *nxt)         { next = nxt; }
00145     void                setNextInStack(SoElement *nxt)  { nextInStack = nxt; }
00146     void                setNextFree(SoElement *nxt)     { nextFree = nxt; }
00147 
00149     int                 getDepth() const        { return depth; }
00150     SoElement *         getNext()  const        { return next; }
00151 
00153     virtual ~SoElement();
00154 
00155   protected:
00157     SoElement();
00158 
00162     static SoElement *  getElement(SoState *state, int stackIndex)
00163         { return state->getElement(stackIndex); }
00164 
00167     static inline const SoElement * getConstElement(SoState *state,
00168                                                     int stackIndex);
00169 
00173     void                capture(SoState *state) const
00174         { if (state->isCacheOpen()) captureThis(state); }
00175 
00178     virtual void        captureThis(SoState *state) const;
00179 
00181     void                setTypeId(SoType id)            { typeId = id; }
00182 
00184     void                setStackIndex(int index)        { stackIndex = index; }
00185 
00187     SoElement *         getNextInStack() const          { return nextInStack; }
00188 
00190     SoElement *         getNextFree() const             { return nextFree; }
00191 
00192   SoINTERNAL protected:
00193     static int          classStackIndex;  
00194 
00196     static int          createStackIndex(SoType id);
00197 
00198   private:
00200     static SoType       classTypeId;    
00201     SoType              typeId;         
00202 
00204     static int          nextStackIndex; 
00205     static SoTypeList   *stackToType;   
00206     int                 stackIndex;     
00207 
00209 
00216 
00217     SoElement           *nextInStack;   
00218     SoElement           *nextFree;      
00219 
00220     SoElement           *next;          
00221 
00222     int                 depth;          
00223 friend class SoState;
00224 };
00225 
00233 
00234 inline const SoElement *SoElement::getConstElement(SoState *state,
00235                                                    int stackIndex)
00238 {
00239     const SoElement * elt = (state->getConstElement(stackIndex));
00240     elt->capture(state);
00241     return elt;
00242 }
00243 
00244 #endif /* _SO_ELEMENT */