Sc3 samples are 32-bit Float. hsc3 uses 64-bit Double. If Ugen values are used more generally (ie. see hsc3-forth) Float may be too imprecise, i.e. for representing time stamps.

Union type of Unit Generator forms.

Lookup operator name for operator Ugens, else Ugen name.

Ugen form or sc3_round_to.

constant of parse_double.

See into Constant_U.

Value of Constant_U Constant.

Erroring variant.

Multiple root graph constructor.

See into Mrg_U, follows leftmost rule until arriving at non-Mrg node.

Constant node predicate.

True if input is a sink Ugen, ie. has no outputs. Sees into Mrg.

See into Proxy_U.

Is Ugen a Proxy?

Get Primitive from Ugen if Ugen is a Primitive.

Is Ugen a Primitive?

Multiple channel expansion node constructor.

Type specified mce_to_list.

Multiple channel expansion node (Mce_U) predicate. Sees into Mrg.

Output channels of Ugen as a list. If required, preserves the RHS of and Mrg node in channel 0.

Number of channels to expand to. This function sees into Mrg, and is defined only for Mce nodes.

Erroring variant.

Extend Ugen to specified degree. Follows "leftmost" rule for Mrg nodes.

Is Mce required, ie. are any input values Mce?

Apply Mce transform to a list of inputs. The transform extends each input so all are of equal length, and then transposes the matrix.

mceInputTransform [mce2 1 2,mce2 3 4] == Just [[1,3],[2,4]]
mceInputTransform [mce2 1 2,mce2 3 4,mce3 5 6 7] == Just [[1,3,5],[2,4,6],[1,3,7]]
mceInputTransform [mce2 (mce2 1 2) (mce2 3 4),mce2 5 6] == Just [[mce2 1 2,5],[mce2 3 4,6]]

Build a Ugen after Mce transformation of inputs.

True if Mce is an immediate proxy for a multiple-out Primitive. This is useful when disassembling graphs, ie. ugen_graph_forth_pp at hsc3-db. It's also useful when editing a Primitive after it is constructed, as in bracketUgen.

Attach Brackets (initialisation and cleanup message sequences) to Ugen. For simplicity and clarity, brackets can only be attached to Primitive, Constant and Control nodes. This will look into the direct (immediate) proxies of a Primitive.

Retrieve Brackets from Ugen.

Ensure input Ugen is valid, ie. not a sink.

Constant value node constructor.

Type specialised constant.

Type specialised constant.

Type specialised constant.

Unit generator proxy node constructor.

Determine the rate of a Ugen.

Apply proxy transformation if required.

Filters with DemandRate inputs run at ControlRate. This is a little unfortunate, it'd be nicer if the rate in this circumstance could be given.

Construct proxied and multiple channel expanded Ugen.

cf = constant function, rs = rate set, r = rate, nm = name, i = inputs, i_mce = list of Mce inputs, o = outputs.

Operator Ugen constructor.

Unary math constructor.

Binary math constructor with constant optimisation.

constant 2 * constant 3 == constant 6

let o = sinOsc ar 440 0

o * 1 == o && 1 * o == o && o * 2 /= o
o + 0 == o && 0 + o == o && o + 1 /= o
o - 0 == o && 0 - o /= o
o / 1 == o && 1 / o /= o
o ** 1 == o && o ** 2 /= o

Plain (non-optimised) binary math constructor.

Is u the primitive for the named Ugen.

Is u the primitive for the named Ugen.

Is u a binary math operator with SPECIAL of k.

Is u an ADD operator?

Is u an MUL operator?

MulAdd re-writer, applicable only directly at add operator Ugen. The MulAdd Ugen is very sensitive to input rates. Add=AudioRate with In|Mul=InitialisationRate|Const will crash scsynth. This only considers primitives that do not have bracketing messages.

MulAdd optimiser, applicable at any Ugen (ie. checks u is an ADD ugen)

import Sound.Sc3
g1 = sinOsc ar 440 0 * 0.1 + control ir "x" 0.05
g2 = sinOsc ar 440 0 * control ir "x" 0.1 + 0.05
g3 = control ir "x" 0.1 * sinOsc ar 440 0 + 0.05
g4 = 0.05 + sinOsc ar 440 0 * 0.1

Sum3 re-writer, applicable only directly at add operator Ugen. This only considers nodes that have no bracketing messages.

Sum3 optimiser, applicable at any u (ie. checks if u is an ADD operator).

sum3_optimise of mul_add_optimise.