Csound.Air.Live

UIs for live performances

Mixer

mixer :: [(String, SE Sig2)] -> Source Sig2

Widget that represents a mixer.

hmixer :: [(String, SE Sig2)] -> Source Sig2

Widget that represents a mixer with horizontal grouping of elements.

mixMono :: String -> Sig -> (String, SE Sig2)

Transforms the mono signal to the stereo input for the mixer widget.

Effects

type FxFun = Sig2 -> SE Sig2

The stereo signal processing function.

class FxUI a where

Minimal complete definition

applyFxArgs, arityFx

Methods

applyFxArgs :: a -> [Sig] -> Sig2 -> SE Sig2

arityFx :: a -> Int

Instances

FxUI FxFun

Methods

applyFxArgs :: FxFun -> [Sig] -> Sig2 -> SE Sig2

arityFx :: FxFun -> Int

FxUI (Sig2 -> Sig2)

Methods

applyFxArgs :: (Sig2 -> Sig2) -> [Sig] -> Sig2 -> SE Sig2

arityFx :: (Sig2 -> Sig2) -> Int

FxUI a => FxUI (Sig -> a)

Methods

applyFxArgs :: (Sig -> a) -> [Sig] -> Sig2 -> SE Sig2

arityFx :: (Sig -> a) -> Int

fxBox :: FxUI a => String -> a -> Bool -> [(String, Double)] -> Source FxFun

Creates a widget that represents a stereo signal processing function. The parameters of the widget are updated with sliders. For example let's create a simple gain widget. It can be encoded like this:

uiGain :: Bool -> Double -> Source FxFun
uiGain isOn gain = fxBox "Gain" fx isOn [("gain", gain)]
   where 
       fx :: Sig -> Sig2 -> Sig2
       fx = mul

Let's look at the arguments of the function

fxBox name fx isOn args

• name -- is the name of the widget
• fx -- is signal processing function (see the class FxUI).
• isOn -- whether widget in the active state
• args -- list of initial values for arguments and names of the arguments.

It's cool to set the color of the widget with fxColor function. we can make our widgets much more intersting to look at.

uiBox :: String -> Source FxFun -> Bool -> Source FxFun

Creates an FX-box from the given visual representation. It insertes a big On/Off button atop of the GUI.

fxColor :: Color -> Source a -> Source a

Colors the source widgets.

fxVer :: [Source FxFun] -> Source FxFun

Groups the signal processing widgets. The functions are composed the visuals are grouped verticaly.

fxHor :: [Source FxFun] -> Source FxFun

Groups the signal processing widgets. The functions are composed the visuals are grouped horizontaly.

fxSca :: Double -> Source FxFun -> Source FxFun

Scales the gui for signal processing widgets.

fxApp :: FxFun -> Source FxFun -> Source FxFun

Applies a function to a signal processing function.

Instrument choosers

hinstrChooser :: Sigs b => [(String, a -> SE b)] -> Int -> Source (a -> SE b)

Chooses an instrument among several alternatives. It uses the hradio for GUI groupping.

vinstrChooser :: Sigs b => [(String, a -> SE b)] -> Int -> Source (a -> SE b)

Chooses an instrument among several alternatives. It uses the vradio for GUI groupping.

hmidiChooser :: Sigs a => [(String, Msg -> SE a)] -> Int -> Source a

Chooses a midi instrument among several alternatives. It uses the hradio for GUI groupping.

vmidiChooser :: Sigs a => [(String, Msg -> SE a)] -> Int -> Source a

Chooses a midi instrument among several alternatives. It uses the vradio for GUI groupping.

Fx units

uiDistort :: Bool -> Double -> Double -> Double -> Source FxFun

The distortion widget. The arguments are

uiDistort isOn levelOfDistortion drive tone

uiChorus :: Bool -> Double -> Double -> Double -> Double -> Source FxFun

The chorus widget. The arguments are

uiChorus isOn mix rate depth width 

uiFlanger :: Bool -> Double -> Double -> Double -> Double -> Double -> Source FxFun

The flanger widget. The arguments are

uiFlanger isOn mix feedback rate depth delay

uiPhaser :: Bool -> Double -> Double -> Double -> Double -> Double -> Source FxFun

The phaser widget. The arguments are

uiPhaser isOn mix feedback rate depth frequency

uiDelay :: Bool -> Double -> Double -> Double -> Double -> Source FxFun

The delay widget. The arguments are

uiDelay isOn mix feedback delayTime tone

uiEcho :: Bool -> D -> Double -> Double -> Source FxFun

The simplified delay widget. The arguments are

uiEcho isOn maxDelayTime delayTime feedback

uiFilter :: Bool -> Double -> Double -> Double -> Source FxFun

The pair of low and high pass filters

uiFilter isOn lowPassfrequency highPassFrequency gain

uiReverb :: Bool -> Double -> Double -> Source FxFun

The reverb widget. The arguments are:

uiReverb mix depth

uiGain :: Bool -> Double -> Source FxFun

The gain widget. The arguments are

uiGain isOn amountOfGain

uiWhite :: Bool -> Double -> Double -> Source FxFun

The filtered white noize widget. The arguments are

uiWhite isOn centerFreqOfFilter amountOfNoize 

uiPink :: Bool -> Double -> Double -> Source FxFun

The filtered pink noize widget. The arguments are

uiPink isOn centerFreqOfFilter amountOfNoize 

uiFx :: FxUI a => String -> a -> Bool -> Source FxFun

The constructor for signal processing functions with no arguments (controlls).

uiRoom :: Bool -> Source FxFun

The reverb for room.

uiHall :: Bool -> Source FxFun

The reverb for hall.

uiCave :: Bool -> Source FxFun

The reverb for magic cave.

uiSig :: String -> Bool -> Source Sig2 -> Source FxFun

the widget for mixing in a signal to the signal.

uiMix :: Bool -> [(String, SE Sig2)] -> Source FxFun

A mixer widget represented as an effect. The effect sums the signals with given wieghts.

uiMidi :: [(String, Msg -> SE Sig2)] -> Int -> Source FxFun

Midi chooser implemented as FX-box.

Static widgets

data AdsrBound

Constructors

AdsrBound

Fields

• attBound :: Double
• decBound :: Double
• relBound :: Double

data AdsrInit

Constructors

AdsrInit

Fields

• attInit :: Double
• decInit :: Double
• susInit :: Double
• relInit :: Double

linAdsr :: String -> AdsrBound -> AdsrInit -> Source Sig

expAdsr :: String -> AdsrBound -> AdsrInit -> Source Sig

classicWaves :: String -> Int -> Source (Sig -> Sig)

A widget with four standard waveforms: pure tone, triangle, square and sawtooth. The last parameter is a default waveform (it's set at init time).

masterVolume :: Source Sig

Slider for master volume

masterVolumeKnob :: Source Sig

Knob for master volume

Orphan instances

SigSpace FxFun

Methods

mapSig :: (Sig -> Sig) -> FxFun -> FxFun