Instruments Reference
An RTcmix instrument is a scorefile or interface-object command. There are two main types: synthesis instruments, which generate audio, and processing instruments, which accept input audio and output a modified version of it. There are also a small set of special-case instruments which perform other actions (see below). When an RTcmix instrument command is called, RTcmix instantiates a unique copy of itself with the parameters for the specific event (starting time, duration, etc.) included. This instrument/note object is then scheduled for execution at the appropriate starting time during playback.
Listed by Topic
Synthesis Instruments
These generate audio and send it via an aux or output bus.
Wavetable
- HALFWAVE — constructed wavetable (synthesis)
- MULTIWAVE — additive synthesis
- SYNC — hard sync oscillator synthesis instrument
- VWAVE — vector wavetable synthesis
- WAVETABLE — wavetable oscillator
- WAVESHAPE — waveshaping synthesis
- WAVY — two-oscillator modulating synthesis
- WIGGLE — wavetable oscillator with frequency modulation and filter
Granular
Noise
Frequency modulation
- FMINST — frequency modulator (synthesis)
- MULTIFM — configurable multi-oscillator FM synthesis instrument
Miscellaneous
- AMINST — amplitude modulator (synthesis)
- LPCPLAY — Linear Predective Coding (LPC) resynthesis
- SCULPT — frequency/amplitude pair-based resynthesis
Physical Modeling
- CLAR — early clarinet physical model
- MBANDEDWG — banded waveguide (bars/modal things, struck & bowed) physical model
- MBLOWBOTL — simple Helmholtz resonator physical model
- MBLOWHOLE — clarinet physical model with tonehole and register vent
- MBOWED — bowed string physical model
- MBRASS — brass instrument physical model
- MCLAR — another clarinet physical model
- METAFLUTE — early, extended flute physical model
- SFLUTE — basic flute model
- VSFLUTE — basic flute model with vibrato
- BSFLUTE — basic flute model with pitch-bend
- LSFLUTE — basic flute model for legato slurs
- MMESH2D — waveguide model of a 2D mesh
- MMODALBAR — physical model of struck bars
- MSAXOFONY — saxophone physical model
- MSHAKERS — “shaken” instrument physical models
- MSITAR — sitar physical model
- STRUM — extended Karplus-Strong (“plucked string”) algorithm, with distortion and feedback
- START — basic model
- BEND — basic model with pitch bend
- FRET — basic model fretted from previous note
- START1 — feedback/distortion model
- BEND1 — feedback/distortion model with pitch bend
- FRET1 — feedback/distortion model fretted from previous note
- VSTART1 — feedback/distortion model with vibrato
- VFRET1 — feedback/distortion model fretted from previous note, with vibrato
- STRUM2 — tuned Karplus-Strong (“plucked string”) algorithm
- STRUMFB — extended Karplus-Strong (“plucked string”) algorithm, with distortion and feedback
Processing Instruments
These recieve audio from either an input file or an aux bus and send audio out via an aux or output bus.
Mixing & Panning
- MIX — simple soundfile mixing command
- NPAN — multichannel panning
- PAN — stereo panning
- QPAN — 4-channel panning
- REVMIX — reverse input soundfile
- STEREO — stereo mixing
Transposing & Pitch shifting
- MOCKBEND — real-time pitch-shifter with dynamic modification of pitch
- SCRUB — fowards/backwards pitch shifter
- TRANS — pitch-shifter
- TRANS3 — pitch-shifter (3rd-order interpolation)
- TRANSBEND — pitch-shifter with dynamic modification of pitch
Amplitude modulation & Distortion
- AM — amplitude modulator (signal-processor)
- COMPLIMIT — audio compressor/limiter
- DECIMATE — reduce bit-representation of input sound amplitude
- DISTORT — distortion (clip) signal-procesor
- FOLLOWER — simple envelope (amplitude) follower
- FOLLOWGATE — envelope (amplitude) follower controlling an amplitude gate
- SHAPE — waveshape an input sound
Filters & Equalizers
- BUTTER — time-varying Butterworth filter (high- or low-pass)
- DCBLOCK — remove (most of) DC bias from input signal
- ELL — elliptical filter
- EQ — equalizer instrument (peak/notch, shelving and high/low pass types)
- FIR — finite impulse response filter
- FILTERBANK — multi-band reson instrument (with dynamic control)
- FILTSWEEP — time-varying biquad filter (band-pass)
- FOLLOWBUTTER — envelope (amplitude) follower controlling a Butterworth filter
- HOLO — stereo FIR filter to perform crosstalk cancellation
- IIR — infinite impulse response filter
- setup — set up the IIR filter
- INPUTSIG — filter an input signal
- IINOISE — generate and filter noise
- BUZZ — generate and filter a buzz signal
- PULSE — generate and filter a pulse signal
- JFIR — finite impulse response filter specified by frequency curve
- LPCIN — Linear Predective Coding (LPC) resynthesis using input sound through the LPC filters
- MOOGVCF — dynamic resonant low-pass filter
- MULTEQ — equalizer instrument with dynamic filter sections
Vocoders
- PVOC — phase vocoder
- VOCODE2 — channel vocoder
- VOCODE3 — a more flexible channel vocoder
- VOCODESYNTH — channel vocoder with oscillator-bank carrier
Delays & Comb Filters
- COMBIT — comb filter
- DEL1 — single stereo delay
- DELAY — simple regenerating delay
- FLANGE — notch or comb “flange” filter
- JDELAY — regenerating delay + low-pass filter
- MULTICOMB — four comb filters simultaneously
- PANECHO — stereo “ping-pong” regenerating delays
Room simulation & Spacial Placement
- DMOVE — high-quality room simulation program for moving sources with dynamic control (multiple inputs)
- FREEVERB — good-sounding reverbator
- GVERB — good-sounding reverberator with long reverb times
- LOCALIZE — delay/amplitude/filter-based localization instrument
- MMOVE — high-quality room simulation program for moving sources (multiple inputs)
- MPLACE — high-quality room simulation program for stationary sources (multiple inputs)
- MOVE — high-quality room simulation program for moving sources
- MROOM — room simulation program for moving sources
- PLACE — high-quality room simulation program for stationary sources
- REV — three different reverberation algorithms
- REVERBIT — Schroeder reverb
- ROOM — delay line room-simulation model
- SROOM — room simulation for stationary sources
FFT-based
Miscellaneous
- CHAIN — connect a set of instruments together so they execute as one
- GRANULATE — granularize an input soundfile table
- JCHOR — granulated, random-wait chorus (signal-processor)
- SPLITTER — output routing
- STGRANR — sampling stochastic granular processing
Special-Case Instruments
These perform special actions and neither generate nor process audio.
MIDI
- MIDI — real-time scheduled MIDI control of an external device
- NOTE — send MIDI note on events
- CONTROLLER — send MIDI controller events
- PITCHBEND — send MIDI pitch bend events
- PROGRAM — send MIDI program change events
Miscellaneous
All Instruments, Listed in Alphabetical Order