libs/ardour/ardour/midi_track.h

   1 /*
   2     Copyright (C) 2006 Paul Davis
   3     Author: David Robillard
   4
   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.
   9
  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.
  14
  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.
  18 */
  19
  20 #ifndef __ardour_midi_track_h__
  21 #define __ardour_midi_track_h__
  22
  23 #include "ardour/track.h"
  24 #include "ardour/midi_ring_buffer.h"
  25
  26 namespace ARDOUR
  27 {
  28
  29 class InterThreadInfo;
  30 class MidiDiskstream;
  31 class MidiPlaylist;
  32 class RouteGroup;
  33 class SMFSource;
  34 class Session;
  35
  36 class MidiTrack : public Track
  37 {
  38 public:
  39         MidiTrack (Session&, string name, Route::Flag f = Route::Flag (0), TrackMode m = Normal);
  40         ~MidiTrack ();
  41
  42         int init ();
  43
  44         int roll (pframes_t nframes, framepos_t start_frame, framepos_t end_frame, int declick, bool& need_butler);
  45
  46         void realtime_handle_transport_stopped ();
  47         void realtime_locate ();
  48
  49         boost::shared_ptr<Diskstream> create_diskstream ();
  50         void set_diskstream (boost::shared_ptr<Diskstream>);
  51         void set_record_enabled (bool yn, void *src);
  52
  53         DataType data_type () const {
  54                 return DataType::MIDI;
  55         }
  56
  57         void freeze_me (InterThreadInfo&);
  58         void unfreeze ();
  59
  60         bool bounceable (boost::shared_ptr<Processor>, bool) const { return false; }
  61         boost::shared_ptr<Region> bounce (InterThreadInfo&);
  62         boost::shared_ptr<Region> bounce_range (framepos_t                   start,
  63                                                 framepos_t                   end,
  64                                                 InterThreadInfo&             iti,
  65                                                 boost::shared_ptr<Processor> endpoint,
  66                                                 bool                         include_endpoint);
  67
  68         int export_stuff (BufferSet&                   bufs,
  69                           framepos_t                   start_frame,
  70                           framecnt_t                   end_frame,
  71                           boost::shared_ptr<Processor> endpoint,
  72                           bool                         include_endpoint,
  73                           bool                         for_export);
  74
  75         int set_state (const XMLNode&, int version);
  76
  77         void midi_panic(void);
  78         bool write_immediate_event(size_t size, const uint8_t* buf);
  79
  80         /** A control that will send "immediate" events to a MIDI track when twiddled */
  81         struct MidiControl : public AutomationControl {
  82                 MidiControl(MidiTrack* route, const Evoral::Parameter& param,
  83                             boost::shared_ptr<AutomationList> al = boost::shared_ptr<AutomationList>())
  84                         : AutomationControl (route->session(), param, al)
  85                         , _route (route)
  86                 {}
  87
  88                 void set_value (double val);
  89
  90                 MidiTrack* _route;
  91         };
  92
  93         NoteMode note_mode() const { return _note_mode; }
  94         void set_note_mode (NoteMode m);
  95
  96         std::string describe_parameter (Evoral::Parameter param);
  97
  98         bool step_editing() const { return _step_editing; }
  99         void set_step_editing (bool yn);
 100         MidiRingBuffer<framepos_t>& step_edit_ring_buffer() { return _step_edit_ring_buffer; }
 101
 102         PBD::Signal1<void,bool> StepEditStatusChange;
 103
 104         boost::shared_ptr<SMFSource> write_source (uint32_t n = 0);
 105         void set_channel_mode (ChannelMode, uint16_t);
 106         ChannelMode get_channel_mode ();
 107         uint16_t get_channel_mask ();
 108         boost::shared_ptr<MidiPlaylist> midi_playlist ();
 109
 110         PBD::Signal1<void, boost::weak_ptr<MidiSource> > DataRecorded;
 111         boost::shared_ptr<MidiBuffer> get_gui_feed_buffer () const;
 112
 113         void set_monitoring (MonitorChoice);
 114         MonitorState monitoring_state () const;
 115
 116         void set_input_active (bool);
 117         bool input_active () const;
 118         PBD::Signal0<void> InputActiveChanged;
 119
 120 protected:
 121         XMLNode& state (bool full);
 122
 123         void act_on_mute ();
 124
 125 private:
 126
 127         virtual boost::shared_ptr<Diskstream> diskstream_factory (XMLNode const &);
 128
 129         boost::shared_ptr<MidiDiskstream> midi_diskstream () const;
 130
 131         void write_out_of_band_data (BufferSet& bufs, framepos_t start_frame, framepos_t end_frame, framecnt_t nframes);
 132
 133         void set_state_part_two ();
 134         void set_state_part_three ();
 135
 136         MidiRingBuffer<framepos_t> _immediate_events;
 137         MidiRingBuffer<framepos_t> _step_edit_ring_buffer;
 138         NoteMode                  _note_mode;
 139         bool                      _step_editing;
 140         bool                      _input_active;
 141
 142         int no_roll (pframes_t nframes, framepos_t start_frame, framepos_t end_frame, bool state_changing);
 143         void push_midi_input_to_step_edit_ringbuffer (framecnt_t nframes);
 144
 145         void diskstream_data_recorded (boost::weak_ptr<MidiSource>);
 146         PBD::ScopedConnection _diskstream_data_recorded_connection;
 147
 148         void track_input_active (IOChange, void*);
 149         void map_input_active (bool);
 150 };
 151
 152 } /* namespace ARDOUR*/
 153
 154 #endif /* __ardour_midi_track_h__ */