OpenTTD Source  20240919-master-gdf0233f4c2
midifile.hpp
1 /*
2  * This file is part of OpenTTD.
3  * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
4  * OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
5  * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
6  */
7 
8 /* @file midifile.hpp Parser for standard MIDI files */
9 
10 #ifndef MUSIC_MIDIFILE_HPP
11 #define MUSIC_MIDIFILE_HPP
12 
13 #include "../stdafx.h"
14 #include "../fileio_type.h"
15 #include "midi.h"
16 
17 struct MusicSongInfo;
18 
19 struct MidiFile {
20  struct DataBlock {
21  uint32_t ticktime;
22  uint32_t realtime = 0;
23  std::vector<uint8_t> data;
24  DataBlock(uint32_t _ticktime = 0) : ticktime(_ticktime) { }
25  };
26  struct TempoChange {
27  uint32_t ticktime;
28  uint32_t tempo;
29  TempoChange(uint32_t _ticktime, uint32_t _tempo) : ticktime(_ticktime), tempo(_tempo) { }
30  };
31 
32  std::vector<DataBlock> blocks;
33  std::vector<TempoChange> tempos;
34  uint16_t tickdiv;
35 
36  MidiFile();
37  ~MidiFile();
38 
39  bool LoadFile(const std::string &filename);
40  bool LoadMpsData(const uint8_t *data, size_t length);
41  bool LoadSong(const MusicSongInfo &song);
42  void MoveFrom(MidiFile &other);
43 
44  bool WriteSMF(const std::string &filename);
45 
46  static std::string GetSMFFile(const MusicSongInfo &song);
47  static bool ReadSMFHeader(const std::string &filename, SMFHeader &header);
48  static bool ReadSMFHeader(FileHandle &file, SMFHeader &header);
49 };
50 
51 #endif /* MUSIC_MIDIFILE_HPP */
MidiFile::tempos
std::vector< TempoChange > tempos
list of tempo changes in file
Definition: midifile.hpp:33
MidiFile
Definition: midifile.hpp:19
MidiFile::LoadFile
bool LoadFile(const std::string &filename)
Load a standard MIDI file.
Definition: midifile.cpp:447
MidiFile::TempoChange
Definition: midifile.hpp:26
MidiFile::LoadMpsData
bool LoadMpsData(const uint8_t *data, size_t length)
Create MIDI data from song data for the original Microprose music drivers.
Definition: midifile.cpp:825
MidiFile::TempoChange::ticktime
uint32_t ticktime
tick number since start of file this tempo change occurs at
Definition: midifile.hpp:27
MidiFile::TempoChange::tempo
uint32_t tempo
new tempo in microseconds per tick
Definition: midifile.hpp:28
MusicSongInfo
Metadata about a music track.
Definition: base_media_base.h:325
FileHandle
Definition: fileio_type.h:158
MidiFile::tickdiv
uint16_t tickdiv
ticks per quarter note
Definition: midifile.hpp:34
MidiFile::GetSMFFile
static std::string GetSMFFile(const MusicSongInfo &song)
Get the name of a Standard MIDI File for a given song.
Definition: midifile.cpp:1028
MidiFile::DataBlock::data
std::vector< uint8_t > data
raw midi data contained in block
Definition: midifile.hpp:23
MidiFile::WriteSMF
bool WriteSMF(const std::string &filename)
Write a Standard MIDI File containing the decoded music.
Definition: midifile.cpp:901
MidiFile::blocks
std::vector< DataBlock > blocks
sequential time-annotated data of file, merged to a single track
Definition: midifile.hpp:32
MidiFile::MoveFrom
void MoveFrom(MidiFile &other)
Move data from other to this, and clears other.
Definition: midifile.cpp:857
SMFHeader
Header of a Stanard MIDI File.
Definition: midi.h:16
MidiFile::ReadSMFHeader
static bool ReadSMFHeader(const std::string &filename, SMFHeader &header)
Read the header of a standard MIDI file.
Definition: midifile.cpp:406
MidiFile::DataBlock::realtime
uint32_t realtime
real-time (microseconds) since start of file this block should be triggered at
Definition: midifile.hpp:22
MidiFile::DataBlock
Definition: midifile.hpp:20
MidiFile::DataBlock::ticktime
uint32_t ticktime
tick number since start of file this block should be triggered at
Definition: midifile.hpp:21