libs/ardour/ardour/smf_source.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
  21 #ifndef __ardour_smf_source_h__
  22 #define __ardour_smf_source_h__
  23
  24 #include <cstdio>
  25 #include <time.h>
  26 #include "evoral/SMF.hpp"
  27 #include "ardour/midi_source.h"
  28 #include "ardour/file_source.h"
  29
  30 namespace Evoral { template<typename T> class Event; }
  31
  32 namespace ARDOUR {
  33
  34 template<typename T> class MidiRingBuffer;
  35
  36 /** Standard Midi File (Type 0) Source */
  37 class SMFSource : public MidiSource, public FileSource, public Evoral::SMF {
  38 public:
  39         /** Constructor for existing external-to-session files */
  40         SMFSource (Session& session, const std::string& path,
  41                         Source::Flag flags = Source::Flag(0));
  42
  43         /** Constructor for existing in-session files */
  44         SMFSource (Session& session, const XMLNode&, bool must_exist = false);
  45
  46         virtual ~SMFSource ();
  47
  48         /** Rename the file on disk referenced by this source to \param newname
  49          *
  50          * This method exists only for MIDI file sources, not for audio, which
  51          * can never be renamed. It exists for MIDI so that we can get
  52          * consistent and sane region/source numbering when regions are added
  53          * manually (which never happens with audio).
  54          */
  55         int rename (const std::string& name);
  56
  57         bool safe_file_extension (const std::string& path) const {
  58                 return safe_midi_file_extension(path);
  59         }
  60
  61         void append_event_unlocked_beats (const Evoral::Event<Evoral::MusicalTime>& ev);
  62         void append_event_unlocked_frames (const Evoral::Event<framepos_t>& ev, framepos_t source_start);
  63
  64         void mark_streaming_midi_write_started (NoteMode mode);
  65         void mark_streaming_write_completed ();
  66         void mark_midi_streaming_write_completed (Evoral::Sequence<Evoral::MusicalTime>::StuckNoteOption, Evoral::MusicalTime when = 0);
  67
  68         XMLNode& get_state ();
  69         int set_state (const XMLNode&, int version);
  70
  71         void load_model (bool lock=true, bool force_reload=false);
  72         void destroy_model ();
  73
  74         void flush_midi ();
  75         void ensure_disk_file ();
  76
  77         static bool safe_midi_file_extension (const std::string& path);
  78
  79         void prevent_deletion ();
  80
  81   protected:
  82         void set_path (const std::string& newpath);
  83
  84   private:
  85         int open_for_write ();
  86
  87         framecnt_t read_unlocked (Evoral::EventSink<framepos_t>& dst,
  88                                   framepos_t                     position,
  89                                   framepos_t                     start,
  90                                   framecnt_t                     cnt,
  91                                   MidiStateTracker*              tracker) const;
  92
  93         framecnt_t write_unlocked (MidiRingBuffer<framepos_t>& src,
  94                                    framepos_t                  position,
  95                                    framecnt_t                  cnt);
  96
  97         double    _last_ev_time_beats;
  98         framepos_t _last_ev_time_frames;
  99         /** end time (start + duration) of last call to read_unlocked */
 100         mutable framepos_t _smf_last_read_end;
 101         /** time (in SMF ticks, 1 tick per _ppqn) of the last event read by read_unlocked */
 102         mutable framepos_t _smf_last_read_time;
 103 };
 104
 105 }; /* namespace ARDOUR */
 106
 107 #endif /* __ardour_smf_source_h__ */
 108