audioeffects

Forty-five effect classes built out of audiodsp’s audio nodes.

Every class wires itself from an audio source - a synthesizer, an instrument’s output, a host input, or a previous effect’s output - and exposes its chain tail as output. See README.md for the catalogue.

import audioeffects comp = audioeffects.create(“Compressor”, source, 48000,

threshold_db=-20, ratio=3)

audio_out.play(comp.output)

The package factory receives the source and sample rate explicitly. Direct class construction is supported for local code too, and reads the format off the source it is handed.

Some classes also carry patches - named settings on the 0-127 MIDI grid, the way an instrument does. See README.md, “A note on patches”.

audioeffects.configure(rate, channel_count=2)[source]

Record a default format. Kept for code that calls it; an effect’s format always comes from its source, so this changes no effect.

audioeffects.sample_rate()[source]

The rate configure() last recorded (48000 until it is called).

audioeffects.channel_count()[source]

The channel count configure() last recorded (2 until it is called).

audioeffects.create(name, source, sample_rate, transport=None, **options)[source]

Construct the public effect named name.

This is the effect-side counterpart to audioinstruments.create. The selected class’s create method owns the actual construction, so a consumer does not need to know which module contains it.