simgear/canvas/elements/CanvasGroup.hxx

   1 // A group of 2D Canvas elements
   2 //
   3 // Copyright (C) 2012  Thomas Geymayer <tomgey@gmail.com>
   4 //
   5 // This library is free software; you can redistribute it and/or
   6 // modify it under the terms of the GNU Library General Public
   7 // License as published by the Free Software Foundation; either
   8 // version 2 of the License, or (at your option) any later version.
   9 //
  10 // This library is distributed in the hope that it will be useful,
  11 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13 // Library General Public License for more details.
  14 //
  15 // You should have received a copy of the GNU Library General Public
  16 // License along with this library; if not, write to the Free Software
  17 // Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301, USA
  18
  19 #ifndef CANVAS_GROUP_HXX_
  20 #define CANVAS_GROUP_HXX_
  21
  22 #include "CanvasElement.hxx"
  23
  24 #include <list>
  25
  26 namespace simgear
  27 {
  28 namespace canvas
  29 {
  30
  31   typedef std::map<std::string, ElementFactory> ElementFactories;
  32
  33   class Group:
  34     public Element
  35   {
  36     public:
  37       static const std::string TYPE_NAME;
  38       static void staticInit();
  39
  40       typedef std::list< std::pair< const SGPropertyNode*,
  41                                     ElementPtr
  42                                   >
  43                        > ChildList;
  44
  45       Group( const CanvasWeakPtr& canvas,
  46              const SGPropertyNode_ptr& node,
  47              const Style& parent_style = Style(),
  48              Element* parent = 0 );
  49       virtual ~Group();
  50
  51       ElementPtr createChild( const std::string& type,
  52                               const std::string& id = "" );
  53       ElementPtr getChild(const SGPropertyNode* node);
  54       ElementPtr getChild(const std::string& id);
  55       ElementPtr getOrCreateChild( const std::string& type,
  56                                    const std::string& id );
  57
  58       template<class T>
  59       SGSharedPtr<T> createChild(const std::string& id = "")
  60       {
  61         return dynamic_cast<T*>( createChild(T::TYPE_NAME, id).get() );
  62       }
  63
  64       template<class T>
  65       SGSharedPtr<T> getChild(const SGPropertyNode* node)
  66       {
  67         return dynamic_cast<T*>( getChild(node).get() );
  68       }
  69
  70       template<class T>
  71       SGSharedPtr<T> getChild(const std::string& id)
  72       {
  73         return dynamic_cast<T*>( getChild(id).get() );
  74       }
  75
  76       template<class T>
  77       SGSharedPtr<T> getOrCreateChild(const std::string& id)
  78       {
  79         return dynamic_cast<T*>( getOrCreateChild(T::TYPE_NAME, id).get() );
  80       }
  81
  82       /**
  83        * Get first child with given id (breadth-first search)
  84        *
  85        * @param id  Id (value if property node 'id') of element
  86        */
  87       ElementPtr getElementById(const std::string& id);
  88
  89       virtual void clearEventListener();
  90
  91       virtual void update(double dt);
  92
  93       virtual bool traverse(EventVisitor& visitor);
  94
  95       virtual bool setStyle( const SGPropertyNode* child,
  96                              const StyleInfo* style_info = 0 );
  97
  98       virtual osg::BoundingBox getTransformedBounds(const osg::Matrix& m) const;
  99
 100     protected:
 101
 102       static ElementFactories   _child_factories;
 103
 104       /**
 105        * Overload in derived classes to allow for more/other types of elements
 106        * to be managed.
 107        */
 108       virtual ElementFactory getChildFactory(const std::string& type) const;
 109
 110       virtual void childAdded(SGPropertyNode * child);
 111       virtual void childRemoved(SGPropertyNode * child);
 112       virtual void childChanged(SGPropertyNode * child);
 113
 114       void handleZIndexChanged(ElementPtr child, int z_index = 0);
 115
 116       ElementPtr getChildByIndex(size_t index) const;
 117       ElementPtr findChild( const SGPropertyNode* node,
 118                             const std::string& id ) const;
 119   };
 120
 121 } // namespace canvas
 122 } // namespace simgear
 123
 124 #endif /* CANVAS_GROUP_HXX_ */