libs/canvas/canvas/group.h

   1 /*
   2     Copyright (C) 2011-2013 Paul Davis
   3     Author: Carl Hetherington <cth@carlh.net>
   4
   5     This program is free software; you can redistribute it and/or modify
   6     it under the terms of the GNU General Public License as published by
   7     the Free Software Foundation; either version 2 of the License, or
   8     (at your option) any later version.
   9
  10     This program 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
  13     GNU General Public License for more details.
  14
  15     You should have received a copy of the GNU General Public License
  16     along with this program; if not, write to the Free Software
  17     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  18 */
  19
  20 #ifndef __CANVAS_GROUP_H__
  21 #define __CANVAS_GROUP_H__
  22
  23 #include <list>
  24 #include <vector>
  25 #include "canvas/item.h"
  26 #include "canvas/types.h"
  27 #include "canvas/lookup_table.h"
  28
  29 namespace ArdourCanvas {
  30
  31 class Group : public Item
  32 {
  33 public:
  34         explicit Group (Group *);
  35         explicit Group (Group *, Duple);
  36         ~Group ();
  37
  38         void render (Rect const &, Cairo::RefPtr<Cairo::Context>) const;
  39         virtual void compute_bounding_box () const;
  40
  41         void add (Item *);
  42         void remove (Item *);
  43         std::list<Item*> const & items () const {
  44                 return _items;
  45         }
  46
  47         void raise_child_to_top (Item *);
  48         void raise_child (Item *, int);
  49         void lower_child_to_bottom (Item *);
  50         void child_changed ();
  51
  52         void add_items_at_point (Duple, std::vector<Item const *> &) const;
  53
  54         void dump (std::ostream&) const;
  55
  56         static int default_items_per_cell;
  57
  58 protected:
  59
  60         explicit Group (Canvas *);
  61
  62 private:
  63         friend class ::OptimizingLookupTableTest;
  64
  65         Group (Group const &);
  66         void ensure_lut () const;
  67         void invalidate_lut () const;
  68
  69         /* our items, from lowest to highest in the stack */
  70         std::list<Item*> _items;
  71
  72         mutable LookupTable* _lut;
  73 };
  74
  75 }
  76
  77 #endif