Karya, built on Sun Nov 26 01:04:37 PST 2017 (patch 0a920b2bde70c0cbac8ee09d158064798b61bbe5)

Derive.Controls

Description

This module defines control names understood by the default calls, or by the MIDI deriver. There are also conventional names for certain controls that instruments can use. Although each instrument as its own independent set of controls, they're easier to remember if they reuse some conventional names.

# Documentation

These controls should be combined with addition by default instead of multiplication.

Used as the default control by control block calls. This is because a ControlCall produces a Signal, but for it to be derived in a block it needs a temporary name.

The tempo track is handled differently than other controls, and winds up in the warp rather than the ControlMap.

Converted into velocity or breath depending on the instrument.

## generally understood by the note deriver

Scale note duration. This is multiplicative, so 1 is no change.

Note duration is documented in duration_attributes.

Add an absolute amount of real time to the duration of each note.

Start offset, in RealTime. This is added to event start times. The end times stay the same, so it changes note duration, and is limited to not force a note to 0 duration.

Start offset, in ScoreTime.

## specific to instruments

Variable mute control, where 1 is fully muted.

Finger weight, when stopping a string. In newtons.

## understood by MIDI performer

Breath controller. Generally you should use dynamic, which will emit velocity or breath depending on the instrument.

Channel pressure.

Polyphonic aftertouch. Unlike other controls, this one can share channels.

Modulation wheel.

Force MIDI note on velocity to this value. Normally a Pressure instrument will get both breath controller and note on velocity from the dynamic control, but sometimes I need separate control. This can be used to override the note on velocity.

Normally the NoteOff velocity is the same as dynamic, but if set, this force it to a particular value.

## transposition

The common transpose controls. A scale with special needs could still have its own unique transposers, but most all scales should respond to these.

Transpose by this many octaves.

Pitches respond to this with diatonic transposition, which generally requires a key. This is stepwise transposition for scales with no distinction between chromatic and diatonic.

Pitches respond to this with chromatic transposition. This is stepwise transposition for scales with no distinction between chromatic and diatonic.

Transpose by NoteNumber, which is cents / 100.

Transpose in absolute hz.

# conventional control names

Volume control, conventionally mapped to CC 7.

Sustain pedal.

# standard names for patches

Low and high pass filter cutoff.

Low and high pass filter cutoff.

Filter resonance.

Often mod is mapped to vibrato, but when it's more specifically vibrato depth rather than general modulation, whatever that is, it's nicer to use a more specific name.

Often mod is mapped to vibrato, but when it's more specifically vibrato depth rather than general modulation, whatever that is, it's nicer to use a more specific name.

Macro controls. Many synths have general-purpose "change the timbre" knobs.

Macro controls. Many synths have general-purpose "change the timbre" knobs.

Macro controls. Many synths have general-purpose "change the timbre" knobs.

Macro controls. Many synths have general-purpose "change the timbre" knobs.