X-Git-Url: https://main.carlh.net/gitweb/?a=blobdiff_plain;f=libs%2Fardour%2Fardour%2Flocation.h;h=d31e9dccceb11b8528e87a315492be4ed584dcb5;hb=e973e39f06c81fc301c8b059c5240cc17c6671ad;hp=1f2b80c831953c3237798b77c0616b1ccee45365;hpb=aae367b63c9b619db1e40f27dc334c6987219481;p=ardour.git diff --git a/libs/ardour/ardour/location.h b/libs/ardour/ardour/location.h index 1f2b80c831..d31e9dccce 100644 --- a/libs/ardour/ardour/location.h +++ b/libs/ardour/ardour/location.h @@ -27,17 +27,22 @@ #include -#include +#include #include "pbd/undo.h" #include "pbd/stateful.h" #include "pbd/statefuldestructible.h" #include "ardour/ardour.h" +#include "ardour/scene_change.h" +#include "ardour/session_handle.h" namespace ARDOUR { -class Location : public PBD::StatefulDestructible +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: enum Flags { @@ -46,77 +51,87 @@ class Location : public PBD::StatefulDestructible IsAutoLoop = 0x4, IsHidden = 0x8, IsCDMarker = 0x10, - IsEnd = 0x20, - IsRangeMarker = 0x40, - IsStart = 0x80 + IsRangeMarker = 0x20, + IsSessionRange = 0x40, + IsSkip = 0x80, + IsSkipping = 0x100, /* skipping is active (or not) */ }; - Location (nframes64_t sample_start, - nframes64_t sample_end, - const std::string &name, - Flags bits = Flags(0)) - - : _name (name), - _start (sample_start), - _end (sample_end), - _flags (bits), - _locked (false) { } - - Location () { - _start = 0; - _end = 0; - _flags = Flags (0); - _locked = false; - } - + Location (Session &); + Location (Session &, framepos_t, framepos_t, const std::string &, Flags bits = Flags(0)); Location (const Location& other); - Location (const XMLNode&); + Location (Session &, const XMLNode&); Location* operator= (const Location& other); + bool operator==(const Location& other); + bool locked() const { return _locked; } - void lock() { _locked = true; changed (this); } - void unlock() { _locked = false; changed (this); } + void lock (); + void unlock (); - nframes64_t start() const { return _start; } - nframes64_t end() const { return _end; } - nframes64_t length() const { return _end - _start; } + framepos_t start() const { return _start; } + framepos_t end() const { return _end; } + framecnt_t length() const { return _end - _start; } - int set_start (nframes64_t s); - int set_end (nframes64_t e); - int set (nframes64_t start, nframes64_t end); + int set_start (framepos_t s, bool force = false, bool allow_bbt_recompute = true); + int set_end (framepos_t e, bool force = false, bool allow_bbt_recompute = true); + int set (framepos_t start, framepos_t end, bool allow_bbt_recompute = true); - int move_to (nframes64_t pos); + int move_to (framepos_t pos); const std::string& name() const { return _name; } - void set_name (const std::string &str) { _name = str; name_changed(this); } + void set_name (const std::string &str); void set_auto_punch (bool yn, void *src); void set_auto_loop (bool yn, void *src); void set_hidden (bool yn, void *src); void set_cd (bool yn, void *src); - void set_is_end (bool yn, void* src); - void set_is_start (bool yn, void* src); void set_is_range_marker (bool yn, void* src); + void set_skip (bool yn); + void set_skipping (bool yn); bool is_auto_punch () const { return _flags & IsAutoPunch; } bool is_auto_loop () const { return _flags & IsAutoLoop; } bool is_mark () const { return _flags & IsMark; } bool is_hidden () const { return _flags & IsHidden; } bool is_cd_marker () const { return _flags & IsCDMarker; } - bool is_end() const { return _flags & IsEnd; } - bool is_start() const { return _flags & IsStart; } + bool is_session_range () const { return _flags & IsSessionRange; } bool is_range_marker() const { return _flags & IsRangeMarker; } + bool is_skip() const { return _flags & IsSkip; } + bool is_skipping() const { return (_flags & IsSkip) && (_flags & IsSkipping); } bool matches (Flags f) const { return _flags & f; } - PBD::Signal1 name_changed; - PBD::Signal1 end_changed; - PBD::Signal1 start_changed; + Flags flags () const { return _flags; } + + boost::shared_ptr scene_change() const { return _scene_change; } + void set_scene_change (boost::shared_ptr); + + /* these are static signals for objects that want to listen to all + locations at once. + */ + + static PBD::Signal1 name_changed; + static PBD::Signal1 end_changed; + static PBD::Signal1 start_changed; + static PBD::Signal1 flags_changed; + static PBD::Signal1 lock_changed; + static PBD::Signal1 position_lock_style_changed; + + /* this is sent only when both start and end change at the same time */ + static PBD::Signal1 changed; - PBD::Signal2 FlagsChanged; + /* these are member signals for objects that care only about + changes to this object + */ - /* this is sent only when both start&end change at the same time */ + PBD::Signal0 Changed; - PBD::Signal1 changed; + PBD::Signal0 NameChanged; + PBD::Signal0 EndChanged; + PBD::Signal0 StartChanged; + PBD::Signal0 FlagsChanged; + PBD::Signal0 LockChanged; + PBD::Signal0 PositionLockStyleChanged; /* CD Track / CD-Text info */ @@ -126,23 +141,36 @@ class Location : public PBD::StatefulDestructible XMLNode& get_state (void); int set_state (const XMLNode&, int version); + PositionLockStyle position_lock_style() const { return _position_lock_style; } + void set_position_lock_style (PositionLockStyle ps); + void recompute_frames_from_bbt (); + + static PBD::Signal0 scene_changed; /* for use by backend scene change management, class level */ + PBD::Signal0 SceneChangeChanged; /* for use by objects interested in this object */ + private: - std::string _name; - nframes64_t _start; - nframes64_t _end; - Flags _flags; - bool _locked; + std::string _name; + framepos_t _start; + double _bbt_start; + framepos_t _end; + double _bbt_end; + Flags _flags; + bool _locked; + PositionLockStyle _position_lock_style; + boost::shared_ptr _scene_change; void set_mark (bool yn); bool set_flag_internal (bool yn, Flags flag); + void recompute_bbt_from_frames (); }; -class Locations : public PBD::StatefulDestructible +/** A collection of session locations including unique dedicated locations (loop, punch, etc) */ +class LIBARDOUR_API Locations : public SessionHandleRef, public PBD::StatefulDestructible { public: typedef std::list LocationList; - Locations (); + Locations (Session &); ~Locations (); const LocationList& list() { return locations; } @@ -155,12 +183,11 @@ class Locations : public PBD::StatefulDestructible XMLNode& get_state (void); int set_state (const XMLNode&, int version); - Location *get_location_by_id(PBD::ID); + Location *get_location_by_id(PBD::ID); Location* auto_loop_location () const; Location* auto_punch_location () const; - Location* end_location() const; - Location* start_location() const; + Location* session_range_location() const; int next_available_name(std::string& result,std::string base); uint32_t num_range_markers() const; @@ -168,37 +195,46 @@ class Locations : public PBD::StatefulDestructible int set_current (Location *, bool want_lock = true); Location *current () const { return current_location; } - Location *first_location_before (nframes64_t, bool include_special_ranges = false); - Location *first_location_after (nframes64_t, bool include_special_ranges = false); + Location* mark_at (framepos_t, framecnt_t slop = 0) const; - void marks_either_side (nframes64_t const, nframes64_t &, nframes64_t &) const; + framepos_t first_mark_before (framepos_t, bool include_special_ranges = false); + framepos_t first_mark_after (framepos_t, bool include_special_ranges = false); - void find_all_between (nframes64_t start, nframes64_t, LocationList&, Location::Flags); + 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 current_changed; - PBD::Signal0 changed; - PBD::Signal1 added; - PBD::Signal1 removed; - PBD::Signal1 StateChanged; - template void apply (T& obj, void (T::*method)(LocationList&)) { - Glib::Mutex::Lock lm (lock); - (obj.*method)(locations); - } + /* Objects that care about individual addition and removal of Locations should connect to added/removed. + If an object additionally cares about potential mass clearance of Locations, they should connect to changed. + */ - template void apply (T1& obj, void (T1::*method)(LocationList&, T2& arg), T2& arg) { - Glib::Mutex::Lock lm (lock); - (obj.*method)(locations, arg); + PBD::Signal1 added; + PBD::Signal1 removed; + PBD::Signal0 changed; /* emitted when any action that could have added/removed more than 1 location actually removed 1 or more */ + + template void apply (T& obj, void (T::*method)(const LocationList&)) const { + /* We don't want to hold the lock while the given method runs, so take a copy + of the list and pass that instead. + */ + Locations::LocationList copy; + { + Glib::Threads::Mutex::Lock lm (lock); + copy = locations; + } + (obj.*method)(copy); } private: LocationList locations; Location *current_location; - mutable Glib::Mutex lock; + mutable Glib::Threads::Mutex lock; int set_current_unlocked (Location *); void location_changed (Location*); + void listen_to (Location*); }; } // namespace ARDOUR