groupnode.h

Go to the documentation of this file.

//--- < GROUPNODE.H > -----------| ViewGraph - A Flexible Graph view Framework |
//
// Group nodes keep a bunch of other 
// nodes underneath and are used to 
// group the behaviour of certain nodes
//
// Derive from GroupNode to implement specific
// group behaviour, as SelectionGroupNode does.
// 
// $Author: botik32 $
// $Revision: 1.10 $
// $Date: 2004/06/02 08:03:55 $
//-----------------------------------------------------------------------------/

#ifndef GROUPNODE_H
#define GROUPNODE_H

#include <list>
#include <cZUI/basescenenode.h>

class Event;

class GroupNode : public BaseSceneNode{
protected:
        long childcount, alloccount;
        /// Cached boundrect.
        double brx1, bry1, brx2, bry2;
        /// Cached scenerect.
        double scx1, scy1, scx2, scy2;
        BaseSceneNode **children_arr, **childbuf;
        void recompute_boundrect( void );
        void recompute_scenerect( void );
        /// recomputing the boundrect at initial
        /// loading stage may slow down the app.
        /// Turn dynamic_boundrect off when you
        /// first load the children, then make
        /// sure to turn it back on if you have
        /// a dynamic scene. Default is true.
        bool dynamic_boundrect, cache_boundrect;
public:
        GroupNode( bool cache_br = true );
        
        /// The default Event handler passes 
        /// all events down to its children
        virtual bool handle_event( Event * );
        // Repaint events try all nodes in reverse 
        // order regardless of outcome.
        bool handle_event( RepaintEvent * );
        
        /// The default Message handler just passes 
        /// the request down to its children in hope
        /// that the target is one of them.
        virtual bool handle_message( Message * );

        // reserve space for N nodes in cases where the 
        // number of nodes is known
        void reserve( long );

        void add_child( SceneNode * );
        void remove_child( SceneNode * );
        void remove_child( int idx );
        void remove_all_children( void );
        void add_child( GroupNode * );
        void remove_child( GroupNode * );
        void get_boundrect( double&, double&, double&, double& );
        void get_scenerect( double&, double&, double&, double& );

        void translate( double dx, double dy );
        void rotate( double ax, double ay, double rad );
        void move( double newx, double newy );

        // If your node paints some stuff over the children, 
        // specify additional checks here
        virtual bool check_event_fitspixels( Event * );

        // Handles SceneEvents by recomputing the boundrect
        virtual void listen_event( Event * );

        void toggle_dynamic( bool );

        virtual ~GroupNode();
};

#endif

/// $Log: groupnode.h,v $
/// Revision 1.10  2004/06/02 08:03:55  botik32
/// Removed fitsall bool from GroupNode
/// Added get_scenerect() to BaseSceneNode
/// Added get_scenerect() to HUDGroupNode
/// Added recompute_scenerect() to GroupNode
/// Changed GroupNode's recompute_boundrect behaviour to
/// accept FitAllRect bounds again
///
/// Revision 1.9  2004/06/02 05:42:27  botik32
/// With the changes in the boundrect ignoring invalid and
/// fitall bounds, event handling got messed up. Fixed this
/// by adding a fitsall bool to GroupNode.
///
/// Revision 1.8  2004/05/24 16:23:57  botik32
/// Added missing destructor to GroupNode
///
/// Revision 1.7  2004/05/19 16:40:36  botik32
/// Bugfixes and enhancements:
/// Added repaint_due() and brepaint_due to ScrollableView
/// Fixed repaint decisions in GraphWindow to work for multiple-window
/// scenes
/// Fixed ScrollableView to call surfacedriver->clear() in constructor
/// Changed mapchooser to use a smaller resolution world map
///
/// Revision 1.6  2004/05/14 18:35:08  botik32
/// Fixed a bug related to HUDGroups and a few that I do not
/// remember now.
///
/// Revision 1.5  2004/05/08 19:19:16  botik32
/// Fixed a bad bug in rastermanip's scale2 code
///
/// Revision 1.4  2004/05/05 07:10:14  botik32
/// Added ContainerNode class for simple element selection/unselection
/// More bugfixes
///
/// Revision 1.3  2004/04/30 12:39:21  botik32
/// Numerous changes related to making the SceneChangedEvents
/// to work.
/// - Moved listen_event() from BaseSceneNode to EventListener class
/// - Made GroupNode listen to the added children's SceneChangedEvents
/// - Changed Camera to listen to layers' SceneChangedEvents
/// - Moved eventlistener list cleanup from Camera to EventHub class
///   where it belonged in the first place
///
/// Revision 1.2  2004/04/18 09:22:01  botik32
/// Changes to groupnode interface, timedeventmanager interface
/// and implementation
///
/// Revision 1.1.1.1  2004/03/26 10:50:23  botik32
/// Initial release
///
/// Revision 1.1.1.1  2004/03/26 08:53:33  botik
/// initial import
///
///
/// Revision 1.13  2003/11/18 11:23:12  botik
/// Fixed a bug in scenenode that mucked message passing
/// Removed some old handlers from basescenenode that caused
/// problems with repainting under a group
/// Groups work now okay.
///
/// Revision 1.12  2003/11/18 10:17:24  botik
/// Got HUDGroup to partially work
/// Fixed a typo in leafnode that caused invalid
/// movement on scroll
///
/// Revision 1.11  2003/11/17 16:22:41  botik
/// bugfixes in layernode
///
/// Revision 1.10  2003/11/13 18:50:18  botik
/// Fixed (almost) clear and update rect behaviour.
/// Added update_rect to framework and sdl wrapper.
/// Added mouse_in/mouse_out handling
/// Fixed message handling
/// Many small bugfixes
///
/// Revision 1.9  2003/11/13 12:50:51  botik
/// Refined the event handling architecture
/// Got the event handling to recognize and treat mouse
/// events accordingly
/// Important fixes to ./Makefile
///
/// Revision 1.8  2003/11/11 15:30:58  botik
/// Added and compiled second framework test,
/// fixed along a few bugs.
///
/// Revision 1.7  2003/11/09 15:23:01  botik
/// Got GraphDisplay to compile and run.
///
/// Revision 1.6  2003/11/08 18:54:59  botik
/// Changed handle_event to return bool
///
/// Revision 1.5  2003/11/03 16:45:16  botik
/// Some changes to scene nodes after careful
/// consideration
///
/// Revision 1.4  2003/10/30 14:21:43  botik
/// Modified layernode to handle CameraOn/CameraOff events
///
/// Revision 1.3  2003/10/28 15:43:55  botik
/// More work on event framework and camera composition and
/// z-ordering
///
/// Revision 1.2  2003/10/24 16:29:10  botik
/// Added more scene support: special scene nodes as well as a
/// camera class that acts as glue between the graph master and the
/// surface.
///
/// Revision 1.1  2003/10/21 17:39:00  botik
/// Added preliminary scene support
///

---