Crate midi_fundsp

This crate enables the construction of synthesizers with live MIDI input and sound synthesis using fundsp.

It is organized as follows:

• The crate root contains functions and data structures useful for constucting fundsp sounds.
  • MIDI input messages are converted into SharedMidiState objects that translate the sounds represented by those messages into fundsp Shared atomic variables.
  • SynthFunc functions translate SharedMidiState objects into specific fundsp audio graphs.
• The io module contains functions and data types for obtaining messages from MIDI devices and playing
  fundsp audio graphs through the computer’s speakers.
• The sound_builders module contains functions that wrap fundsp audio graphs into SynthFunc functions with a variety of properties.
• The sounds module contains SynthFunc functions that produce a variety of live sounds.

The following example programs show how these components interact to produce a working synthesizer:

• basic_demo.rs opens the first MIDI device it finds and plays a simple triangle waveform sound in response to MIDI events.
• stereo_demo.rs also opens the first MIDI device it finds. It plays notes below middle C through the left speaker using a Moog Pulse sound, and notes at Middle C or higher through the right speaker using a Moog Triangle sound.
• choice_demo.rs allows the user to choose one from among all connected MIDI devices. The user can then choose any sound from the sounds module for the program’s response to MIDI events.

Modules

io

sound_builders

sounds

Macros

program_table

Convenience macro to build a ProgramTable. Given a sequence of tuples of &str objects and SynthFunc objects, it returns a proper ProgramTable.

Structs

SharedMidiState

SharedMidiState objects represent as fundsp Shared atomic variables the following MIDI events:

SoundTestResult

When designing sounds, it can be useful to understand their typical output levels. SoundTestResult objects track the minimum, maximum, and mean output levels.

Constants

CONTROL_OFF

Control value in response to Note Off event.

CONTROL_ON

Control value in response to Note On event.

DURATION

Duration of test for SoundTestResult.

MAX_MIDI_VALUE

MIDI values for pitch and velocity range from 0 to 127.

NUM_MIDI_VALUES

Total quantity of distinct MIDI values.

SAMPLE_RATE

Sample rate of 44.1 kHz for use in SoundTestResult.

Functions

pitch_bend_factor

Converts MIDI pitch-bend message to frequency multiplier over +/- 1 semitone using this algorithm.

semitone_from

Converts MIDI pitch-bend message to +/- 1 semitone using this algorithm.

Type Aliases

SynthFunc

SynthFunc objects translate SharedMidiState values into fundsp audio graphs.