Csound.Air.Misc

Patterns

Documentation

mean :: Fractional a => [a] -> a

Mean value.

vibrate :: Sig -> Sig -> (Sig -> a) -> Sig -> a

Adds vibrato to the sound unit. Sound units is a function that takes in a frequency.

randomPitch :: Sig -> Sig -> (Sig -> a) -> Sig -> SE a

Adds a random vibrato to the sound unit. Sound units is a function that takes in a frequency.

chorusPitch :: Int -> Sig -> (Sig -> Sig) -> Sig -> Sig

Chorus takes a number of copies, chorus width and wave shape.

resons :: [(Sig, Sig)] -> Sig -> Sig

Applies a resonator to the signals. A resonator is a list of band pass filters. A list contains the parameters for the filters:

[(centerFrequency, bandWidth)]

resonsBy :: (cps -> bw -> Sig -> Sig) -> [(cps, bw)] -> Sig -> Sig

A resonator with user defined band pass filter. Warning: a filter takes in a center frequency, band width and the signal. The signal comes last (this order is not standard in the Csound but it's more convinient to use with Haskell).

modes :: [(Sig, Sig)] -> Sig -> Sig -> Sig

Chain of mass-spring-damping filters.

modes params baseCps exciter 

• params - a list of pairs (resonantFrequencyRatio, filterQuality)
• baseCps - base frequency of the resonator
• exciter - an impulse that starts a resonator.

dryWet :: Sig -> (Sig -> Sig) -> Sig -> Sig

Mixes dry and wet signals.

dryWet ratio effect asig

• ratio - of dry signal to wet
• effect - means to wet the signal
• asig -- processed signal

once :: Tab -> Sig

Reads table once during the note length.

onceBy :: D -> Tab -> Sig

Reads table once during a given period of time.

several :: Tab -> Sig -> Sig

Reads table several times during the note length.

fromMono :: Sig -> (Sig, Sig)

Doubles the mono signal to get the stereo signal.

List functions

odds :: [a] -> [a]

Selects odd elements from the list.

evens :: [a] -> [a]

Selects even elements from the list.

Random functions

rndPan :: Sig -> SE Sig2

Random panning

rndPan2 :: Sig2 -> SE Sig2

Random panning

rndVol :: SigSpace a => (D, D) -> a -> SE a

Random volume

gaussVol (minVolume, maxVolume)

gaussVol :: SigSpace a => D -> a -> SE a

Random volume (with gauss distribution)

gaussVol radiusOfDistribution

Choose signals

selector :: (Num a, SigSpace a) => [a] -> Sig -> a

It picks a signal from the list by integer index. The original value is taken from the head of the list (the first element).

Saving to file

writeHifi :: D -> String -> SE Sig2 -> IO ()

Hi-fi output for stereo signals. Saves the stereo signal to file. The length of the file is defined in seconds.

writeHifi fileLength fileName asig

Arpeggios

arpeggi :: SigSpace a => [Sig] -> [Sig] -> (Sig -> a) -> Sig -> a

Creates running arpeggios.

arpeggiBy ampWeights pitches instrument cps

It plays an instrument with fast sequence of notes. We can specify the pitches and amplitude weights of the notes as well as frequency of repetition.

arpBy :: SigSpace a => ([Sig] -> Sig -> Sig) -> ([Sig] -> Sig -> Sig) -> [Sig] -> [Sig] -> (Sig -> a) -> Sig -> a

Creates running arpeggios.

arpeggiBy ampWave pitchwave ampWeights pitches instrument cps

It plays an instrument with fast sequence of notes. We can specify amplitude envelope wave, pitch envelope wave, the pitches and amplitude weights of the notes as well as frequency of repetition.

GUI

lpJoy :: Source (Sig -> Sig)

Low-pass filter pictured as joystick. Ox is for center frequency and Oy is for resonance.

Effects

delaySig :: D -> Sig -> Sig

Delay a signal by certain number of seconds There is a subtle difference between the function and the function delaySnd. The delaySig is for delaying a signal on a micro level (the delay time have to be small) It's implemented with delay buffer in the csound. But delaySnd is for delaying on macro level (the delay time can be big). It's implemented with scores and invocation of hidden instruments.

delaySig numOfSamples asig

Wave shaper

wshaper :: Tab -> Sig -> Sig -> Sig

Wave shaper. The signal should be bipolar. It ranges within the interval [-1, 1].

wshaper table amount asig

wave shaper transforms the input signal with the table. The amount of transformation scales the signal from 0 to 1. the amount is ratio of scaling. It expects the values from the interval [0, 1].

genSaturator :: Double -> Sig -> Sig -> Sig

Wave shaper with sigmoid.

genSaturator sigmoidRadius amount asig

• sigmoid radius is 5 to 100.
• amount is [0, 1]

saturator :: Sig -> Sig -> Sig

Alias for

genSaturator 10

mildSaturator :: Sig -> Sig -> Sig

Alias for

genSaturator 5

hardSaturator :: Sig -> Sig -> Sig

Alias for

genSaturator 50

hardSaturator2 :: Sig -> Sig -> Sig

Alias for

genSaturator 100

Function composition

funSeq :: [a -> a] -> a -> a

Chains all functions in the list.

funPar :: Num a => [a -> a] -> a -> a

Applies all functions in the list to the given input and summs them up.

Metronome

ticks :: Int -> Sig -> Sig

Metronome.

ticks n bpm

nticks :: [Int] -> Sig -> Sig

Metronome with a chain of accents. A typical 7/8 for example:

dac $ nticks [3, 2, 2] (135 * 2)

ticks2 :: Int -> Sig -> Sig

nticks2 :: [Int] -> Sig -> Sig

ticks3 :: Int -> Sig -> Sig

nticks3 :: [Int] -> Sig -> Sig

ticks4 :: Int -> Sig -> Sig

nticks4 :: [Int] -> Sig -> Sig

Drone

testDrone :: D -> SE Sig2

testDrone2 :: D -> SE Sig2

testDrone3 :: D -> SE Sig2

testDrone4 :: D -> SE Sig2