Make a simple scale where there is a direct mapping from input to note to nn.

An empty scale that doesn't do anything.

Transpose function for a non-transposing scale.

Indicate that this scale responds to the standard set of transpose signals. It still has to implement the support in its scale_note_to_call.

A specialization of note_to_call that operates on scales with a DegreeMap, i.e. a static map from notes to degrees, and from degrees to NNs.

Create a note call that respects chromatic and diatonic transposition. However, diatonic transposition is mapped to chromatic transposition, so this is for scales that don't distinguish.

Input to note for simple scales without keys.

Input to NoteNumber for scales that have a direct relationship between Degree and NoteNumber.

An Input maps directly to a NoteNumber. This is an efficient implementation for scales tuned to 12TET.

This obeys Controls.octave but none of the other transposer controls. This is inconsistent with computed_input_to_nn, but trying to implement diatonic transposition would make this not so direct any more. And in any case, Cmd.MidiThru shouldn't let through any transposers other than octave.

Convert input to nn by going through note_to_call. This works for complicated scales that retune based on the environment but is more work.

Convert an absolute Pitch in the input keyboard's layout to a relative Pitch within a scale with the given number of diatonic steps per octave, or Nothing if that key should have no pitch.

The MIDI kbd is absolute. This means that relative scales start on different keys rather than all starting on C. For example, in C major C produces the first scale degree, while in D major D produces the first scale degree.

In addition, if the scale octave is not an even multiple of the kbd octave (7), the extra notes produce Nothing. This check has to be done to the relative PitchClass. That way, a D on a 6 note scale starting on D is 1, and a C is Nothing. Thus, the returned Pitch is relative to the given tonic, so it should be formatted as-is, without the key.

The ASCII kbd is relative. This means that relative scales always start on "C". So the tonic note of a key in a relative scale is irrelevant, C major and D major both start in the same place. Of course, they produce different frequencies, but that's the responsibility of scale_note_to_call.

Unlike absolute_to_pitch, if the scale octave is not an even multiple of the kbd octave (10), the extra notes wrap to the next highest octave.

Try to fit a note from a keyboard into a scale. Round the note up to the nearest multiple of the keyboard octave and adjust the octave accordingly.

Documentation of the standard scale_degree.

Prepend a bit of text to the documentation.

Like read_environ_, but with a simpler parser.

Like read_environ, except the default is given to the parse function.

Read and parse an environ value, or throw a ScaleError. This takes a parse function in addition to the usual Typecheck, because scales and keys don't use use Typecheck, beyond ensuring it's a string.

Find a key in a map, or throw a ScaleError.