Csound.IO

Rendering of Csound files and playing the music in real time.

How are we going to get the sound out of Haskell code? Instruments are ready and we have written all the scores for them. Now, it's time to use the rendering functions. We can render haskell expressions to Csound code. A rendering function takes a value that represents a sound (it's a tuple of signals) and produces a string with Csound code. It can take a value that represents the flags for the csound compiler and global settings (Options). Then we can save this string to file and convert it to sound with csound compiler

 csound -o music.wav music.csd

Or we can play it in real time with -odac flag. It sends the sound directly to soundcard. It's usefull when we are using midi or tweek the parameters in real time with sliders or knobs.

 csound -odac music.csd

The main function of this module is renderCsdBy. Other function are nothing but wrappers that produce the Csound code and make something useful with it (saving to file, playing with specific player or in real time).

Rendering

class RenderCsd a where

Methods

renderCsdBy :: Options -> a -> IO String

Instances

RenderCsd Sig

RenderCsd (SE ())

RenderCsd (SE ((Sig, Sig, Sig, Sig, Sig, Sig, Sig, Sig), (Sig, Sig, Sig, Sig, Sig, Sig, Sig, Sig)))

RenderCsd (SE (Sig, Sig))

RenderCsd (SE ((Sig, Sig, Sig, Sig, Sig, Sig, Sig, Sig), (Sig, Sig, Sig, Sig, Sig, Sig, Sig, Sig), (Sig, Sig, Sig, Sig, Sig, Sig, Sig, Sig), (Sig, Sig, Sig, Sig, Sig, Sig, Sig, Sig)))

RenderCsd (SE (Sig, Sig, Sig, Sig))

RenderCsd (SE (Sig, Sig, Sig, Sig, Sig, Sig))

RenderCsd (SE (Sig, Sig, Sig, Sig, Sig, Sig, Sig, Sig))

RenderCsd (SE Sig)

(Sigs a, Sigs b) => RenderCsd (a -> SE b)

(Sigs a, Sigs b) => RenderCsd (a -> b)

RenderCsd ((Sig, Sig, Sig, Sig, Sig, Sig, Sig, Sig), (Sig, Sig, Sig, Sig, Sig, Sig, Sig, Sig))

RenderCsd (Sig, Sig)

RenderCsd ((Sig, Sig, Sig, Sig, Sig, Sig, Sig, Sig), (Sig, Sig, Sig, Sig, Sig, Sig, Sig, Sig), (Sig, Sig, Sig, Sig, Sig, Sig, Sig, Sig), (Sig, Sig, Sig, Sig, Sig, Sig, Sig, Sig))

RenderCsd (Sig, Sig, Sig, Sig)

RenderCsd (Sig, Sig, Sig, Sig, Sig, Sig)

RenderCsd (Sig, Sig, Sig, Sig, Sig, Sig, Sig, Sig)

renderCsd :: RenderCsd a => a -> IO String

Renders Csound file.

writeCsd :: RenderCsd a => String -> a -> IO ()

Render Csound file and save it to the give file.

writeCsdBy :: RenderCsd a => Options -> String -> a -> IO ()

Render Csound file with options and save it to the give file.

Playing the sound

playCsd :: RenderCsd a => (String -> IO ()) -> String -> a -> IO ()

Renders Csound file, saves it to the given file, renders with csound command and plays it with the given program.

 playCsd program file csd 

Produces files file.csd (with renderCsd) and file.wav (with csound) and then invokes:

 program "file.wav"

playCsdBy :: RenderCsd a => Options -> (String -> IO ()) -> String -> a -> IO ()

Works just like playCsd but you can supply csound options.

mplayer :: RenderCsd a => a -> IO ()

Renders to tmp.csd and tmp.wav and plays with mplayer.

mplayerBy :: RenderCsd a => Options -> a -> IO ()

Renders to tmp.csd and tmp.wav and plays with mplayer.

totem :: RenderCsd a => a -> IO ()

Renders to tmp.csd and tmp.wav and plays with totem player.

totemBy :: RenderCsd a => Options -> a -> IO ()

Renders to tmp.csd and tmp.wav and plays with totem player.

Live performance

dac :: RenderCsd a => a -> IO ()

Renders csound code to file tmp.csd and plays it with -odac option (sound output goes to soundcard in real time).

dacBy :: RenderCsd a => Options -> a -> IO ()

dac with options.

vdac :: RenderCsd a => a -> IO ()

Output to dac with virtual midi keyboard.

vdacBy :: RenderCsd a => Options -> a -> IO ()

Output to dac with virtual midi keyboard with specified options.

Render and run

csd :: RenderCsd a => a -> IO ()

Renders to file tmp.csd and invokes the csound on it.

csdBy :: RenderCsd a => Options -> a -> IO ()

Renders to file tmp.csd and invokes the csound on it.