Module synth 

Soundfont-backed fill sources: one SynthVoice per soundfont, mixed.

A voice lives in the audio world with the OnAudioFill that renders it, so it sounds by existing. Its synthesizer waits for the first fill, which reports the rate the stream really runs at: nothing has to know that rate before the device opens.

Gameplay never touches the synthesizer. A live note is a midi_job; a sequence is a MidiSequencer in the gameplay world, advanced once a frame, which sends the same jobs at the moments its events come due. The audio thread only turns messages into samples and sums every source into the stream’s interleaved frames.

Re-exports

use std::sync::Arc; 🔒

use rustysynth_ext::MidiFileError; 🔒

use rustysynth_ext::SoundFontError; 🔒

use rustysynth_ext::SynthesizerError; 🔒

use rustysynth_ext::SynthesizerSettings; 🔒

use unlit_ecs::Bundle; 🔒

use unlit_ecs::DynamicBundle; 🔒

use unlit_ecs::Entity; 🔒

use unlit_ecs::World; 🔒

use unlit_ecs::bundle; 🔒

use crate::audio::AudioChunk; 🔒

use crate::audio::AudioFillOrder; 🔒

use crate::audio::OnAudioFill; 🔒

use crate::job::Job; 🔒

use crate::job::JobSender; 🔒

Structs

MidiFile

Represents a standard MIDI file.

MidiSequencer

One sequence, its clock and where it loops.

SoundFont

Represents a SoundFont.

SynthVoice

A loaded soundfont and the synthesizer playing it, as one object.

Synthesizer

An instance of the SoundFont synthesizer.

Enums

MidiEventKind

A MIDI message the synthesizer acts on.

MidiFileLoopType

Specifies the type of the loop extension to use when playing back a MIDI file.

MidiMessage

A single event of a merged MIDI file.

VoiceError

Why a soundfont or a MIDI file could not be built.

Constants

BLOCK_FRAMES 🔒

The synthesizer’s block size, and how finely a fill places a message inside itself: a note lands on a block boundary, so this is the timing resolution below one fill.

Functions

add_stereo 🔒

Adds a stereo block onto the chunk’s interleaved frames.

fill_voice 🔒

Builds the voice’s synthesizer if it has none, adds the queue’s messages at their offsets, and renders the whole fill into the chunk.

load_midi_file_with_loop_type

Parses a standard MIDI file from bytes, reading its loop markers the way loop_type describes.

load_soundfont

Parses the soundfont in bytes.

midi_file

Builds a MIDI file from timed messages, ready for MidiSequencer::new.

midi_job

A job that sends kind to voice, delay seconds from the next fill’s start. A negative delay is treated as zero.

synthesizer 🔒

The synthesizer font plays through at rate, set up the way a voice wants it: full scale out of the box, because the library’s default of 0.5 is a -6 dB cut that every caller would otherwise have to undo.

Type Aliases

MidiEvent

One MIDI message and when to send it: seconds since the sequence starts, then the message.