shithub: sf2mid

ref: 7f29067b40e7069910f1259fefee30f333af2ba4
dir: /README.md/

View raw version
# TinySoundFont
SoundFont2 synthesizer library in a single C/C++ file

## Overview

TinySoundFont is a software synthesizer using SoundFont2 sound bank files.

The library is a single C header file so it is extremely simple to integrate in your C/C++ projects.

```c++
#define TSF_IMPLEMENTATION
#include "tsf.h"

...

tsf* TinySoundFont = tsf_load_filename("soundfont.sf2");
tsf_set_output(TinySoundFont, TSF_MONO, 44100, 0); //sample rate
tsf_note_on(TinySoundFont, 0, 60, 1.0f); //preset 0, middle C
short HalfSecond[22050]; //synthesize 0.5 seconds
tsf_render_short(TinySoundFont, HalfSecond, 22050, 0);
```

The library code is based on [SFZero by Steve Folta](https://github.com/stevefolta/SFZero).

## Documentation

The API documentation can be found on [top of the library source code](https://github.com/schellingb/TinySoundFont/blob/master/tsf.h).

There are also [examples available](https://github.com/schellingb/TinySoundFont/tree/master/examples) which come with a sample SoundFont file and build and play sound on Win32, Win64, Linux and MacOSX with no further dependencies.

## Dependencies

C standard libraries for fopen, math and malloc (can be removed by providing custom functions with #defines).

## License

TinySoundFont is available under the [MIT license](https://choosealicense.com/licenses/mit/).