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       boost::shared_ptr<T> createChild(const std::string& id = "")
  60       {
  61         return boost::dynamic_pointer_cast<T>( createChild(T::TYPE_NAME, id) );
  62       }
  63
  64       template<class T>
  65       boost::shared_ptr<T> getChild(const SGPropertyNode* node)
  66       {
  67         return boost::dynamic_pointer_cast<T>( getChild(node) );
  68       }
  69
  70       template<class T>
  71       boost::shared_ptr<T> getChild(const std::string& id)
  72       {
  73         return boost::dynamic_pointer_cast<T>( getChild(id) );
  74       }
  75
  76       template<class T>
  77       boost::shared_ptr<T> getOrCreateChild(const std::string& id)
  78       {
  79         return
  80           boost::dynamic_pointer_cast<T>( getOrCreateChild(T::TYPE_NAME, id) );
  81       }
  82
  83       /**
  84        * Get first child with given id (breadth-first search)
  85        *
  86        * @param id  Id (value if property node 'id') of element
  87        */
  88       ElementPtr getElementById(const std::string& id);
  89
  90       virtual void clearEventListener();
  91
  92       virtual void update(double dt);
  93
  94       virtual bool traverse(EventVisitor& visitor);
  95
  96       virtual bool setStyle( const SGPropertyNode* child,
  97                              const StyleInfo* style_info = 0 );
  98
  99       virtual osg::BoundingBox getTransformedBounds(const osg::Matrix& m) const;
 100
 101     protected:
 102
 103       static ElementFactories   _child_factories;
 104
 105       /**
 106        * Overload in derived classes to allow for more/other types of elements
 107        * to be managed.
 108        */
 109       virtual ElementFactory getChildFactory(const std::string& type) const;
 110
 111       virtual void childAdded(SGPropertyNode * child);
 112       virtual void childRemoved(SGPropertyNode * child);
 113       virtual void childChanged(SGPropertyNode * child);
 114
 115       void handleZIndexChanged(ElementPtr child, int z_index = 0);
 116
 117       ElementPtr getChildByIndex(size_t index) const;
 118       ElementPtr findChild( const SGPropertyNode* node,
 119                             const std::string& id ) const;
 120   };
 121
 122 } // namespace canvas
 123 } // namespace simgear
 124
 125 #endif /* CANVAS_GROUP_HXX_ */