Class: ScalePatterns

ScalePatterns()

Creates a class to hold state, and defines Patterns for creating and using that state to work with CsoundAC Scales. An instance of this class must be created at module scope and passed to the relevant Patterns. The constructor sets the number of voices in Chords associated with the Scale, by default 4.

State is co-ordinated with the triggers of the Patterns by only updating the state when the input of the Pattern changes.

Constructor

new ScalePatterns()

Source:

Classes

ScalePatterns

Methods

acCVV(is_onset, bass, voice, hap) → {Hap}

acSVV: Generate a note that represents a particular voice of the Chord of this.

Parameters:
Name Type Description
is_onset boolean

Indicates whether the Hap is the onset of this cycle.

bass number

The lowest possible voice; lower pitches are reflected back up.

voice number

The voice of the Chord to be used.

hap Hap

The current Hap.

Source:
Returns:

A new Hap.

Type
Hap

acS(is_onset, scale, hap) → {Hap}

acS: Insert a CsoundAC Scale into the Pattern's state.

Parameters:
Name Type Description
is_onset boolean

Indicates whether this Hap is the onset of its cycle.

scale Scale

The Scale object to be used.

hap Hap

The current Hap.

Source:
Returns:

A new Hap.

Type
Hap

acSCV(is_onset, hap) → {Hap}

acSCV: Move notes in the Pattern to fit the Chord in the Pattern's state.

Parameters:
Name Type Description
is_onset number

Indicates whether this Hap is the onset of its cycle.

hap Hap

The current Hap.

Source:
Returns:

A new Hap.

Type
Hap

acSM(is_onset, index, hap) → {Hap}

acSM: Modulate from the Scale in the Pattern's state, using the Chord in the state as a pivot, choosing one of the possible modulations by index.

Parameters:
Name Type Description
is_onset boolean

Indicates whether this Hap is the onset of its cycle.

index number

The index of the specific modulation to be used.

hap Hap

The current Hap.

Source:
Returns:

A new Hap.

Type
Hap

acSO(is_onset, revoicings, hap) → {Hap}

acSO: Transforms the Chord of this by the indicated number of octavewise revoicings: negative means subtract an octave from the highest voice, positive means add an octave to the lowest voice. This corresponds to the musician's notion of "inversion."

Parameters:
Name Type Description
is_onset boolean

Indicates whether this Hap is the onset of its cycle.

revoicings number

The number of octavewise revoicings to apply to the Chord in this.

hap Hap

The current Hap.

Source:
Returns:

A new Hap.

Type
Hap

acSS(is_onset, scale_step, hap) → {Hap}

acSS: Insert the Chord at the specified scale step of the Scale in the Pattern's state, into the state.

Parameters:
Name Type Description
is_onset boolean

Indicates whether this Hap is the onset of its cycle.

scale_step number

The specific scale step of the Chord in the Scale.

hap Hap

The current Hap.

Source:
Returns:

A new Hap.

Type
Hap

acST(is_onset, scale_steps, hap) → {Hap}

acST: Transpose the Chord in the Pattern's state by the specified number of scale steps in the Scale in the state.

Parameters:
Name Type Description
is_onset boolean

Indicates whether this Hap is the onset of its cycle.

scale_steps number

The number of steps in this Scale by which to transpose the Chord in this.

hap Hap

The current Hap.

Source:
Returns:

A new Hap.

Type
Hap

acSV(is_onset, The) → {Hap}

acSV: Move notes in the Pattern to fit the Scale in the Pattern's state.

Parameters:
Name Type Description
is_onset boolean

Indicates whether this Hap is the onset of its cycle.

The Hap

current Hap.

Source:
Returns:

A new Hap.

Type
Hap

acSVVL(is_onset, bass, range, voice, hap) → {Hap}

acSVVL: Generate a note that represents a particular voice of the current Chord, as the closest voice-leading from the prior Chord.

Parameters:
Name Type Description
is_onset boolean

Indicates whether this Hap is the onset of its cycle.

bass number

The lowest pitch in this chord space.

range number

The range of this chord space.

voice number

The number of the Chord voice to be used.

hap Hap

The current Hap.

Source:
Returns:

A new Hap.

Type
Hap