Ardour  9.0-pre0-1159-gcb8dd39f31
midi_region.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2006-2016 David Robillard <d@drobilla.net>
3  * Copyright (C) 2007-2017 Paul Davis <paul@linuxaudiosystems.com>
4  * Copyright (C) 2009-2012 Carl Hetherington <carl@carlh.net>
5  * Copyright (C) 2016-2017 Nick Mainsbridge <mainsbridge@gmail.com>
6  * Copyright (C) 2016-2017 Robin Gareus <robin@gareus.org>
7  *
8  * This program is free software; you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License as published by
10  * the Free Software Foundation; either version 2 of the License, or
11  * (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the GNU General Public License along
19  * with this program; if not, write to the Free Software Foundation, Inc.,
20  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
21  */
22 
23 #pragma once
24 
25 #include <vector>
26 
27 #include "temporal/beats.h"
28 #include "temporal/range.h"
29 
30 #include "pbd/string_convert.h"
31 
32 #include "ardour/ardour.h"
33 #include "ardour/midi_cursor.h"
34 #include "ardour/region.h"
35 
36 class XMLNode;
37 
38 namespace PBD {
39 class HistoryOwner;
40 }
41 
42 namespace Evoral {
43 template<typename Time> class EventSink;
44 }
45 
46 namespace ARDOUR {
47 
48 class MidiChannelFilter;
49 class MidiFilter;
50 class MidiModel;
51 class MidiSource;
52 class MidiNoteTracker;
53 class Playlist;
54 class Route;
55 class Session;
56 class ThawList;
57 
58 template<typename T> class MidiRingBuffer;
59 
61 {
62  public:
64 
65  std::shared_ptr<MidiRegion> clone (std::string path = std::string()) const;
66  std::shared_ptr<MidiRegion> clone (std::shared_ptr<MidiSource>, ThawList* tl = 0) const;
67 
68  std::shared_ptr<MidiSource> midi_source (uint32_t n=0) const;
69 
71  timepos_t const & position,
72  timecnt_t const & dur,
73  Temporal::Range* loop_range,
74  MidiCursor& cursor,
75  uint32_t chan_n = 0,
76  NoteMode mode = Sustained,
77  MidiNoteTracker* tracker = 0,
78  MidiChannelFilter* filter = 0) const;
79 
81  timepos_t const & position,
82  timecnt_t const & dur,
83  Temporal::Range* loop_range,
84  MidiCursor& cursor,
85  uint32_t chan_n = 0,
86  NoteMode mode = Sustained) const;
87 
88  void merge (std::shared_ptr<MidiRegion const>);
89 
90  XMLNode& state () const;
91  int set_state (const XMLNode&, int version);
92 
93  int separate_by_channel (std::vector< std::shared_ptr<Region> >&) const;
94 
95  /* automation */
96 
97  std::shared_ptr<Evoral::Control> control(const Evoral::Parameter& id, bool create=false);
98 
99  std::shared_ptr<const Evoral::Control> control(const Evoral::Parameter& id) const;
100 
101  /* export */
102 
103  bool do_export (std::string const& path) const;
104 
105  std::shared_ptr<MidiModel> model();
106  std::shared_ptr<const MidiModel> model() const;
107 
109 
111  uint32_t chan_n,
112  NoteMode mode,
113  MidiChannelFilter* filter) const;
114 
116  uint32_t chan_n,
117  NoteMode mode,
118  timepos_t const & read_start,
119  timecnt_t const & read_length,
120  MidiChannelFilter* filter) const;
121 
124 
125  protected:
126 
127  virtual bool can_trim_start_before_source_start () const {
128  return true;
129  }
130 
131  private:
132  friend class RegionFactory;
133 
135  MidiRegion (std::shared_ptr<const MidiRegion>);
136  MidiRegion (std::shared_ptr<const MidiRegion>, timecnt_t const & offset);
137 
139  timepos_t const & position,
140  timecnt_t const & dur,
141  Temporal::Range* loop_range,
142  MidiCursor& cursor,
143  uint32_t chan_n = 0,
144  NoteMode mode = Sustained,
145  MidiNoteTracker* tracker = 0,
146  MidiChannelFilter* filter = 0) const;
147 
149 
152 
153  bool set_name (const std::string & str);
154 
155  void model_changed ();
157  void model_shifted (timecnt_t qn_distance);
159 
160  std::set<Evoral::Parameter> _filtered_parameters;
167 };
168 
169 } /* namespace ARDOUR */
170 
171 
std::shared_ptr< MidiSource > midi_source(uint32_t n=0) const
std::shared_ptr< const MidiModel > model() const
std::shared_ptr< const Evoral::Control > control(const Evoral::Parameter &id) const
std::shared_ptr< MidiRegion > clone(std::string path=std::string()) const
std::shared_ptr< MidiModel > model()
int set_state(const XMLNode &, int version)
void finish_domain_bounce(Temporal::DomainBounceInfo &)
timecnt_t master_read_at(MidiRingBuffer< samplepos_t > &dst, timepos_t const &position, timecnt_t const &dur, Temporal::Range *loop_range, MidiCursor &cursor, uint32_t chan_n=0, NoteMode mode=Sustained) const
std::shared_ptr< Evoral::Control > control(const Evoral::Parameter &id, bool create=false)
MidiRegion(std::shared_ptr< const MidiRegion >, timecnt_t const &offset)
PBD::ScopedConnection _source_connection
Definition: midi_region.h:164
bool do_export(std::string const &path) const
PBD::ScopedConnection _model_changed_connection
Definition: midi_region.h:163
void register_properties()
void fix_negative_start(PBD::HistoryOwner &)
MidiRegion(const SourceList &)
PBD::ScopedConnection _model_shift_connection
Definition: midi_region.h:162
timecnt_t _read_at(const SourceList &, Evoral::EventSink< samplepos_t > &dst, timepos_t const &position, timecnt_t const &dur, Temporal::Range *loop_range, MidiCursor &cursor, uint32_t chan_n=0, NoteMode mode=Sustained, MidiNoteTracker *tracker=0, MidiChannelFilter *filter=0) const
int render_range(Evoral::EventSink< samplepos_t > &dst, uint32_t chan_n, NoteMode mode, timepos_t const &read_start, timecnt_t const &read_length, MidiChannelFilter *filter) const
PBD::ScopedConnection _model_contents_connection
Definition: midi_region.h:165
bool set_name(const std::string &str)
std::shared_ptr< MidiRegion > clone(std::shared_ptr< MidiSource >, ThawList *tl=0) const
void model_automation_state_changed(Evoral::Parameter const &)
int render(Evoral::EventSink< samplepos_t > &dst, uint32_t chan_n, NoteMode mode, MidiChannelFilter *filter) const
std::set< Evoral::Parameter > _filtered_parameters
parameters that we ask our source not to return when reading
Definition: midi_region.h:160
void start_domain_bounce(Temporal::DomainBounceInfo &)
void model_shifted(timecnt_t qn_distance)
XMLNode & state() const
void model_contents_changed()
timecnt_t read_at(Evoral::EventSink< samplepos_t > &dst, timepos_t const &position, timecnt_t const &dur, Temporal::Range *loop_range, MidiCursor &cursor, uint32_t chan_n=0, NoteMode mode=Sustained, MidiNoteTracker *tracker=0, MidiChannelFilter *filter=0) const
MidiRegion(std::shared_ptr< const MidiRegion >)
virtual bool can_trim_start_before_source_start() const
Definition: midi_region.h:127
PBD::ScopedConnection _model_connection
Definition: midi_region.h:161
void merge(std::shared_ptr< MidiRegion const >)
int separate_by_channel(std::vector< std::shared_ptr< Region > > &) const
std::vector< std::shared_ptr< Source > > SourceList
Definition: xml++.h:114
#define LIBARDOUR_API
Definition: editor.h:87
DebugBits MidiRingBuffer
Definition: axis_view.h:42