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          void clear (bool with_delete = false);
  44         std::list<Item*> const & items () const {
  45                 return _items;
  46         }
  47
  48         void raise_child_to_top (Item *);
  49         void raise_child (Item *, int);
  50         void lower_child_to_bottom (Item *);
  51         void child_changed ();
  52
  53         void add_items_at_point (Duple, std::vector<Item const *> &) const;
  54
  55         void dump (std::ostream&) const;
  56
  57         static int default_items_per_cell;
  58
  59 protected:
  60
  61         explicit Group (Canvas *);
  62
  63 private:
  64         friend class ::OptimizingLookupTableTest;
  65
  66         Group (Group const &);
  67         void ensure_lut () const;
  68         void invalidate_lut () const;
  69
  70         /* our items, from lowest to highest in the stack */
  71         std::list<Item*> _items;
  72
  73         mutable LookupTable* _lut;
  74 };
  75
  76 }
  77
  78 #endif