OpenTTD Source 20241224-master-gf74b0cf984
fluidsynth.cpp
Go to the documentation of this file.
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
10#include "../stdafx.h"
11#include "../openttd.h"
12#include "../sound_type.h"
13#include "../debug.h"
14#include "fluidsynth.h"
15#include "midifile.hpp"
16#include <fluidsynth.h>
17#include "../mixer.h"
18#include <mutex>
19
20static struct {
21 fluid_settings_t *settings;
22 fluid_synth_t *synth;
23 fluid_player_t *player;
24 std::mutex synth_mutex;
26
29
31static const char *default_sf[] = {
32 /* FluidSynth preferred */
33 /* See: https://www.fluidsynth.org/api/settings_synth.html#settings_synth_default-soundfont */
34 "/usr/share/soundfonts/default.sf2",
35
36 /* Debian/Ubuntu preferred */
37 /* See: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=929185 */
38 "/usr/share/sounds/sf3/default-GM.sf3",
39
40 /* OpenSUSE preferred */
41 "/usr/share/sounds/sf2/FluidR3_GM.sf2",
42
43 /* RedHat/Fedora/Arch preferred */
44 "/usr/share/soundfonts/FluidR3_GM.sf2",
45
46 /* Debian/Ubuntu/OpenSUSE alternatives */
47 "/usr/share/sounds/sf2/TimGM6mb.sf2",
48 "/usr/share/sounds/sf2/FluidR3_GS.sf2",
49
50 nullptr
51};
52
53static void RenderMusicStream(int16_t *buffer, size_t samples)
54{
55 std::unique_lock<std::mutex> lock{ _midi.synth_mutex, std::try_to_lock };
56
57 if (!lock.owns_lock() || _midi.synth == nullptr || _midi.player == nullptr) return;
58 fluid_synth_write_s16(_midi.synth, samples, buffer, 0, 2, buffer, 1, 2);
59}
60
61std::optional<std::string_view> MusicDriver_FluidSynth::Start(const StringList &param)
62{
63 std::lock_guard<std::mutex> lock{ _midi.synth_mutex };
64
65 const char *sfont_name = GetDriverParam(param, "soundfont");
66 int sfont_id;
67
68 Debug(driver, 1, "Fluidsynth: sf {}", sfont_name != nullptr ? sfont_name : "(null)");
69
70 /* Create the settings. */
71 _midi.settings = new_fluid_settings();
72 if (_midi.settings == nullptr) return "Could not create midi settings";
73 /* Don't try to lock sample data in memory, OTTD usually does not run with privileges allowing that */
74 fluid_settings_setint(_midi.settings, "synth.lock-memory", 0);
75
76 /* Install the music render routine and set up the samplerate */
77 uint32_t samplerate = MxSetMusicSource(RenderMusicStream);
78 fluid_settings_setnum(_midi.settings, "synth.sample-rate", samplerate);
79 Debug(driver, 1, "Fluidsynth: samplerate {:.0f}", (float)samplerate);
80
81 /* Create the synthesizer. */
82 _midi.synth = new_fluid_synth(_midi.settings);
83 if (_midi.synth == nullptr) return "Could not open synth";
84
85 /* Load a SoundFont and reset presets (so that new instruments
86 * get used from the SoundFont) */
87 if (sfont_name == nullptr) {
88 sfont_id = FLUID_FAILED;
89
90 /* Try loading the default soundfont registered with FluidSynth. */
91 char *default_soundfont;
92 fluid_settings_dupstr(_midi.settings, "synth.default-soundfont", &default_soundfont);
93 if (fluid_is_soundfont(default_soundfont)) {
94 sfont_id = fluid_synth_sfload(_midi.synth, default_soundfont, 1);
95 }
96
97 /* If no default soundfont found, try our own list. */
98 if (sfont_id == FLUID_FAILED) {
99 for (int i = 0; default_sf[i]; i++) {
100 if (!fluid_is_soundfont(default_sf[i])) continue;
101 sfont_id = fluid_synth_sfload(_midi.synth, default_sf[i], 1);
102 if (sfont_id != FLUID_FAILED) break;
103 }
104 }
105 if (sfont_id == FLUID_FAILED) return "Could not open any sound font";
106 } else {
107 sfont_id = fluid_synth_sfload(_midi.synth, sfont_name, 1);
108 if (sfont_id == FLUID_FAILED) return "Could not open sound font";
109 }
110
111 _midi.player = nullptr;
112
113 return std::nullopt;
114}
115
117{
118 MxSetMusicSource(nullptr);
119
120 std::lock_guard<std::mutex> lock{ _midi.synth_mutex };
121
122 if (_midi.player != nullptr) delete_fluid_player(_midi.player);
123 _midi.player = nullptr;
124
125 if (_midi.synth != nullptr) delete_fluid_synth(_midi.synth);
126 _midi.synth = nullptr;
127
128 if (_midi.settings != nullptr) delete_fluid_settings(_midi.settings);
129 _midi.settings = nullptr;
130}
131
133{
134 std::string filename = MidiFile::GetSMFFile(song);
135
136 this->StopSong();
137
138 if (filename.empty()) {
139 return;
140 }
141
142 std::lock_guard<std::mutex> lock{ _midi.synth_mutex };
143
144 _midi.player = new_fluid_player(_midi.synth);
145 if (_midi.player == nullptr) {
146 Debug(driver, 0, "Could not create midi player");
147 return;
148 }
149
150 if (fluid_player_add(_midi.player, filename.c_str()) != FLUID_OK) {
151 Debug(driver, 0, "Could not open music file");
152 delete_fluid_player(_midi.player);
153 _midi.player = nullptr;
154 return;
155 }
156 if (fluid_player_play(_midi.player) != FLUID_OK) {
157 Debug(driver, 0, "Could not start midi player");
158 delete_fluid_player(_midi.player);
159 _midi.player = nullptr;
160 return;
161 }
162}
163
165{
166 std::lock_guard<std::mutex> lock{ _midi.synth_mutex };
167
168 if (_midi.player == nullptr) return;
169
170 fluid_player_stop(_midi.player);
171 /* No fluid_player_join needed */
172 delete_fluid_player(_midi.player);
173 fluid_synth_system_reset(_midi.synth);
174 fluid_synth_all_sounds_off(_midi.synth, -1);
175 _midi.player = nullptr;
176}
177
179{
180 std::lock_guard<std::mutex> lock{ _midi.synth_mutex };
181 if (_midi.player == nullptr) return false;
182
183 return fluid_player_get_status(_midi.player) == FLUID_PLAYER_PLAYING;
184}
185
187{
188 std::lock_guard<std::mutex> lock{ _midi.synth_mutex };
189 if (_midi.settings == nullptr) return;
190
191 /* Allowed range of synth.gain is 0.0 to 10.0 */
192 /* fluidsynth's default gain is 0.2, so use this as "full
193 * volume". Set gain using OpenTTD's volume, as a number between 0
194 * and 0.2. */
195 double gain = (1.0 * vol) / (128.0 * 5.0);
196 if (fluid_settings_setnum(_midi.settings, "synth.gain", gain) != FLUID_OK) {
197 Debug(driver, 0, "Could not set volume");
198 }
199}
Factory for the fluidsynth driver.
Definition fluidsynth.h:33
std::optional< std::string_view > Start(const StringList &param) override
Start this driver.
void PlaySong(const MusicSongInfo &song) override
Play a particular song.
bool IsSongPlaying() override
Are we currently playing a song?
void StopSong() override
Stop playing the current song.
void SetVolume(uint8_t vol) override
Set the volume, if possible.
void Stop() override
Stop this driver.
#define Debug(category, level, format_string,...)
Ouptut a line of debugging information.
Definition debug.h:37
const char * GetDriverParam(const StringList &parm, const char *name)
Get a string parameter the list of parameters.
Definition driver.cpp:44
std::mutex synth_mutex
Guard mutex for synth access.
static FMusicDriver_FluidSynth iFMusicDriver_FluidSynth
Factory for the FluidSynth driver.
static struct @11 _midi
Metadata about the midi we're playing.
fluid_player_t * player
FluidSynth MIDI player handle.
fluid_synth_t * synth
FluidSynth synthesizer handle.
static const char * default_sf[]
List of sound fonts to try by default.
fluid_settings_t * settings
FluidSynth settings handle.
Base for FluidSynth music playback.
uint32_t MxSetMusicSource(MxStreamCallback music_callback)
Set source of PCM music.
Definition mixer.cpp:234
std::vector< std::string > StringList
Type for a list of strings.
Definition string_type.h:60
static std::string GetSMFFile(const MusicSongInfo &song)
Get the name of a Standard MIDI File for a given song.
Metadata about a music track.
std::mutex lock
synchronization for playback status fields
Definition win32_m.cpp:35