Sound.SC3.UGen.UGen

UGen data structure representation and associated functions.

Documentation

toUId :: ID a => a -> UGenId

UId of resolveID.

ugen_user_name :: String -> Special -> String

Lookup operator name for operator UGens, else UGen name.

UGen graph functions

ugenTraverse :: (UGen -> UGen) -> UGen -> UGen

Depth first traversal of graph at u applying f to each node.

ugenFoldr :: (UGen -> a -> a) -> a -> UGen -> a

Right fold of UGen graph.

Unit generator node constructors

control_f64 :: Rate -> Maybe Int -> String -> Sample -> UGen

Control input node constructor.

control :: Rate -> String -> Double -> UGen

Control input node constructor.

Note that if the name begins with a t_ prefix the control is not converted to a triggered control. Please see tr_control.

meta_control :: Rate -> String -> Double -> C_Meta_T5 Double -> UGen

Variant of control with meta data.

tr_control_f64 :: Maybe Int -> String -> Sample -> UGen

Triggered (kr) control input node constructor.

tr_control :: String -> Double -> UGen

Triggered (kr) control input node constructor.

control_set :: [UGen] -> [UGen]

Set indices at a list of controls.

mrg2 :: UGen -> UGen -> UGen

Multiple root graph node constructor.

Multiple channel expansion

mce2 :: UGen -> UGen -> UGen

Multiple channel expansion for two inputs.

mce2c :: UGen -> (UGen, UGen)

Extract two channels from possible MCE, if there is only one channel it is duplicated.

unmce2 :: UGen -> (UGen, UGen)

Variant of mce2c that requires input to have two channels.

mce3 :: UGen -> UGen -> UGen -> UGen

Multiple channel expansion for two inputs.

mceMap :: (UGen -> UGen) -> UGen -> UGen

Apply a function to each channel at a unit generator.

map_ix :: ((Int, a) -> b) -> [a] -> [b]

Map with element index.

mce_map_ix :: ((Int, UGen) -> UGen) -> UGen -> UGen

Variant of mceMap with element index.

mceEdit :: ([UGen] -> [UGen]) -> UGen -> UGen

Apply UGen list operation on MCE contents.

mceReverse :: UGen -> UGen

Reverse order of channels at MCE.

mceChannel :: Int -> UGen -> UGen

Obtain indexed channel at MCE.

mceTranspose :: UGen -> UGen

Transpose rows and columns, ie. {{a,b},{c,d}} to {{a,c},{b,d}}.

mceSum :: UGen -> UGen

Collapse mce by summing (see also mix and mixN).

Transform

halt_mce_transform_f :: (a -> [a]) -> [a] -> [a]

Given unmce function make halt mce transform.

halt_mce_transform :: [UGen] -> [UGen]

The halt MCE transform, ie. lift channels of last input into list.

halt_mce_transform [1,2,mce2 3 4] == [1,2,3,4]

prepare_root :: UGen -> UGen

If the root node of a UGen graph is mce, transform to mrg.

Multiple root graphs

Labels

label :: String -> UGen

Lift a String to a UGen label (ie. for poll).

unpackLabel :: UGen -> [UGen]

Unpack a label to a length prefixed list of Constants. There is a special case for mce nodes, but it requires labels to be equal length. Properly, poll would not unpack the label, it would be done by the synthdef builder.

Envelope

envelope_to_ugen :: Envelope UGen -> UGen

mce of envelope_sc3_array.

envelope_to_ienvgen_ugen :: Envelope UGen -> UGen

mce of envelope_sc3_ienvgen_array.

Bitwise

bitAnd :: UGen -> UGen -> UGen

BitAnd

bitOr :: UGen -> UGen -> UGen

BitOr

bitXOr :: UGen -> UGen -> UGen

BitXor

bitNot :: UGen -> UGen

BitNot

shiftLeft :: UGen -> UGen -> UGen

ShiftLeft

shiftRight :: UGen -> UGen -> UGen

ShiftRight

unsignedShift :: UGen -> UGen -> UGen

UnsignedShift

(.<<.) :: UGen -> UGen -> UGen

shiftLeft operator.

(.>>.) :: UGen -> UGen -> UGen

shiftRight operator.