Csound.Sam

The sampler

Documentation

data Sample a

The generic type for samples.

Instances

Functor Sample

Applicative Sample

RenderCsd Sam

Fractional a => Fractional (Sample a)

Num a => Num (Sample a)

SigSpace a => SigSpace (Sample a)

type Sam = Sample Sig2

The main type. A stereo sample.

type Bpm = D

The Beats Per Minute measure (BPM). Almost all values are measured in BPMs.

runSam :: Bpm -> Sam -> SE Sig2

Lifters

mapBpm :: (Bpm -> Sig2 -> Sig2) -> Sam -> Sam

Transforms the sample with BPM.

bindSam :: (Sig2 -> SE Sig2) -> Sam -> Sam

Lifts bind on stereo signals to samples.

bindBpm :: (Bpm -> Sig2 -> SE Sig2) -> Sam -> Sam

Lifts bind on stereo signals to samples with BPM.

liftSam :: Sample (SE a) -> Sample a

Hides the effects inside sample.

Constructors

sig1 :: D -> Sig -> Sam

Constructs sample from limited mono signal (duration is in seconds)

sig2 :: D -> Sig2 -> Sam

Constructs sample from limited stereo signal (duration is in seconds)

infSig1 :: Sig -> Sam

Constructs sample from mono signal

infSig2 :: Sig2 -> Sam

Constructs sample from stereo signal

fromSig1 :: D -> Sig -> Sam

Constructs sample from limited mono signal (duration is in BPMs)

fromSig2 :: D -> Sig2 -> Sam

Constructs sample from limited stereo signal (duration is in BPMs)

rest :: D -> Sam

Constructs silence. The first argument is length in BPMs.

Stereo

wav :: String -> Sam

Constructs sample from wav or aiff files.

wavr :: String -> Sam

Constructs sample from wav that is played in reverse.

seg :: D -> D -> String -> Sam

Constructs sample from the segment of a wav file. The start and end times are measured in seconds.

 seg begin end fileName

segr :: D -> D -> String -> Sam

rndWav :: D -> String -> Sam

Picks segments from the wav file at random. The first argument is the length of the segment.

rndWavr :: D -> String -> Sam

Picks segments from the wav file at random. The first argument is the length of the segment.

rndSeg :: D -> D -> D -> String -> Sam

Constructs random segments of the given length from an interval.

rndSegr :: D -> D -> D -> String -> Sam

Constructs reversed random segments of the given length from an interval.

ramWav :: LoopMode -> Sig -> String -> Sam

Reads a sample from the file in RAM.

 ramWav loopMode speed fileName

Mono

wav1 :: String -> Sam

Constructs sample from mono wav or aiff files.

wavr1 :: String -> Sam

Constructs sample from mono wav that is played in reverse.

seg1 :: D -> D -> String -> Sam

Constructs sample from the segment of a mono wav file. The start and end times are measured in seconds.

 seg begin end fileName

segr1 :: D -> D -> String -> Sam

rndWav1 :: D -> String -> Sam

Picks segments from the mono wav file at random. The first argument is the length of the segment.

rndWavr1 :: D -> String -> Sam

Picks segments from the mono wav file at random. The first argument is the length of the segment.

rndSeg1 :: D -> D -> D -> String -> Sam

Constructs random segments of the given length from an interval.

rndSegr1 :: D -> D -> D -> String -> Sam

Constructs reversed random segments of the given length from an interval.

ramWav1 :: LoopMode -> Sig -> String -> Sam

Reads a sample from the mono file in RAM.

 ramWav1 loopMode speed fileName

Envelopes

linEnv :: D -> D -> Sam -> Sam

A linear rise-decay envelope. Times a given in BPMs.

 linEnv rise dec sample

expEnv :: D -> D -> Sam -> Sam

An exponential rise-decay envelope. Times a given in BPMs.

 expEnv rise dec sample

hatEnv :: Sam -> Sam

Parabolic envelope that starts and ends at zero and reaches maximum at the center.

decEnv :: Sam -> Sam

Fade out linear envelope.

riseEnv :: Sam -> Sam

Fade in linear envelope.

edecEnv :: Sam -> Sam

Fade out exponential envelope.

eriseEnv :: Sam -> Sam

Fade in exponential envelope.

Arrange

del :: D -> Sam -> Sam

Delays a sample by the given amount of BPMs.

str :: D -> Sam -> Sam

Stretches the BPM measure.

wide :: D -> Sam -> Sam

Makes the sampler broader. It's reciprocal of str

 wide k = str (1 / k)

flow :: [Sam] -> Sam

Plays a list of samples one after another.

pick :: Sig -> [Sam] -> Sam

Picks samples at random. The first argument is the period ofmetronome in BPMs. The tick of metronome produces new random sample from the list.

pickBy :: Sig -> [(D, Sam)] -> Sam

Picks samples at random. We can specify a frequency of the occurernce. The sum of all frequencies should be equal to 1.

lim :: D -> Sam -> Sam

Limits the length of the sample. The length is expressed in BPMs.

atPan :: Sig -> Sam -> Sam

Panning. 0 is all left and 1 is all right.

atPch :: Sig -> Sam -> Sam

Scales sample by pitch in tones.

atCps :: Sig -> Sam -> Sam

Scales sample by pitch in factor of frequency.

Loops

loop :: Sam -> Sam

Plays sample in the loop.

rep1 :: D -> Sam -> Sam

Plays the sample at the given period (in BPMs). The samples don't overlap.

rep :: [D] -> Sam -> Sam

Plays the sample at the given pattern of periods (in BPMs). The samples don't overlap.

pat1 :: D -> Sam -> Sam

Plays the sample at the given period (in BPMs). The overlapped samples are mixed together.

pat :: [D] -> Sam -> Sam

Plays the sample at the given pattern of periods (in BPMs). The overlapped samples are mixed together.

Arpeggio

type Chord = [D]

The tones of the chord.

arpUp :: Chord -> [D] -> Sam -> Sam

Plays ascending arpeggio of samples.

arpDown :: Chord -> [D] -> Sam -> Sam

Plays descending arpeggio of samples.

arpOneOf :: Chord -> [D] -> Sam -> Sam

Plays arpeggio of samles with random notes from the chord.

arpFreqOf :: [D] -> Chord -> [D] -> Sam -> Sam

Plays arpeggio of samles with random notes from the chord. We can assign the frequencies of the notes.

arpUp1 :: Chord -> Sig -> Sam -> Sam

Plays ascending arpeggio of samples.

arpDown1 :: Chord -> Sig -> Sam -> Sam

Plays descending arpeggio of samples.

arpOneOf1 :: Chord -> Sig -> Sam -> Sam

Plays arpeggio of samles with random notes from the chord.

arpFreqOf1 :: [D] -> Chord -> Sig -> Sam -> Sam

Plays arpeggio of samles with random notes from the chord. We can assign the frequencies of the notes.

Misc patterns

wall :: D -> Sam -> Sam

Constructs the wall of sound from the initial segment of the sample. The segment length is given in BPMs.

 wall segLength

forAirports :: [(D, D, D)] -> Sam -> Sam

The pattern is influenced by the Brian Eno's work Music fo Airports. The argument is list of tripples:

 (delayTime, repeatPeriod, pitch)

It takes a Sample and plays it in the loop with given initial delay time. The third cell in the tuple pitch is a value for scaling of the pitch in tones.

genForAirports :: [(D, D, Sam)] -> Sam

The pattern is influenced by the Brian Eno's work Music fo Airports. It's more generic than pattern forAirport The argument is list of tripples:

 (delayTime, repeatPeriod, Sample)

It takes a list of Samples and plays them in the loop with given initial delay time and repeat period.