VRS - The Virtual Rendering System

version 3.3

timegroup.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: timegroup.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: Exp $
// $Author: Konstantin_Baumann $
//
// $Log: timegroup.h,v $
// Revision 1.29  2005/05/12 12:50:41  lorenz
// Fixed comparison in TimeMark
//
// Revision 1.28  2005/01/03 01:43:10  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/10/28 14:16:01  basch
// Class comment changed (Doxygen style)
//
// Revision 1.26  2004/09/17 07:36:19  heinrich
// bugfix: all behavior nodes that will become children of the time group
// are willfully deactivated since behavior nodes are active by default.
// They will be activated step by step during the evaluation of the time
// group.
//
// Revision 1.25  2004/04/06 13:12:15  baumann
// a time event can store the moment of the previous time event, too
//
// Revision 1.24  2004/03/12 16:28:41  baumann
// macros VRS_NAMESPACE_BEGIN/_END expanded and removed
//
// Revision 1.23  2004/01/19 11:44:00  baumann
// serialization mechanism improved
//
// Revision 1.22  2003/11/07 14:19:26  kirsch
// removed leading underscore from include guards
//
// Revision 1.21  2003/06/06 11:52:08  kirsch
// include callback.h
//
// Revision 1.20  2003/02/24 10:05:57  baumann
// changed return type of BehaviorNode::handle() and Manipulator::drag*()
// from "int" to "BehaviorNode::InvalidationHint"
//
// Revision 1.19  2002/11/21 12:13:36  baumann
// comments added
//
// Revision 1.18  2002/11/20 13:02:43  baumann
// progress callback added
//
// Revision 1.17  2002/10/29 10:32:53  baumann
// macros VRS_CLASSNAME_* and VRS_IMPL_TYPEINFO_* removed
//
// Revision 1.16  2002/07/02 15:23:48  baumann
// non-persistent containers now have the prefix NonPersistent, e.g. NonPersistentArray<T>
// persistent containers now have no prefix, e.g. Array<T>
//
// Revision 1.15  2002/06/24 14:14:47  baumann
// code cleanup
//
// Revision 1.14  2002/05/15 16:05:11  baumann
// unneeded method BehaviorNode::canHandle() removed (from all sub classes too)
//
// Revision 1.13  2002/03/04 12:04:17  kersting
// directory structure changes
//
// Revision 1.12  2002/03/03 21:44:26  kosta
// VRS_TYPEINFO-macro rewritten
//
// Revision 1.11  2002/03/03 16:37:59  kosta
// changed VRS-typeinfo to C++-typeid
//
// Revision 1.10  2002/02/27 15:03:29  kersting
// renamed Time to VRSTime
//
// Revision 1.9  2002/02/19 10:34:21  kosta
// undone all changes since 2002-02-15
//
// Revision 1.6  2002/02/12 15:04:34  kosta
// VRS container classes completely rewritten using STL
//
// Revision 1.5  2002/02/05 07:48:26  kosta
// new persistency macros:
//     VRS_SERIALIZABLE(CLASS_NAME);
//     VRS_SERIALIZABLE_ABSTRACT_CLASS(CLASS_NAME);
//     VRS_SERIALIZABLE_NO_SO_CLASS(CLASS_NAME)
//
// Revision 1.4  2002/02/04 11:54:37  kosta
// persistency rewritten (for better namespace support)
//
// Revision 1.3  2002/01/15 16:25:55  kosta
// macros rewritten for a better namespace support
//
// Revision 1.2  2001/11/13 16:36:32  kirsch
// changed line feed to unix style (removed control-M)
//
// Revision 1.1.1.1  2001/06/08 08:09:21  kirsch
// imported alpha-version by olli 
//


#ifndef VRS_TIMEGROUP_H
#define VRS_TIMEGROUP_H

#include <vrs/callback.h>
#include <vrs/sg/polybehavior.h>
#include <vrs/sg/timeevent.h>
#include <vrs/container/deque.h>
#include <vrs/container/array.h>

namespace VRS {

class VRS_CORE_API TimeGroup : public PolyBehavior {
   
public:
    TimeGroup();

    void append(BehaviorNode* node);
    void prepend(BehaviorNode* node);
    void insert(int, BehaviorNode* node);
    void refreshMarks(BehaviorNode* b);

    void remove(int i);
    void remove(BehaviorNode* node);
    void clear();
    bool contains(BehaviorNode* node) const;

    virtual int childNodes() const;
    virtual BehaviorNode* childNode(int i) const;

    virtual TimeRequirement timeRequirement() const;

    virtual void activate(int hint=BehaviorNode::NoHint);
    virtual void deactivate(int hint=BehaviorNode::NoHint);

    void registerProgressCB(Callback2<const TimeGroup*, unsigned int>* cb);
    void unregisterProgressCB(Callback2<const TimeGroup*, unsigned int>* cb);
    virtual BehaviorNode::InvalidationHint handle(Event*);
    virtual void modified();

    struct TimeMark {
        VRSTime time_;
        int order_, child_;
        bool bound_;

        bool operator==(const TimeMark& m) const {
            return ((time_ == m.time_)
                    && (order_ == m.order_)
                    && (child_ == m.child_)
                    && (bound_ == m.bound_));
        }
        bool operator<(const TimeMark& m) const {
            return ((time_ < m.time_)
                    || (((time_ == m.time_) && (order_ < m.order_))
                        || ((time_ == m.time_) && (order_ == m.order_) && (child_ < m.child_))));
        }
    };

    struct ChildInterval {
        VRSTime start_;
        VRSTime end_;

        bool operator == (ChildInterval& i) {
            return (start_ == i.start_ && end_ == i.end_);
        }
    };

    VRS_TYPEINFO(TimeGroup, PolyBehavior);

protected:
    virtual void childConfiguration(bool inserted, BehaviorNode* node);

    virtual TimeRequirement buildTimeRequirements() = 0;
    virtual void buildLifeTimes(TimeEvent* firstTimeEvent) = 0;

    void registerChild (int child, VRSTime start, VRSTime end);

    TimeEvent* timeEvent(const Moment&);

private:
    SO<TimeEvent> timeEvent_;

    void callProgressCB(unsigned int childIndex) const;
    int findMark (VRSTime time, int order);
    int processToMark (int, bool shutDown);
    int callChildren (VRSTime);

    SO<Deque<SO<BehaviorNode> > > children_;
    SO<NonPersistentArray<TimeMark> > marks_;
    SO<NonPersistentArray<ChildInterval> > intervals_;
    VRSTime lastTime_;
    int lastMark_;
    int direction_;

    TimeRequirement totalTimeReq_;
    VRSTime startTime_;
    VRSTime endTime_;
    Clock* clock_;

    bool buildTimeReq_;
    bool buildLifeTimes_;
};

} // namespace VRS

#endif // VRS_TIMEGROUP_H

---

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

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