libs/pbd/pbd/property_basics.h

   1 /*
   2     Copyright (C) 2010 Paul Davis
   3
   4     This program is free software; you can redistribute it and/or modify
   5     it under the terms of the GNU General Public License as published by
   6     the Free Software Foundation; either version 2 of the License, or
   7     (at your option) any later version.
   8
   9     This program is distributed in the hope that it will be useful,
  10     but WITHOUT ANY WARRANTY; without even the implied warranty of
  11     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12     GNU General Public License for more details.
  13
  14     You should have received a copy of the GNU General Public License
  15     along with this program; if not, write to the Free Software
  16     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  17
  18 */
  19
  20 #ifndef __libpbd_property_basics_h__
  21 #define __libpbd_property_basics_h__
  22
  23 #include <glib.h>
  24 #include <set>
  25 #include <vector>
  26
  27 #include "pbd/xml++.h"
  28
  29 class Command;
  30
  31 namespace PBD {
  32
  33 class PropertyList;
  34 class StatefulDiffCommand;
  35
  36 /** A unique identifier for a property of a Stateful object */
  37 typedef GQuark PropertyID;
  38
  39 template<typename T>
  40 struct PropertyDescriptor {
  41     PropertyDescriptor () : property_id (0) {}
  42     PropertyDescriptor (PropertyID pid) : property_id (pid) {}
  43
  44     PropertyID property_id;
  45     typedef T value_type;
  46 };
  47
  48 /** A list of IDs of Properties that have changed in some situation or other */
  49 class PropertyChange : public std::set<PropertyID>
  50 {
  51 public:
  52         PropertyChange() {}
  53
  54         template<typename T> PropertyChange(PropertyDescriptor<T> p);
  55
  56         PropertyChange(const PropertyChange& other) : std::set<PropertyID> (other) {}
  57
  58         PropertyChange operator=(const PropertyChange& other) {
  59                 clear ();
  60                 insert (other.begin (), other.end ());
  61                 return *this;
  62         }
  63
  64         template<typename T> PropertyChange operator=(PropertyDescriptor<T> p);
  65         template<typename T> bool contains (PropertyDescriptor<T> p) const;
  66
  67         bool contains (const PropertyChange& other) const {
  68                 for (const_iterator x = other.begin (); x != other.end (); ++x) {
  69                         if (find (*x) != end ()) {
  70                                 return true;
  71                         }
  72                 }
  73                 return false;
  74         }
  75
  76         void add (PropertyID id)               { insert (id); }
  77         void add (const PropertyChange& other) { insert (other.begin (), other.end ()); }
  78         template<typename T> void add (PropertyDescriptor<T> p);
  79 };
  80
  81 /** Base (non template) part of Property */
  82 class PropertyBase
  83 {
  84 public:
  85         PropertyBase (PropertyID pid)
  86                 : _property_id (pid)
  87         {}
  88
  89         virtual ~PropertyBase () {}
  90
  91         virtual PropertyBase* clone () const = 0;
  92
  93         /** Forget about any old value for this state */
  94         virtual void clear_history () = 0;
  95
  96         /** Tell any things we own to forget about their old values */
  97         virtual void clear_owned_history () {}
  98
  99         /** Get any changes in this property as XML and add it to a node */
 100         virtual void get_changes_as_xml (XMLNode *) const = 0;
 101
 102         virtual void get_changes_as_properties (PropertyList& changes, Command *) const = 0;
 103
 104         /** Collect StatefulDiffCommands for changes to anything that we own */
 105         virtual void rdiff (std::vector<StatefulDiffCommand*> &) const {}
 106
 107         virtual PropertyBase* maybe_clone_self_if_found_in_history_node (const XMLNode&) const { return 0; }
 108
 109         /** Set our value from an XML node.
 110          *  @return true if the value was set.
 111          */
 112         virtual bool set_value (XMLNode const &) = 0;
 113
 114         /** Get our value and put it into an XML node */
 115         virtual void get_value (XMLNode& node) const = 0;
 116
 117         /** @return true if this property has changed in value since construction or since
 118          *  the last call to clear_history(), whichever was more recent.
 119          */
 120         virtual bool changed() const = 0;
 121
 122         /** Apply changes contained in another Property to this one */
 123         virtual void apply_changes (PropertyBase const *) = 0;
 124
 125         /** Invert the changes in this property */
 126         virtual void invert () = 0;
 127
 128         const gchar*property_name () const { return g_quark_to_string (_property_id); }
 129         PropertyID  property_id () const   { return _property_id; }
 130
 131         bool operator==(PropertyID pid) const {
 132                 return _property_id == pid;
 133         }
 134
 135 protected:
 136         PropertyID _property_id;
 137 };
 138
 139 }
 140
 141 #endif /* __libpbd_property_basics_h__ */