zdoom/fluidsynth
0
0
Fork 0
mirror of https://github.com/ZDoom/fluidsynth.git synced 2024-11-30 16:01:51 +00:00
Code Issues Projects Releases Packages Wiki Activity
Software synthesizer based on the SoundFont 2 specifications
1249 commits 10 branches 46 tags 9.2 MiB
C 92.2%
CMake 5.6%
C++ 1.1%
Shell 0.9%
Find a file
Tom M 2d83700dc7
Merge pull request #315 from carlo-bramini/misc-fixes-3 
Remove redundant includes and avoid zero-size array if MIDI input unavailable.
2017-12-27 18:04:06 +01:00
.github Update issue_template.md 2017-11-11 16:55:36 +01:00
bindings fluid_gen_info[] made as a const object 2017-10-21 12:46:13 +02:00
cmake_admin Disable network at compile time (option) (#307) 2017-12-17 10:25:54 +01:00
doc cleanup API doc 2017-12-27 17:55:04 +01:00
include fix build 2017-12-27 17:59:59 +01:00
src Merge pull request #315 from carlo-bramini/misc-fixes-3 2017-12-27 18:04:06 +01:00
.appveyor-vcpkg.yml add a vcpkg based appveyor build config 2017-12-14 19:59:50 +01:00
.appveyor.yml ensure appveyor builds all branches 2017-11-13 17:05:23 +01:00
.clang-format add config file for clang-format 2017-09-16 20:31:38 +02:00
.clang-tidy add .clang-tidy 2017-10-21 11:03:06 +02:00
.gitignore add gitignore 2017-09-23 18:17:40 +02:00
.travis.yml travis: remove repo george-edison55-precise-backports 2017-10-20 15:30:40 +02:00
AUTHORS Merge branch 'poly-pressure' of https://github.com/mawe42/fluidsynth into mawe42-poly-pressure 2017-09-10 13:59:07 +02:00
ChangeLog remove fop-level "fluidsynth" directory node 2017-09-03 13:30:26 +02:00
clang-format.sh add batch file for clang-format 2017-09-16 20:41:10 +02:00
CMakeLists.txt Disable network at compile time (option) (#307) 2017-12-17 10:25:54 +01:00
CONTRIBUTING.md Update CONTRIBUTING.md 2017-11-04 09:05:17 +01:00
fluidsynth.pc.in remove fop-level "fluidsynth" directory node 2017-09-03 13:30:26 +02:00
fluidsynth.spec.in remove fop-level "fluidsynth" directory node 2017-09-03 13:30:26 +02:00
INSTALL update INSTALL 2017-09-15 11:32:37 +02:00
LICENSE move README and LICENSE to top-level dir 2017-07-27 12:11:26 +02:00
NEWS remove fop-level "fluidsynth" directory node 2017-09-03 13:30:26 +02:00
README-OSX remove fop-level "fluidsynth" directory node 2017-09-03 13:30:26 +02:00
README.cmake README.cmake: cleanup orphaned link 2017-12-15 19:31:42 +01:00
README.md only show master build in appveyor badge 2017-12-15 19:00:07 +01:00
run-clang-tidy.py add py script to run clang-tidy 2017-10-21 12:16:54 +02:00
THANKS remove fop-level "fluidsynth" directory node 2017-09-03 13:30:26 +02:00
TODO update API docs about 24bit sample support 2017-12-09 17:50:06 +01:00

README.md

FluidSynth

Build Status glib < 2.30 glib >= 2.30
Linux/MacOSX n.a. Build Status Travis
Windows Build status Appveyor Build status

FluidSynth is a software real-time synthesizer based on the Soundfont 2 specifications.

FluidSynth reads and handles MIDI events from the MIDI input device. It is the software analogue of a MIDI synthesizer. FluidSynth can also play midifiles using a Soundfont.

Information on the web

The place to look if you are looking for the latest information on FluidSynth is the web site at http://www.fluidsynth.org/.

Why did we do it

The synthesizer grew out of a project, started by Samuel Bianchini and Peter Hanappe, and later joined by Johnathan Lee, that aimed at developing a networked multi-user game.

Sound (and music) was considered a very important part of the game. In addition, users had to be able to extend the game with their own sounds and images. Johnathan Lee proposed to use the Soundfont standard combined with an intelligent use of midifiles. The arguments were:

  • Wave table synthesis is low on CPU usage, it is intuitive and it can produce rich sounds

  • Hardware acceleration is possible if the user owns a Soundfont compatible soundcard (important for games!)

  • MIDI files are small and Soundfont2 files can be made small thru the intelligent use of loops and wavetables. Together, they are easier to downloaded than MP3 or audio files.

  • Graphical editors are available for both file format: various Soundfont editors are available on PC and on Linux (Smurf!), and MIDI sequencers are available on all platforms.

It seemed like a good combination to use for an (online) game.

In order to make Soundfonts available on all platforms (Linux, Mac, and Windows) and for all sound cards, we needed a software Soundfont synthesizer. That is why we developed FluidSynth.

Design decisions

The synthesizer was designed to be as self-contained as possible for several reasons:

  • It had to be multi-platform (Linux, MacOS, Win32). It was therefore important that the code didn't rely on any platform specific library.

  • It had to be easy to integrate the synthesizer modules in various environements, as a plugin or as a dynamically loadable object. I wanted to make the synthesizer available as a plugin (jMax, LADSPA, Xmms, WinAmp, Director, ...); develop language bindings (Python, Java, Perl, ...); and integrate it into (game) frameworks (Crystal Space, SDL, ...). For these reasons I've decided it would be easiest if the project stayed very focussed on it's goal (a Soundfont synthesizer), stayed small (ideally one file) and didn't dependent on external code.

Links

Home Page

Documentation

Software SoundFont Synthesizers:

Soundfont Editors

Conversion Tools

Soundfont Databases