2 Copyright (C) 2006 Paul Davis
3 Author: David Robillard
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 2 of the License, or
8 (at your option) any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 #ifndef __ardour_midi_track_h__
21 #define __ardour_midi_track_h__
23 #include "ardour/midi_channel_filter.h"
24 #include "ardour/midi_ring_buffer.h"
25 #include "ardour/track.h"
30 class InterThreadInfo;
37 class LIBARDOUR_API MidiTrack : public Track
40 MidiTrack (Session&, std::string name, Route::Flag f = Route::Flag (0), TrackMode m = Normal);
45 int roll (pframes_t nframes, framepos_t start_frame, framepos_t end_frame, int declick, bool& need_butler);
47 void realtime_handle_transport_stopped ();
48 void realtime_locate ();
49 void non_realtime_locate (framepos_t);
51 boost::shared_ptr<Diskstream> create_diskstream ();
52 void set_diskstream (boost::shared_ptr<Diskstream>);
54 bool can_be_record_enabled ();
55 bool can_be_record_safe ();
57 DataType data_type () const {
58 return DataType::MIDI;
61 void freeze_me (InterThreadInfo&);
64 bool bounceable (boost::shared_ptr<Processor>, bool) const { return false; }
65 boost::shared_ptr<Region> bounce (InterThreadInfo&);
66 boost::shared_ptr<Region> bounce_range (framepos_t start,
69 boost::shared_ptr<Processor> endpoint,
70 bool include_endpoint);
72 int export_stuff (BufferSet& bufs,
73 framepos_t start_frame,
75 boost::shared_ptr<Processor> endpoint,
76 bool include_endpoint,
80 int set_state (const XMLNode&, int version);
82 void midi_panic(void);
83 bool write_immediate_event(size_t size, const uint8_t* buf);
85 /** A control that will send "immediate" events to a MIDI track when twiddled */
86 struct MidiControl : public AutomationControl {
87 MidiControl(MidiTrack* route, const Evoral::Parameter& param,
88 boost::shared_ptr<AutomationList> al = boost::shared_ptr<AutomationList>())
89 : AutomationControl (route->session(), param, ParameterDescriptor(param), al)
93 bool writable() const { return true; }
98 void actually_set_value (double val, PBD::Controllable::GroupControlDisposition group_override);
101 virtual void set_parameter_automation_state (Evoral::Parameter param, AutoState);
103 NoteMode note_mode() const { return _note_mode; }
104 void set_note_mode (NoteMode m);
106 std::string describe_parameter (Evoral::Parameter param);
108 bool step_editing() const { return _step_editing; }
109 void set_step_editing (bool yn);
110 MidiRingBuffer<framepos_t>& step_edit_ring_buffer() { return _step_edit_ring_buffer; }
112 PBD::Signal1<void,bool> StepEditStatusChange;
114 boost::shared_ptr<SMFSource> write_source (uint32_t n = 0);
116 /* Configure capture/playback channels (see MidiChannelFilter). */
117 void set_capture_channel_mode (ChannelMode mode, uint16_t mask);
118 void set_playback_channel_mode (ChannelMode mode, uint16_t mask);
119 void set_playback_channel_mask (uint16_t mask);
120 void set_capture_channel_mask (uint16_t mask);
122 ChannelMode get_playback_channel_mode() const { return _playback_filter.get_channel_mode(); }
123 ChannelMode get_capture_channel_mode() const { return _capture_filter.get_channel_mode(); }
124 uint16_t get_playback_channel_mask() const { return _playback_filter.get_channel_mask(); }
125 uint16_t get_capture_channel_mask() const { return _capture_filter.get_channel_mask(); }
127 MidiChannelFilter& playback_filter() { return _playback_filter; }
128 MidiChannelFilter& capture_filter() { return _capture_filter; }
130 boost::shared_ptr<MidiPlaylist> midi_playlist ();
132 PBD::Signal1<void, boost::weak_ptr<MidiSource> > DataRecorded;
133 boost::shared_ptr<MidiBuffer> get_gui_feed_buffer () const;
135 MonitorState monitoring_state () const;
137 void set_input_active (bool);
138 bool input_active () const;
139 PBD::Signal0<void> InputActiveChanged;
142 XMLNode& state (bool full);
145 void monitoring_changed (bool, PBD::Controllable::GroupControlDisposition);
148 MidiRingBuffer<framepos_t> _immediate_events;
149 MidiRingBuffer<framepos_t> _step_edit_ring_buffer;
153 MidiChannelFilter _playback_filter;
154 MidiChannelFilter _capture_filter;
156 virtual boost::shared_ptr<Diskstream> diskstream_factory (XMLNode const &);
158 boost::shared_ptr<MidiDiskstream> midi_diskstream () const;
160 void write_out_of_band_data (BufferSet& bufs, framepos_t start_frame, framepos_t end_frame, framecnt_t nframes);
162 void set_state_part_two ();
163 void set_state_part_three ();
166 int no_roll (pframes_t nframes, framepos_t start_frame, framepos_t end_frame, bool state_changing);
167 void push_midi_input_to_step_edit_ringbuffer (framecnt_t nframes);
169 void diskstream_data_recorded (boost::weak_ptr<MidiSource>);
170 PBD::ScopedConnection _diskstream_data_recorded_connection;
172 void track_input_active (IOChange, void*);
173 void map_input_active (bool);
175 /** Update automation controls to reflect any changes in buffers. */
176 void update_controls (const BufferSet& bufs);
179 } /* namespace ARDOUR*/
181 #endif /* __ardour_midi_track_h__ */