Csound.Air.Live

UIs for live performances

Mixer

mixer :: Sigs a => [(String, SE a)] -> Source a

Widget that represents a mixer.

hmixer :: Sigs a => [(String, SE a)] -> Source a

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

fxBox :: forall a. Sigs a => String -> ([Sig] -> Fx a) -> Bool -> [(String, Double)] -> Source (Fx a)

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 :: 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. fxBox :: forall a. (FxUI a, Num (FxArg a), Tuple (FxArg a)) => String -> a -> Bool -> [(String, Double)] -> Source (Fx (FxArg a))

uiBox :: Sigs a => String -> Source (Fx a) -> Bool -> Source (Fx a)

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

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

Colors the source widgets.

fxVer :: [Source (Fx a)] -> Source (Fx a)

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

fxHor :: [Source (Fx a)] -> Source (Fx a)

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

fxGrid :: Int -> [Source (Fx a)] -> Source (Fx a)

Creates a matrix of fx-boxes.

fxGrid columnsSize fxs

first argument is a number of columns in each row.

fxSca :: Double -> Source (Fx a) -> Source (Fx a)

Scales the gui for signal processing widgets.

fxMap :: Fx a -> Source (Fx a) -> Source (Fx a)

Applies a function to a signal processing function.

fxApply :: Source (a -> SE b) -> a -> Source b

Applies FX with UI to the input argument.

atFx :: Source (Fx a) -> Patch a -> Source (Patch a)

Applies FX to the Patch.

fxHorMS :: [Source Fx1] -> Maybe (Source (Sig -> SE Sig2)) -> [Source Fx2] -> Source (Sig -> SE Sig2)

fxHor for chain that starts with mono effects and proceeds with stereo effects. The second argument can contain The transition widget (mono to stereo effect) or it can be empty. If it's empty automatic conversion will be inserted.

fxVerMS :: [Source Fx1] -> Maybe (Source (Sig -> SE Sig2)) -> [Source Fx2] -> Source (Sig -> SE Sig2)

fxVer for chain that starts with mono effects and proceeds with stereo effects. The second argument can contain The transition widget (mono to stereo effect) or it can be empty. If it's empty automatic conversion will be inserted.

fxGridMS :: Int -> [Source Fx1] -> Maybe (Source (Sig -> SE Sig2)) -> [Source Fx2] -> Source (Sig -> SE Sig2)

Creates a matrix of fx-boxes. Stacks a list of mono and stereo FXs.

fxGrid columnsSize monoFxs maybeBridge stereoFxs

first argument is a number of columns in each row.

fromMonoFx :: Sigs a => (Sig -> Sig) -> Fx a

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 :: Sigs a => Bool -> Double -> Double -> Double -> Source (Fx a)

The distortion widget. The arguments are

uiDistort isOn levelOfDistortion drive tone

uiChorus :: Bool -> Double -> Double -> Double -> Double -> Source Fx2

The chorus widget. The arguments are

uiChorus isOn mix rate depth width

uiFlanger :: Sigs a => Bool -> Double -> Double -> Double -> Double -> Source (Fx a)

The flanger widget. The arguments are

uiFlanger isOn  rate depth delay feedback

uiPhaser :: Sigs a => Bool -> Double -> Double -> Double -> Double -> Source (Fx a)

The phaser widget. The arguments are

uiPhaser isOn mix feedback rate depth frequency

uiDelay :: Sigs a => Bool -> Double -> Double -> Double -> Double -> Source (Fx a)

The delay widget. The arguments are

uiDelay isOn mix feedback delayTime tone

uiEcho :: Sigs a => Bool -> D -> Double -> Double -> Source (Fx a)

The simplified delay widget. The arguments are

uiEcho isOn maxDelayTime delayTime feedback

uiFilter :: Sigs a => Bool -> Double -> Double -> Double -> Source (Fx a)

The pair of low and high pass filters

uiFilter isOn lowPassfrequency highPassFrequency gain

uiReverb :: Bool -> Double -> Double -> Source Fx2

The reverb widget. The arguments are:

uiReverb mix depth

uiGain :: Sigs a => Double -> Source (Fx a)

The gain widget, it's set to on by default. The arguments are

uiGain amountOfGain

uiCompress :: Sigs a => Double -> Double -> Double -> Double -> Double -> Double -> Double -> Source (Fx a)

Compressor

uiCompress thresh loknee hiknee ratio att rel gain

uiWhite :: Sigs a => Bool -> Double -> Double -> Source (Fx a)

The filtered white noize widget. The arguments are

uiWhite isOn centerFreqOfFilter amountOfNoize

uiPink :: Sigs a => Bool -> Double -> Double -> Source (Fx a)

The filtered pink noize widget. The arguments are

uiPink isOn centerFreqOfFilter amountOfNoize

uiFx :: Sigs a => String -> Fx a -> Bool -> Source (Fx a)

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

uiDry :: Sigs a => Source (Fx a)

uiSig :: Sigs a => String -> Bool -> Source a -> Source (Fx a)

the widget for mixing in a signal to the signal.

uiMix :: Sigs a => Bool -> [(String, SE a)] -> Source (Fx a)

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

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

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

Live row

data LiveClip

Clip and it's parameters

Constructors

LiveClip

Fields

• liveClipFile :: FilePath

  path to the file of audio clip

• liveClipParam :: ClipParam

  clip launch parameters

data ClipParam

Constructors

ClipParam

Fields

• clipParamSize :: !Int

  Clip size in bars

• clipParamDel :: !Int

  Clip offset from beginning in bars

• clipParamTail :: !Int

  Clip skip time at the end of the clip

• clipParamNext :: !Int

  Next clip to play after this one is finished. If it's -1 then play the same clip

• clipParamRetrig :: !Bool

  Should we retrigger clip from the start or continue play where we left out.

• clipParamVol :: !Double

  Volume scaling factor for the clip

Instances

Default ClipParam

Defined in Csound.Air.Live

Methods

def :: ClipParam

liveRow :: [LiveClip] -> D -> D -> Sig -> Sig

Live row triggers audio clips in sync.

liveRow clips bpm barSize clipIndex

• clips - contains file path to audio clips
• bpm - the BPM of the track
• barLength - length of the bar in quater notes. So 4 means 4/4
• clipIndex - identity of the clip to launch on the next bar.

liveRows :: [LiveClip] -> D -> D -> Sig -> Sig2

Stereo version of liveRow

ambiRow :: [String] -> Sig -> Sig -> D -> SE Sig2

ambiRowMp3 :: [String] -> Sig -> Sig -> D -> SE Sig2