Sound.SC3.Lang.Control.OverlapTexture

SC2 OverlapTexture related functions.

Generate sequences of overlapping instances of a UGen graph or family of graphs. The OverlapTexture functions add an Envelope and calculate inter-onset times and durations. There are variants for different graph constructors, and to allow for a post-processing stage.

Documentation

mk_env :: UGen -> UGen -> UGen

Make an envGen UGen with envLinen' structure with given sustain and transition times.

with_env_u :: UGen -> UGen -> UGen -> UGen

Apply mk_env envelope to input signal and write to output bus 0.

with_env :: (Double, Double) -> UGen -> UGen

Variant of with_env_u where envelope parameters are lifted from Double to UGen.

type OverlapTexture = (Double, Double, Double, Int)

Control parameters for overlapTextureU and related functions. Components are: 1. sustain time, 2. transition time, 3. number of overlaping (simultaneous) nodes and 4. number of nodes altogether.

data OverlapTexture_

Constructors

OverlapTexture

Fields

sustain_time :: Double

transition_time :: Double

overlaps :: Double

max_repeats :: Int

overlapTexture_env :: OverlapTexture -> (Double, Double)

Extract envelope parameters (sustain and transition times) for with_env from OverlapTexture.

type Texture_DT = (Double, Double)

(legato,duration) parameters. The duration is the inter-offset time, legato is the scalar giving the sounding time in relation to the inter-offset time.

overlapTexture_dt :: OverlapTexture -> Texture_DT

Extract legato (duration of sound proportional to inter-offset time) and duration (inter-offset time) parameters from OverlapTexture.

 overlapTexture_dt (3,1,5,maxBound) == (5,1)

type XFadeTexture = (Double, Double, Int)

Control parameters for xfadeTextureU and related functions. Components are: 1. sustain time, 2. transition time, 3. number of nodes instatiated altogether.

xfadeTexture_env :: XFadeTexture -> (Double, Double)

Extract envelope parameters for with_env from XFadeTexture.

xfadeTexture_dt :: XFadeTexture -> Texture_DT

Extract legato and duration paramaters from XFadeTexture.

gen_synth :: (Double, Double) -> UGen -> Synthdef

Generate Synthdef from envelope parameters for with_env and a continuous signal.

overlapTextureP :: OverlapTexture -> UGen -> P Event

Generate an Event pattern from OverlapTexture control parameters and a continuous signal.

overlapTextureU :: OverlapTexture -> UGen -> IO ()

Audition pattern given by overlapTextureP.

 import Sound.SC3.ID
 import Sound.SC3.Lang.Control.OverlapTexture

 let {o = sinOsc AR (rand 'α' 440 880) 0
     ;u = pan2 o (rand 'β' (-1) 1) (rand 'γ' 0.1 0.2)}
 in overlapTextureU (3,1,6,9) u

post_process_s :: Int -> (UGen -> UGen) -> Synthdef

Generate Synthdef from a signal processing function over the indicated number of channels.

post_process_a :: Transport m => P Event -> Int -> (UGen -> UGen) -> m ()

Audition Event pattern with specified post-processing function.

type PPF = UGen -> UGen

Post processing function.

overlapTextureU_pp :: OverlapTexture -> UGen -> Int -> PPF -> IO ()

Variant of overlapTextureU with post-processing stage.

xfadeTextureP :: XFadeTexture -> UGen -> P Event

Generate an Event pattern from XFadeTexture control parameters and a continuous signal.

xfadeTextureU :: XFadeTexture -> UGen -> IO ()

Audition pattern given by xfadeTextureP.

 let {o = sinOsc AR (rand 'α' 440 880) 0
     ;u = pan2 o (rand 'β' (-1) 1) (rand 'γ' 0.1 0.2)}
 in xfadeTextureU (1,3,6) u

xfadeTextureU_pp :: XFadeTexture -> UGen -> Int -> PPF -> IO ()

Variant of xfadeTextureU with post-processing stage.

type USTF st = st -> (UGen, st)

UGen generating state transform function.

overlapTextureP_st :: OverlapTexture -> USTF st -> st -> P Event

Variant of overlapTextureP where the continuous signal for each Event is derived from a state transform function seeded with given initial state.

overlapTextureS :: OverlapTexture -> USTF st -> st -> IO ()

Audition pattern given by overlapTextureP_st.

overlapTextureS_pp :: OverlapTexture -> USTF st -> st -> Int -> PPF -> IO ()

Variant of overlapTextureS with post-processing stage.

type MSTF st m = st -> m (Maybe st)

Monadic state transform function.

dt_rescheduler_m :: MonadIO m => MSTF (st, Time) m -> (st, Time) -> m ()

Run a monadic state transforming function f that operates with a delta Time indicating the duration to pause before re-running the function.

overlapTextureR :: Transport m => OverlapTexture -> IO UGen -> MSTF (Int, Time) m

Underlying function of overlapTextureM with explicit Transport.

overlapTextureM :: OverlapTexture -> IO UGen -> IO ()

Variant of overlapTextureU where the continuous signal is in the IO monad.