Graph.hs

-- | Standard SC3 graphs, referenced in documentation.
module Sound.Sc3.Ugen.Help.Graph where

import Sound.Sc3.Common.Enum
import Sound.Sc3.Common.Envelope
import Sound.Sc3.Common.Rate

import Sound.Sc3.Ugen.Bindings
import Sound.Sc3.Ugen.Mce
import Sound.Sc3.Ugen.Ugen
import Sound.Sc3.Ugen.Util

-- | The SC3 /default/ instrument 'Ugen' graph.
default_ugen_graph :: Ugen
default_ugen_graph =
    let f = control kr "freq" 440
        a = control kr "amp" 0.1
        p = control kr "pan" 0
        g = control kr "gate" 1
        o = control kr "out" 0
        e = linen g 0.01 0.7 0.3 RemoveSynth
        f3 = mce [f,f + randId 'α' (-0.4) 0,f + randId 'β' 0 0.4]
        l = xLine kr (randId 'γ' 4000 5000) (randId 'δ' 2500 3200) 1 DoNothing
        z = lpf (mix (varSaw ar f3 0 0.3 * 0.3)) l * e
    in out o (pan2 z p a)

-- | A /Gabor/ grain, envelope is by 'lfGauss'.
gabor_grain_ugen_graph :: Ugen
gabor_grain_ugen_graph =
    let o = control ir "out" 0
        f = control ir "freq" 440
        d = control ir "sustain" 1
        l = control ir "pan" 0
        a = control ir "amp" 0.1
        w = control ir "width" 0.25
        e = lfGauss ar d w 0 NoLoop RemoveSynth
        s = fSinOsc ar f (0.5 * pi) * e
    in offsetOut o (pan2 s l a)

-- | A /sine/ grain, envelope is by 'envGen' of 'envSine'.
sine_grain_ugen_graph :: Ugen
sine_grain_ugen_graph =
    let o = control ir "out" 0
        f = control ir "freq" 440
        d = control ir "sustain" 1
        l = control ir "pan" 0
        a = control ir "amp" 0.1
        w = control ir "width" 0.25
        e = envGen ar 1 1 0 1 RemoveSynth (envSine (d * w) 1)
        s = fSinOsc ar f (0.5 * pi) * e
    in offsetOut o (pan2 s l a)

-- | Trivial file playback instrument.
--
-- If /use_gate/ is 'True' there is a /gate/ parameter and the synth
-- ends either when the sound file ends or the gate closes, else there
-- is a /sustain/ parameter to indicate the duration.  In both cases a
-- linear envelope with a decay time of /decay/ is applied.
--
-- The /rdelay/ parameter sets the maximum pre-delay time (in
-- seconds), each instance is randomly pre-delayed between zero and
-- the indicated time.  The /ramplitude/ parameter sets the maximum
-- amplitude offset of the /amp/ parameter, each instance is randomly
-- amplified between zero and the indicated value.
default_sampler_ugen_graph :: Bool -> Ugen
default_sampler_ugen_graph use_gate =
    let b = control kr "bufnum" 0
        l = control kr "pan" 0
        a = control kr "amp" 0.1
        r = control kr "rate" 1
        m = control kr "rdelay" 0
        v = control kr "ramplitude" 0
        w = control kr "attack" 0
        y = control kr "decay" 0.5
        r' = bufRateScale kr b * r
        p = playBuf 1 ar b r' 1 0 NoLoop RemoveSynth
        e = if use_gate
            then let g = control kr "gate" 1
                 in envGen kr g 1 0 1 RemoveSynth (envAsr w 1 y EnvSin)
            else let s = control kr "sustain" 1
                 in envGen kr 1 1 0 1 RemoveSynth (envLinen w s y 1)
        d = delayC (p * e) m (randId 'α' 0 m)
    in out 0 (pan2 d l (a + randId 'β' 0 v))