Sound.SC3.UGen.UGen

UGen data structure representation and associated functions.

Documentation

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 :: 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.

tr_control :: String -> Double -> UGen

Triggered (kr) control input node constructor.

mrg2 :: UGen -> UGen -> UGen

Multiple root graph node constructor.

Unit generator node predicates

Multiple channel expansion

mce2 :: UGen -> UGen -> UGen

Multiple channel expansion for two inputs.

mce2c :: UGen -> (UGen, UGen)

Extract two channels from possible MCE.

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.

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).

Multiple root graphs

Labels

label :: String -> UGen

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

equal_length_p :: [[a]] -> Bool

Are lists of equal length?

 equal_length_p ["t1","t2"] == True
 equal_length_p ["t","t1","t2"] == False

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.

Unit generator function builders

mk_osc :: [Rate] -> UGenId -> Rate -> String -> [UGen] -> Int -> UGen

Oscillator constructor with constrained set of operating Rates.

no_id :: UGenId

UGenId used for deterministic UGens.

mkOsc :: Rate -> String -> [UGen] -> Int -> UGen

Oscillator constructor with all_rates.

mkOscR :: [Rate] -> Rate -> String -> [UGen] -> Int -> UGen

Oscillator constructor, rate restricted variant.

toUId :: ID a => a -> UGenId

mkOscIdR :: ID a => [Rate] -> a -> Rate -> String -> [UGen] -> Int -> UGen

Rate restricted oscillator constructor, setting identifier.

mkOscId :: ID a => a -> Rate -> String -> [UGen] -> Int -> UGen

Oscillator constructor, setting identifier.

mk_osc_mce :: UGenId -> Rate -> String -> [UGen] -> UGen -> Int -> UGen

Provided UGenId variant of mkOscMCE.

mkOscMCE :: Rate -> String -> [UGen] -> UGen -> Int -> UGen

Variant oscillator constructor with MCE collapsing input.

mkOscMCEId :: ID a => a -> Rate -> String -> [UGen] -> UGen -> Int -> UGen

Variant oscillator constructor with MCE collapsing input.

mk_filter :: [Rate] -> UGenId -> String -> [UGen] -> Int -> UGen

Rate constrained filter UGen constructor.

mkFilter :: String -> [UGen] -> Int -> UGen

Filter UGen constructor.

mkFilterR :: [Rate] -> String -> [UGen] -> Int -> UGen

Filter UGen constructor.

mkFilterId :: ID a => a -> String -> [UGen] -> Int -> UGen

Filter UGen constructor.

mkFilterKeyed :: String -> Int -> [UGen] -> Int -> UGen

Variant filter with rate derived from keyed input.

mk_filter_mce :: [Rate] -> UGenId -> String -> [UGen] -> UGen -> Int -> UGen

Provided UGenId filter with mce input.

mkFilterMCER :: [Rate] -> String -> [UGen] -> UGen -> Int -> UGen

Variant filter constructor with MCE collapsing input.

mkFilterMCE :: String -> [UGen] -> UGen -> Int -> UGen

Variant filter constructor with MCE collapsing input.

mkFilterMCEId :: ID a => a -> String -> [UGen] -> UGen -> Int -> UGen

Variant filter constructor with MCE collapsing input.

mkInfo :: String -> UGen

Information unit generators are very specialized.

Bitwise

bitAnd :: UGen -> UGen -> UGen

bitOr :: UGen -> UGen -> UGen

bitXOr :: UGen -> UGen -> UGen

bitNot :: UGen -> UGen

shiftLeft :: UGen -> UGen -> UGen

shiftRight :: UGen -> UGen -> UGen

unsignedShift :: UGen -> UGen -> UGen

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

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