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:
IsHidden = 0x8,
IsCDMarker = 0x10,
IsRangeMarker = 0x20,
- IsSessionRange = 0x40
+ IsSessionRange = 0x40,
+ IsSkip = 0x80,
+ IsSkipping = 0x100, /* skipping is active (or not) */
};
Location (Session &);
- Location (Session &, framepos_t, framepos_t, const std::string &, Flags bits = Flags(0));
+ Location (Session &, samplepos_t, samplepos_t, const std::string &, Flags bits = Flags(0), const uint32_t sub_num = 0);
Location (const Location& other);
Location (Session &, const XMLNode&);
Location* operator= (const Location& other);
-
- bool operator==(const Location& other);
+
+ bool operator==(const Location& other);
bool locked() const { return _locked; }
void lock ();
void unlock ();
- framepos_t start() const { return _start; }
- framepos_t end() const { return _end; }
- framecnt_t length() const { return _end - _start; }
+ samplepos_t start() const { return _start; }
+ samplepos_t end() const { return _end; }
+ samplecnt_t length() const { return _end - _start; }
- 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 set_start (samplepos_t s, bool force = false, bool allow_beat_recompute = true, const uint32_t sub_num = 0);
+ int set_end (samplepos_t e, bool force = false, bool allow_beat_recompute = true, const uint32_t sub_num = 0);
+ int set (samplepos_t start, samplepos_t end, bool allow_beat_recompute = true, const uint32_t sub_num = 0);
- int move_to (framepos_t pos);
+ int move_to (samplepos_t pos, const uint32_t sub_num);
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_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_cd_marker () const { return _flags & IsCDMarker; }
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; }
Flags flags () const { return _flags; }
boost::shared_ptr<SceneChange> scene_change() const { return _scene_change; }
void set_scene_change (boost::shared_ptr<SceneChange>);
- PBD::Signal1<void,Location*> name_changed;
- PBD::Signal1<void,Location*> end_changed;
- PBD::Signal1<void,Location*> start_changed;
+ /* these are static signals for objects that want to listen to all
+ locations at once.
+ */
- PBD::Signal1<void,Location*> LockChanged;
- PBD::Signal2<void,Location*,void*> FlagsChanged;
- PBD::Signal1<void,Location*> PositionLockStyleChanged;
+ static PBD::Signal1<void,Location*> name_changed;
+ static PBD::Signal1<void,Location*> end_changed;
+ static PBD::Signal1<void,Location*> start_changed;
+ static PBD::Signal1<void,Location*> flags_changed;
+ static PBD::Signal1<void,Location*> lock_changed;
+ static PBD::Signal1<void,Location*> position_lock_style_changed;
/* this is sent only when both start and end change at the same time */
- PBD::Signal1<void,Location*> changed;
+ static PBD::Signal1<void,Location*> changed;
+
+ /* these are member signals for objects that care only about
+ changes to this object
+ */
+
+ PBD::Signal0<void> Changed;
+
+ 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 */
PositionLockStyle position_lock_style() const { return _position_lock_style; }
void set_position_lock_style (PositionLockStyle ps);
- void recompute_frames_from_bbt ();
+ void recompute_samples_from_beat ();
- 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;
- framepos_t _start;
- Timecode::BBT_Time _bbt_start;
- framepos_t _end;
- Timecode::BBT_Time _bbt_end;
+ samplepos_t _start;
+ double _start_beat;
+ samplepos_t _end;
+ double _end_beat;
Flags _flags;
bool _locked;
PositionLockStyle _position_lock_style;
void set_mark (bool yn);
bool set_flag_internal (bool yn, Flags flag);
- void recompute_bbt_from_frames ();
+ void recompute_beat_from_samples (const uint32_t sub_num);
};
+/** A collection of session locations including unique dedicated locations (loop, punch, etc) */
class LIBARDOUR_API Locations : public SessionHandleRef, public PBD::StatefulDestructible
{
public:
Locations (Session &);
~Locations ();
- const LocationList& list() { return locations; }
+ const LocationList& list () const { return locations; }
+ LocationList list () { return locations; }
void add (Location *, bool make_current = false);
void remove (Location *);
int set_current (Location *, bool want_lock = true);
Location *current () const { return current_location; }
- Location* mark_at (framepos_t, framecnt_t slop = 0) 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);
+ Location* mark_at (samplepos_t, samplecnt_t slop = 0) const;
- void marks_either_side (framepos_t const, framepos_t &, framepos_t &) const;
+ samplepos_t first_mark_before (samplepos_t, bool include_special_ranges = false);
+ samplepos_t first_mark_after (samplepos_t, bool include_special_ranges = false);
- void find_all_between (framepos_t start, framepos_t, LocationList&, Location::Flags);
+ void marks_either_side (samplepos_t const, samplepos_t &, samplepos_t &) const;
- enum Change {
- ADDITION, ///< a location was added, but nothing else changed
- REMOVAL, ///< a location was removed, but nothing else changed
- OTHER ///< something more complicated happened
- };
+ void find_all_between (samplepos_t start, samplepos_t, LocationList&, Location::Flags);
PBD::Signal1<void,Location*> current_changed;
- /** something changed about the location list; the parameter gives some idea as to what */
- PBD::Signal1<void,Change> changed;
- /** a location has been added to the end of the list */
- PBD::Signal1<void,Location*> added;
- PBD::Signal1<void,Location*> removed;
- PBD::Signal1<void,const PBD::PropertyChange&> StateChanged;
- template<class T> void apply (T& obj, void (T::*method)(LocationList&)) {
- Glib::Threads::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<class T1, class T2> void apply (T1& obj, void (T1::*method)(LocationList&, T2& arg), T2& arg) {
- Glib::Threads::Mutex::Lock lm (lock);
- (obj.*method)(locations, arg);
+ PBD::Signal1<void,Location*> added;
+ PBD::Signal1<void,Location*> removed;
+ PBD::Signal0<void> changed; /* emitted when any action that could have added/removed more than 1 location actually removed 1 or more */
+
+ template<class T> 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:
int set_current_unlocked (Location *);
void location_changed (Location*);
+ void listen_to (Location*);
};
} // namespace ARDOUR