Type of unique identifier.

Data type for the identifier at a Primitive UGen.

Alias of NoId, the UGenId used for deterministic UGens.

SC3 samples are 32-bit Float. hsc3 represents data as 64-bit Double. If UGen values are used more generally (ie. see hsc3-forth) Float may be too imprecise, ie. for representing time stamps.

Constants.

Constant 3 == Constant 3
(Constant 3 > Constant 1) == True

Control meta-data.

3-tuple form of Control_Meta data.

Lift Control_Meta_T3 to Control_Meta allowing type coercion.

5-tuple form of Control_Meta data.

Lift Control_Meta_T5 to Control_Meta allowing type coercion.

Controls may form part of a control group.

The number of elements in a control group.

Grouped controls have names that have equal prefixes and identifying suffixes. Range controls have two elements, minima and maxima, suffixes are [ and ]. Array controls have N elements and have IX suffixes. XY controls have two elements, X and Y coordinates, suffixes are X and Y.

Control inputs. It is an invariant that controls with equal names within a UGen graph must be equal in all other respects.

Labels.

Unit generator output descriptor.

Operating mode of unary and binary operators.

UGen primitives.

Proxy indicating an output port at a multi-channel primitive.

Multiple root graph.

Union type of Unit Generator forms.

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?

Multiple channel expansion node constructor.

Type specified mce_elem.

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]]

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.

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 DR inputs run at KR. 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 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=AR with IN|MUL=IR|CONST will CRASH scsynth.

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.

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

sum3_optimise of mul_add_optimise.