2 Copyright (C) 2006 Paul Davis
3 Written by Dave Robillard, 2006
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.
21 #ifndef __ardour_smf_filesource_h__
22 #define __ardour_smf_filesource_h__
27 #include <ardour/midi_source.h>
29 namespace Evoral { class Event; }
35 /** Standard Midi File (Type 0) Source */
36 class SMFSource : public MidiSource {
43 RemovableIfEmpty = 0x10,
44 RemoveAtDestroy = 0x20,
48 /** Constructor for existing external-to-session files */
49 SMFSource (Session& session, std::string path, Flag flags = Flag(0));
51 /* Constructor for existing in-session files */
52 SMFSource (Session& session, const XMLNode&);
54 virtual ~SMFSource ();
56 /* this block of methods do nothing for regular file sources, but are significant
57 for files used in destructive recording.
59 // FIXME and thus are useless for MIDI.. but make MidiDiskstream compile easier! :)
61 virtual nframes_t last_capture_start_frame() const { return 0; }
62 virtual void mark_capture_start (nframes_t) {}
63 virtual void mark_capture_end () {}
64 virtual void clear_capture_marks() {}
66 bool set_name (const std::string& newname) { return (set_source_name(newname, false) == 0); }
67 int set_source_name (string newname, bool destructive);
69 static bool safe_file_extension (const Glib::ustring& path);
71 Glib::ustring path() const { return _path; }
73 void set_allow_remove_if_empty (bool yn);
74 void mark_for_remove();
76 void append_event_unlocked(EventTimeUnit unit, const Evoral::Event& ev);
81 int move_to_trash (const string trash_dir_name);
83 bool is_empty () const;
84 void mark_streaming_midi_write_started (NoteMode mode, nframes_t start_time);
85 void mark_streaming_write_completed ();
87 void mark_take (string);
88 string take_id() const { return _take_id; }
90 static void set_search_path (string);
91 static void set_header_position_offset (nframes_t offset, bool negative);
93 XMLNode& get_state ();
94 int set_state (const XMLNode&);
96 void seek_to(nframes_t time);
98 void load_model(bool lock=true, bool force_reload=false);
101 uint16_t ppqn() const { return _ppqn; }
105 int init (string idstr, bool must_exist);
107 nframes_t read_unlocked (MidiRingBuffer& dst, nframes_t start, nframes_t cn, nframes_t stamp_offset, nframes_t negative_stamp_offset) const;
108 nframes_t write_unlocked (MidiRingBuffer& dst, nframes_t cnt);
110 bool find (std::string path, bool must_exist, bool& is_new);
111 bool removable() const;
112 bool writable() const { return _flags & Writable; }
118 * This method is only used by flush_footer() to find the right seek position
119 * for the footer (at the end after recording or -4 offset ro SEEK_END
120 * if a footer is already present)
122 void seek_to_footer_position();
125 * write the track footer at the current seek position
129 void write_chunk_header(const char id[4], uint32_t length);
130 void write_chunk(const char id[4], uint32_t length, void* data);
131 size_t write_var_len(uint32_t val);
132 uint32_t read_var_len() const;
133 int read_event(uint32_t* delta_t, uint32_t* size, uint8_t** buf) const;
135 static const uint16_t _ppqn = 19200;
140 bool _allow_remove_if_empty;
142 double _last_ev_time; ///< last frame time written, relative to source start
143 uint32_t _track_size;
144 uint32_t _header_size; ///< size of SMF header, including MTrk chunk header
145 bool _empty; ///< true iff file contains (non-empty) events
147 static string _search_path;
150 }; /* namespace ARDOUR */
152 #endif /* __ardour_smf_filesource_h__ */