Global

Global instance of Csound, shared with Strudel.

Global instance of CsoundAC.

Sets the level of diagnostic messages in this module.

Global reference to the cloud-5 parameters addon.

Creates and initializes a CsoundAC Chord object. This function should be called from module scope in Strudel code before creating any Patterns. The Chord class is based on Dmitri Tymoczko's model of chord space, and represents an equally tempered chord of the specified number of voices as a single point in chord space, where each dimension of the space corresponds to one voice of the Chord. Chords are equipped with numerous operations from pragmatic music theory, atonal music theory, and neo-Riemannian music theory.

A utility for making a value copy of a Chord (or a Scale, which is derived from Chord). Object b is resized to the size of a, and a's pitches are copied to b. Currently, only pitches are copied.

Creates and initializes a CsoundAC PITV object. This function should be called from module scope in Strudel code before creating any Patterns. The PITV object is a 4 dimensional cyclic group whose dimensions are TI set class (P), chord inversion (I), pitch-class transposition (T), and index of octavewise revoicing within the specified range (V). The elements of the group are chords in 12 tone equal temperament with the specified number of voices. There is a one-to-one mapping between PITV indices and chords, such that each voiced chord corresponds to a PITV index, and each PITV index corresponds to a voiced chord. This enables algorithmically generating harmonies and voicings by independently varying P, I, T, and V.

Creates and initializes a CsoundAC Scale object. This function can be called from module scope in Strudel code before creating any Patterns. The Scale class is derived from the CsoundAC Chord class, but has been equipped with additional methods based on Dimitri Tymoczko's model of functional harmony. This enables algorithmically generating Chords from scale degrees, transposing Chords by scale degrees, generating all possible modulations given a pivot chord, and implementing secondary dominants and tonicizations based on scale degree.

Replaces the order of instruments in a generated CsoundAC Score with a new order. Instrument numbers are re-ordered as if they are integers. The new_order parameter is a map, e.g. {1:5, 3:1, 4:17}. The map need not be complete.

Replaces the order of instruments in a Silencio Score with a new order. Instrument numbers are re-ordered as if they are integers. The new_order parameter is a map, e.g. {1:5, 3:1, 4:17}. The map need not be complete.

Generates a new copy(s) of the Score in canon to the original, at the specified delay in seconds and transposition in semitones (which may be fractional). If a Scale is supplied, the new Score is conformed to that Scale.

A Pattern that sends notes to Csound for rendering with MIDI semantics. Hap values are translated to Csound pfields as follows:

 p1 -- Csound instrument either as a number (1-based, can be a fraction),
       or as a string name.
 p2 -- time in beats (usually seconds) from start of performance.
 p3 -- duration in beats (usually seconds).
 p4 -- MIDI key number from Strudel's Hap value (as a real number, not an 
       integer, in [0, 127].
 p5 -- MIDI velocity from Strudel's `gain` control (as a real number, not 
       an integer, in [0, 127].
 p6 -- Spatial depth dimension, from a `depth` control, defaulting to 0.
 p7 -- Spatial pan dimension, from Strudel's `pan` control, in [0, 1],
       defaulting to 0.5.
 p8 -- Spatial height dimension, from a `height` control, defaulting to 0.

Prints a diagnostic message to both the Strudel logger and the Csound log. Messages are printed only for the specifed diagnostic level or less.

Gets and/or sets the level of diagnostic messages.

Called by cloud-5 when sampling the WebGL video canvas to reduce the bandwidth of the data, e.g. in preparation for translating it to musical notes.

Adapts https://github.com/pingec/downsample-lttb from time series data to vectors of float HSV pixels. Our data is not [[time, value], [time, value],...], but rather [[column, value, [h,s,v]],...]. The algorithm uses column and value, but [h,s,v] go along for the ride.

A utility that returns the MIDI key number for a frequency in Hz, as the nearest integer.

A utility that returns the MIDI key number for a frequency in Hz, as a real number allowing fractions for microtones.

Returns the frequency corresponding to any of various ways that pitch is represented in Strudel events.

Returns a singleton instance of Csound, if one is available in the JavaScript environment. If Csound has not been loaded, attempts are made to load it from various sources. The csound_message_callback parameter is required, but console.log can be passed.

Returns the RGB color for an HSV color.

There is an issue on Android in that csound may be undefined when the page is first rendered, and be defined only when the user plays the piece.

Tests if Csound is null or undefined.

Called by the browser to resize arrays that are used to sample the WebGL canvas during performance.

Converts an RGB color value to HSV. The formula is adapted from http://en.wikipedia.org/wiki/HSV_color_space.

A utility that assigns a pitch represented as a MIDI key number to the Hap, using the existing pitch property if it exists.

Similar to arrange, but permits a section to be silenced by setting its number of cycles to 0; useful for assembling Patterns into longer-form compositions.

Creates a URL for a soundfile recorded by this piece. All such files exist by default in the Emscripten MEMFS filesystem at '/'.

May be called to store data to the local filesystem. This is used e.g. to save a copy of the generated Csound .csd file before starting the performance. This can help with debugging. Note that in a browser-based performance, the local filesystem is inside the sandbox.