Expand description
§Rust fluidlite bindings
This project aims provide safe Rust bindings to fluidlite C library.
FluidLite is a very light version of FluidSynth designed to be hardware, platform and external dependency independant. It only uses standard C libraries.
It also adds support for SF3 files (SF2 files compressed with ogg vorbis) and an additional setting to remove the constraint of channel 9 (drums): fluid_settings_setstr(settings, “synth.drums-channel.active”, “no”); you can still select bank 128 on any channel to use drum kits.
FluidLite keeps very minimal functionnalities (settings and synth), therefore MIDI file reading, realtime MIDI events and audio output must be implemented externally.
§Crates
- fluidlite Safe bindings
- fluidlite-sys Unsafe bindings (generated using bindgen)
§Features
- bindgen Force generate bindings itself instead of use pre-generated
- builtin Force compile builtin fluidlite C-library
- pkg-config Use pkg-config to find installed libraries
- with-sf3 Enable SoundFont3 support (SF2 with vorbis-encoded samples)
- with-stb Use stb-vorbis decoder instead of libvorbis/libogg.
- shared Build shared fluidlite C-library
- static Build static fluidlite C-library
When pkg-config feature is used the installed fluidlite library will be used if found. To force build and link builtin version you can use builtin feature.
§Example
use std::{fs::File, io::Write};
use byte_slice_cast::AsByteSlice;
use fluidlite::{Settings, Synth};
let settings = Settings::new().unwrap();
let synth = Synth::new(settings).unwrap();
synth.sfload("sf_/Boomwhacker.sf3", true).unwrap();
let mut buffer = [0i16; 44100 * 2];
let mut file = File::create("soundfont-sample.pcm").unwrap();
synth.note_on(0, 60, 127).unwrap();
synth.write(buffer.as_mut()).unwrap();
file.write(buffer.as_byte_slice()).unwrap();
synth.note_off(0, 60).unwrap();
synth.write(buffer.as_mut()).unwrap();
file.write(buffer.as_byte_slice()).unwrap();Structs§
- FnLogger
- Closure logger wrapper
- FontRef
- Reference to SoundFont object
- Hints
- The setting hints
- Loader
- The SoundFont loader object
- Log
- Logging
- LogLogger
- Logger implementation backed by log crate.
- Preset
Ref - Reference to Preset object
- Range
- The range of setting value
- Setting
- The single setting of specific type
- Settings
- The generic settings object
- Settings
Ref - The settings reference
- Synth
- The synth object
- Tuning
Iter - The iterator over tunings
- Version
- The library version info
Enums§
Traits§
- FileApi
- The file reading API
- IsFont
- The SoundFont interface
- IsPreset
- The SoundFont preset interface
- IsSamples
- The trait which implements samples data buffer interface
- IsSetting
- The single setting object interface
- IsSettings
- The settings interface
- Logger
- Log output handler