never ever change sample-rate saved with the session after creation.

[ardour.git] / libs / ardour / ardour / location.h

diff --git a/libs/ardour/ardour/location.h b/libs/ardour/ardour/location.h
index b2517832846f853d521d9ec13810552bfa2d98ac..530f757c65fa38be1a58f9412148c0961800480e 100644 (file)
--- a/libs/ardour/ardour/location.h
+++ b/libs/ardour/ardour/location.h
@@ -41,6 +41,7 @@ namespace ARDOUR {
 
 class SceneChange;
 
+/** Location on Timeline - abstract representation for Markers, Loop/Punch Ranges, CD-Markers etc. */
 class LIBARDOUR_API Location : public SessionHandleRef, public PBD::StatefulDestructible
 {
   public:
@@ -61,7 +62,7 @@ class LIBARDOUR_API Location : public SessionHandleRef, public PBD::StatefulDest
        Location (const Location& other);
        Location (Session &, const XMLNode&);
        Location* operator= (const Location& other);
-    
+
        bool operator==(const Location& other);
 
        bool locked() const { return _locked; }
@@ -120,19 +121,18 @@ class LIBARDOUR_API Location : public SessionHandleRef, public PBD::StatefulDest
        static PBD::Signal1<void,Location*> changed;
 
        /* these are member signals for objects that care only about
-          changes to this object 
+          changes to this object
        */
 
        PBD::Signal0<void> Changed;
-       void set_block_change_notifications (bool yn) {_block_change_notifications = yn;}
-    
+
        PBD::Signal0<void> NameChanged;
        PBD::Signal0<void> EndChanged;
        PBD::Signal0<void> StartChanged;
        PBD::Signal0<void> FlagsChanged;
        PBD::Signal0<void> LockChanged;
        PBD::Signal0<void> PositionLockStyleChanged;
-        
+
        /* CD Track / CD-Text info */
 
        std::map<std::string, std::string> cd_info;
@@ -145,7 +145,8 @@ class LIBARDOUR_API Location : public SessionHandleRef, public PBD::StatefulDest
        void set_position_lock_style (PositionLockStyle ps);
        void recompute_frames_from_bbt ();
 
-       static PBD::Signal0<void> scene_changed;
+       static PBD::Signal0<void> scene_changed; /* for use by backend scene change management, class level */
+        PBD::Signal0<void> SceneChangeChanged;   /* for use by objects interested in this object */
 
   private:
        std::string        _name;
@@ -157,14 +158,13 @@ class LIBARDOUR_API Location : public SessionHandleRef, public PBD::StatefulDest
        bool               _locked;
        PositionLockStyle  _position_lock_style;
        boost::shared_ptr<SceneChange> _scene_change;
-    
-       bool _block_change_notifications; // required for group operations
 
        void set_mark (bool yn);
        bool set_flag_internal (bool yn, Flags flag);
        void recompute_bbt_from_frames ();
 };
 
+/** A collection of session locations including unique dedicated locations (loop, punch, etc) */
 class LIBARDOUR_API Locations : public SessionHandleRef, public PBD::StatefulDestructible
 {
   public:
@@ -203,7 +203,7 @@ class LIBARDOUR_API Locations : public SessionHandleRef, public PBD::StatefulDes
        void marks_either_side (framepos_t const, framepos_t &, framepos_t &) const;
 
        void find_all_between (framepos_t start, framepos_t, LocationList&, Location::Flags);
-    
+
        PBD::Signal1<void,Location*> current_changed;
 
        /* Objects that care about individual addition and removal of Locations should connect to added/removed.