X-Git-Url: https://main.carlh.net/gitweb/?a=blobdiff_plain;f=libs%2Fardour%2Fardour%2Fregion.h;h=593832343f26580959ef945353f8db62720b3dac;hb=5d6c986748d77ca9f0cda698113dd19a10ba8fd0;hp=ef86dce4b2c3984d6d9923920f07042c4e107c10;hpb=ded4a143db069785aa33eeb6dc9da02770e3ae8e;p=ardour.git diff --git a/libs/ardour/ardour/region.h b/libs/ardour/ardour/region.h index ef86dce4b2..593832343f 100644 --- a/libs/ardour/ardour/region.h +++ b/libs/ardour/ardour/region.h @@ -42,35 +42,37 @@ class XMLNode; namespace ARDOUR { namespace Properties { - extern PBD::PropertyDescriptor muted; - extern PBD::PropertyDescriptor opaque; - extern PBD::PropertyDescriptor locked; - extern PBD::PropertyDescriptor automatic; - extern PBD::PropertyDescriptor whole_file; - extern PBD::PropertyDescriptor import; - extern PBD::PropertyDescriptor external; - extern PBD::PropertyDescriptor sync_marked; - extern PBD::PropertyDescriptor left_of_split; - extern PBD::PropertyDescriptor right_of_split; - extern PBD::PropertyDescriptor hidden; - extern PBD::PropertyDescriptor position_locked; - extern PBD::PropertyDescriptor valid_transients; - extern PBD::PropertyDescriptor start; - extern PBD::PropertyDescriptor length; - extern PBD::PropertyDescriptor position; - extern PBD::PropertyDescriptor sync_position; - extern PBD::PropertyDescriptor layer; - extern PBD::PropertyDescriptor ancestral_start; - extern PBD::PropertyDescriptor ancestral_length; - extern PBD::PropertyDescriptor stretch; - extern PBD::PropertyDescriptor shift; + extern PBD::PropertyDescriptor muted; + extern PBD::PropertyDescriptor opaque; + extern PBD::PropertyDescriptor locked; + extern PBD::PropertyDescriptor video_locked; + extern PBD::PropertyDescriptor automatic; + extern PBD::PropertyDescriptor whole_file; + extern PBD::PropertyDescriptor import; + extern PBD::PropertyDescriptor external; + extern PBD::PropertyDescriptor sync_marked; + extern PBD::PropertyDescriptor left_of_split; + extern PBD::PropertyDescriptor right_of_split; + extern PBD::PropertyDescriptor hidden; + extern PBD::PropertyDescriptor position_locked; + extern PBD::PropertyDescriptor valid_transients; + extern PBD::PropertyDescriptor start; + extern PBD::PropertyDescriptor length; + extern PBD::PropertyDescriptor position; + extern PBD::PropertyDescriptor sync_position; + extern PBD::PropertyDescriptor layer; + extern PBD::PropertyDescriptor ancestral_start; + extern PBD::PropertyDescriptor ancestral_length; + extern PBD::PropertyDescriptor stretch; + extern PBD::PropertyDescriptor shift; extern PBD::PropertyDescriptor position_lock_style; + extern PBD::PropertyDescriptor layering_index; }; class Playlist; class Filter; class ExportSpecification; -class Progress; +class Progress; enum RegionEditState { EditChangesNothing = 0, @@ -83,78 +85,99 @@ class Region : public SessionObject , public boost::enable_shared_from_this , public Readable - , public Trimmable - , public Movable + , public Trimmable + , public Movable { public: typedef std::vector > SourceList; static void make_property_quarks (); - + static PBD::Signal2, const PBD::PropertyChange&> RegionPropertyChanged; virtual ~Region(); - + /** Note: changing the name of a Region does not constitute an edit */ bool set_name (const std::string& str); - const DataType& data_type() const { return _type; } - + const DataType& data_type () const { return _type; } + AnalysisFeatureList transients () { return _transients; }; /** How the region parameters play together: - * + * * POSITION: first frame of the region along the timeline * START: first frame of the region within its source(s) * LENGTH: number of frames the region represents */ - framepos_t position () const { return _position; } - framepos_t start () const { return _start; } - framecnt_t length() const { return _length; } - layer_t layer () const { return _layer; } + framepos_t position () const { return _position; } + framepos_t start () const { return _start; } + framecnt_t length () const { return _length; } + layer_t layer () const { return _layer; } framecnt_t source_length(uint32_t n) const; + uint32_t max_source_level () const; /* these two are valid ONLY during a StateChanged signal handler */ - framepos_t last_position() const { return _last_position; } - framecnt_t last_length() const { return _last_length; } + framepos_t last_position () const { return _last_position; } + framecnt_t last_length () const { return _last_length; } - framepos_t ancestral_start () const { return _ancestral_start; } + framepos_t ancestral_start () const { return _ancestral_start; } framecnt_t ancestral_length () const { return _ancestral_length; } - float stretch() const { return _stretch; } - float shift() const { return _shift; } - void set_ancestral_data (framepos_t start, framepos_t length, float stretch, float shift); + float stretch () const { return _stretch; } + float shift () const { return _shift; } + + void set_ancestral_data (framepos_t start, framecnt_t length, float stretch, float shift); - frameoffset_t sync_offset(int& dir) const; - framepos_t sync_position() const; + frameoffset_t sync_offset (int& dir) const; + framepos_t sync_position () const; framepos_t sync_point () const; - + framepos_t adjust_to_sync (framepos_t) const; /* first_frame() is an alias; last_frame() just hides some math */ - framepos_t first_frame() const { return _position; } - framepos_t last_frame() const { return _position + _length - 1; } - - bool hidden() const { return _hidden; } - bool muted() const { return _muted; } - bool opaque () const { return _opaque; } - bool locked() const { return _locked; } - bool position_locked() const { return _position_locked; } - bool valid_transients() const { return _valid_transients; } - bool automatic() const { return _automatic; } - bool whole_file() const { return _whole_file; } - bool captured() const { return !(_import || _external); } - bool can_move() const { return !_position_locked; } - bool sync_marked() const { return _sync_marked; } - bool external() const { return _external; } - bool import() const { return _import; } - - Trimmable::CanTrim can_trim() const; - - PositionLockStyle position_lock_style() const { return _position_lock_style; } + framepos_t first_frame () const { return _position; } + framepos_t last_frame () const { return _position + _length - 1; } + + /** Return the earliest possible value of _position given the + * value of _start within the region's sources + */ + framepos_t earliest_possible_position () const; + /** Return the last possible value of _last_frame given the + * value of _startin the regions's sources + */ + framepos_t latest_possible_frame () const; + + Evoral::Range last_range () const { + return Evoral::Range (_last_position, _last_position + _last_length - 1); + } + + Evoral::Range range () const { + return Evoral::Range (first_frame(), last_frame()); + } + + bool hidden () const { return _hidden; } + bool muted () const { return _muted; } + bool opaque () const { return _opaque; } + bool locked () const { return _locked; } + bool position_locked () const { return _position_locked; } + bool video_locked () const { return _video_locked; } + bool valid_transients () const { return _valid_transients; } + bool automatic () const { return _automatic; } + bool whole_file () const { return _whole_file; } + bool captured () const { return !(_import || _external); } + bool can_move () const { return !_position_locked && !_locked; } + bool sync_marked () const { return _sync_marked; } + bool external () const { return _external; } + bool import () const { return _import; } + + Trimmable::CanTrim can_trim () const; + + PositionLockStyle position_lock_style () const { return _position_lock_style; } + void set_position_lock_style (PositionLockStyle ps); void recompute_position_from_lock_style (); @@ -164,8 +187,14 @@ class Region return first_frame() <= frame && frame <= last_frame(); } - OverlapType coverage (framepos_t start, framepos_t end) const { - return ARDOUR::coverage (first_frame(), last_frame(), start, end); + /** @return coverage of this region with the given range; + * OverlapInternal: the range is internal to this region. + * OverlapStart: the range overlaps the start of this region. + * OverlapEnd: the range overlaps the end of this region. + * OverlapExternal: the range overlaps all of this region. + */ + Evoral::OverlapType coverage (framepos_t start, framepos_t end) const { + return Evoral::coverage (first_frame(), last_frame(), start, end); } bool equivalent (boost::shared_ptr) const; @@ -173,28 +202,31 @@ class Region bool overlap_equivalent (boost::shared_ptr) const; bool region_list_equivalent (boost::shared_ptr) const; bool source_equivalent (boost::shared_ptr) const; + bool any_source_equivalent (boost::shared_ptr) const; bool uses_source (boost::shared_ptr) const; + std::string source_string () const; + + /* EDITING OPERATIONS */ - void set_length (framecnt_t, void *src); - void set_start (framepos_t, void *src); - void set_position (framepos_t, void *src); - void set_position_on_top (framepos_t, void *src); + void set_length (framecnt_t); + void set_start (framepos_t); + void set_position (framepos_t); void special_set_position (framepos_t); - void update_position_after_tempo_map_change (); - void nudge_position (frameoffset_t, void *src); + virtual void update_after_tempo_map_change (); + void nudge_position (frameoffset_t); bool at_natural_position () const; - void move_to_natural_position (void *src); + void move_to_natural_position (); - void trim_start (framepos_t new_position, void *src); - void trim_front (framepos_t new_position, void *src); - void trim_end (framepos_t new_position, void *src); - void trim_to (framepos_t position, framecnt_t length, void *src); + void move_start (frameoffset_t distance); + void trim_front (framepos_t new_position); + void trim_end (framepos_t new_position); + void trim_to (framepos_t position, framecnt_t length); - void cut_front (nframes_t new_position, void *src); - void cut_end (nframes_t new_position, void *src); + void cut_front (framepos_t new_position); + void cut_end (framepos_t new_position); void set_layer (layer_t l); /* ONLY Playlist can call this */ void raise (); @@ -210,22 +242,23 @@ class Region void set_automatic (bool yn); void set_opaque (bool yn); void set_locked (bool yn); + void set_video_locked (bool yn); void set_position_locked (bool yn); int apply (Filter &, Progress* progress = 0); - virtual uint64_t read_data_count() const { return _read_data_count; } - - boost::shared_ptr playlist() const { return _playlist.lock(); } + boost::shared_ptr playlist () const { return _playlist.lock(); } virtual void set_playlist (boost::weak_ptr); void source_deleted (boost::weak_ptr); + bool is_compound () const; + boost::shared_ptr source (uint32_t n=0) const { return _sources[ (n < _sources.size()) ? n : 0 ]; } - uint32_t n_channels() const { return _sources.size(); } + uint32_t n_channels() const { return _sources.size(); } - const SourceList& sources() const { return _sources; } - const SourceList& master_sources() const { return _master_sources; } + const SourceList& sources () const { return _sources; } + const SourceList& master_sources () const { return _master_sources; } std::vector master_source_names(); void set_master_sources (const SourceList&); @@ -233,10 +266,10 @@ class Region /* automation */ virtual boost::shared_ptr - control(const Evoral::Parameter& id, bool create=false) = 0; + control (const Evoral::Parameter& id, bool create=false) = 0; virtual boost::shared_ptr - control(const Evoral::Parameter& id) const = 0; + control (const Evoral::Parameter& id) const = 0; /* serialization */ @@ -246,14 +279,12 @@ class Region virtual boost::shared_ptr get_parent() const; - uint64_t last_layer_op() const { return _last_layer_op; } - void set_last_layer_op (uint64_t when); + uint64_t layering_index () const { return _layering_index; } + void set_layering_index (uint64_t when) { _layering_index = when; } virtual bool is_dependent() const { return false; } virtual bool depends_on (boost::shared_ptr /*other*/) const { return false; } - virtual int exportme (ARDOUR::Session&, ARDOUR::ExportSpecification&) = 0; - virtual void add_transient (framepos_t) { // no transients, but its OK } @@ -278,7 +309,7 @@ class Region return 0; } - virtual int adjust_transients (framepos_t /*delta*/) { + virtual int adjust_transients (frameoffset_t /*delta*/) { // no transients, but its OK return 0; } @@ -290,39 +321,65 @@ class Region void invalidate_transients (); - void set_pending_explicit_relayer (bool p) { - _pending_explicit_relayer = p; - } - - bool pending_explicit_relayer () const { - return _pending_explicit_relayer; - } - - void drop_sources (); + void drop_sources (); protected: friend class RegionFactory; /** Construct a region from multiple sources*/ Region (const SourceList& srcs); + + /** Construct a region from another region */ + Region (boost::shared_ptr); + /** Construct a region from another region, at an offset within that region */ - Region (boost::shared_ptr, frameoffset_t start_offset = 0, bool start_relative = true); + Region (boost::shared_ptr, frameoffset_t start_offset); + /** Construct a region as a copy of another region, but with different sources */ Region (boost::shared_ptr, const SourceList&); - /** normal Region copy constructor */ - Region (boost::shared_ptr); /** Constructor for derived types only */ Region (Session& s, framepos_t start, framecnt_t length, const std::string& name, DataType); + virtual bool can_trim_start_before_source_start () const { + return false; + } + protected: - void send_change (const PBD::PropertyChange&); - void mid_thaw (const PBD::PropertyChange&); - void trim_to_internal (framepos_t position, framecnt_t length, void *src); + void send_change (const PBD::PropertyChange&); + virtual int _set_state (const XMLNode&, int version, PBD::PropertyChange& what_changed, bool send_signal); + void post_set (const PBD::PropertyChange&); virtual void set_position_internal (framepos_t pos, bool allow_bbt_recompute); - void modify_front (nframes_t new_position, bool reset_fade, void* src); - void modify_end (nframes_t new_position, bool reset_fade, void* src); + virtual void set_length_internal (framecnt_t); + virtual void set_start_internal (framecnt_t); + + DataType _type; + + PBD::Property _sync_marked; + PBD::Property _left_of_split; + PBD::Property _right_of_split; + PBD::Property _valid_transients; + PBD::Property _start; + PBD::Property _length; + PBD::Property _position; + /** Sync position relative to the start of our file */ + PBD::Property _sync_position; + + SourceList _sources; + /** Used when timefx are applied, so we can always use the original source */ + SourceList _master_sources; + + AnalysisFeatureList _transients; + + boost::weak_ptr _playlist; + + private: + void mid_thaw (const PBD::PropertyChange&); + + void trim_to_internal (framepos_t position, framecnt_t length); + void modify_front (framepos_t new_position, bool reset_fade); + void modify_end (framepos_t new_position, bool reset_fade); void maybe_uncopy (); void first_edit (); @@ -334,56 +391,32 @@ class Region virtual void recompute_at_start () = 0; virtual void recompute_at_end () = 0; - - DataType _type; PBD::Property _muted; PBD::Property _opaque; PBD::Property _locked; + PBD::Property _video_locked; PBD::Property _automatic; PBD::Property _whole_file; PBD::Property _import; PBD::Property _external; - PBD::Property _sync_marked; - PBD::Property _left_of_split; - PBD::Property _right_of_split; PBD::Property _hidden; PBD::Property _position_locked; - PBD::Property _valid_transients; - PBD::Property _start; - PBD::Property _length; - PBD::Property _position; - /** Sync position relative to the start of our file */ - PBD::Property _sync_position; - PBD::Property _layer; PBD::Property _ancestral_start; PBD::Property _ancestral_length; PBD::Property _stretch; PBD::Property _shift; PBD::EnumProperty _position_lock_style; + PBD::Property _layering_index; framecnt_t _last_length; framepos_t _last_position; mutable RegionEditState _first_edit; - BBT_Time _bbt_time; - AnalysisFeatureList _transients; - - mutable uint64_t _read_data_count; ///< modified in read() - uint64_t _last_layer_op; ///< timestamp - SourceList _sources; - /** Used when timefx are applied, so we can always use the original source */ - SourceList _master_sources; - - /** true if this region has had its layer explicitly set since the playlist last relayered */ - bool _pending_explicit_relayer; - - boost::weak_ptr _playlist; - - virtual int _set_state (const XMLNode&, int version, PBD::PropertyChange& what_changed, bool send_signal); + Timecode::BBT_Time _bbt_time; + layer_t _layer; void register_properties (); -protected: void use_sources (SourceList const &); };