Csound.Sam

The sampler

Documentation

data Sample a

The generic type for samples.

Instances

Functor Sample

Methods

fmap :: (a -> b) -> Sample a -> Sample b

(<$) :: a -> Sample b -> Sample a

Applicative Sample

Methods

pure :: a -> Sample a

(<*>) :: Sample (a -> b) -> Sample a -> Sample b

(*>) :: Sample a -> Sample b -> Sample b

(<*) :: Sample a -> Sample b -> Sample a

RenderCsd Sam

Methods

renderCsdBy :: Options -> Sam -> IO String

Fractional a => Fractional (Sample a)

Methods

(/) :: Sample a -> Sample a -> Sample a

recip :: Sample a -> Sample a

fromRational :: Rational -> Sample a

Num a => Num (Sample a)

Methods

(+) :: Sample a -> Sample a -> Sample a

(-) :: Sample a -> Sample a -> Sample a

(*) :: Sample a -> Sample a -> Sample a

negate :: Sample a -> Sample a

abs :: Sample a -> Sample a

signum :: Sample a -> Sample a

fromInteger :: Integer -> Sample a

RenderCsd (Source Sam)

Methods

renderCsdBy :: Options -> Source Sam -> IO String

SigSpace a => SigSpace (Sample a)

Methods

mapSig :: (Sig -> Sig) -> Sample a -> Sample a

type DurOf Sam

type DurOf Sam = D

type AtOut Sig Sig2 Sam

type AtOut Sig Sig2 Sam = Sam

type AtOut Sig2 Sig2 Sam

type AtOut Sig2 Sig2 Sam = Sam

type AtOut Sig (SE Sig) Sam

type AtOut Sig (SE Sig) Sam = Sam

type AtOut Sig (SE Sig2) Sam

type AtOut Sig (SE Sig2) Sam = Sam

type AtOut Sig2 (SE Sig2) Sam

type AtOut Sig2 (SE Sig2) Sam = Sam

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 -> a -> b) -> Sample a -> Sample b

Transforms the sample with BPM.

bindSam :: (a -> SE b) -> Sample a -> Sample b

Lifts bind on stereo signals to samples.

bindBpm :: (Bpm -> a -> SE b) -> Sample a -> Sample b

Lifts bind on stereo signals to samples with BPM.

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

Hides the effects inside sample.

mapBpm2 :: (Bpm -> a -> b -> c) -> Sample a -> Sample b -> Sample c

Transforms the sample with BPM.

bindBpm2 :: (Bpm -> a -> b -> SE c) -> Sample a -> Sample b -> Sample c

Lifts bind on stereo signals to samples with BPM.

withBpm :: (Bpm -> Sample a) -> Sample a

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)

class ToSam a where

Minimal complete definition

toSam

Methods

toSam :: a -> Sam

Instances

ToSam Sig

Methods

toSam :: Sig -> Sam

ToSam Sig2

Methods

toSam :: Sig2 -> Sam

ToSam (SE Sig)

Methods

toSam :: SE Sig -> Sam

ToSam (SE Sig2)

Methods

toSam :: SE Sig2 -> Sam

limSam :: ToSam a => D -> a -> Sam

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

Reading from RAM

Stereo

ramLoop :: Fidelity -> TempoSig -> PitchSig -> String -> Sam

It's the same as loopRam but wrapped in Sam (see Csound.Air.Wav).

ramRead :: Fidelity -> TempoSig -> PitchSig -> String -> Sam

It's the same as readRam but wrapped in Sam (see Csound.Air.Wav).

segLoop :: Fidelity -> (Sig, Sig) -> TempoSig -> PitchSig -> String -> Sam

It's the same as loopSeg but wrapped in Sam (see Csound.Air.Wav).

segRead :: Fidelity -> (Sig, Sig) -> TempoSig -> PitchSig -> String -> Sam

It's the same as readSeg but wrapped in Sam (see Csound.Air.Wav).

relLoop :: Fidelity -> (Sig, Sig) -> TempoSig -> PitchSig -> String -> Sam

It's the same as loopRel but wrapped in Sam (see Csound.Air.Wav).

relRead :: Fidelity -> (Sig, Sig) -> TempoSig -> PitchSig -> String -> Sam

It's the same as readRel but wrapped in Sam (see Csound.Air.Wav).

Mono

ramLoop1 :: Fidelity -> TempoSig -> PitchSig -> String -> Sam

It's the same as loopRam1 but wrapped in Sam (see Csound.Air.Wav).

ramRead1 :: Fidelity -> TempoSig -> PitchSig -> String -> Sam

It's the same as readRam1 but wrapped in Sam (see Csound.Air.Wav).

segLoop1 :: Fidelity -> (Sig, Sig) -> TempoSig -> PitchSig -> String -> Sam

It's the same as loopSeg1 but wrapped in Sam (see Csound.Air.Wav).

segRead1 :: Fidelity -> (Sig, Sig) -> TempoSig -> PitchSig -> String -> Sam

It's the same as readSeg1 but wrapped in Sam (see Csound.Air.Wav).

relLoop1 :: Fidelity -> (Sig, Sig) -> TempoSig -> PitchSig -> String -> Sam

It's the same as loopRel1 but wrapped in Sam (see Csound.Air.Wav).

relRead1 :: Fidelity -> (Sig, Sig) -> TempoSig -> PitchSig -> String -> Sam

It's the same as readRel1 but wrapped in Sam (see Csound.Air.Wav).

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

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.

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.

atPanRnd :: Sam -> Sam

Applies random panning to every sample playback.

atVolRnd :: (D, D) -> Sam -> Sam

Applies random amplitude scaling to every sample playback.

atVolGauss :: D -> Sam -> Sam

Applies random amplitude scaling with gauss distribution with given radius (centered at 1).

Loops

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.

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

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

pat' volumes periods

rndPat :: Sig -> [D] -> Sam -> Sam

Plays the sample at the given pattern of periods (in BPMs) and sometimes skips the samples from playback. The overlapped samples are mixed together. The first argument is the probability of inclusion.

rndPat' :: Sig -> [D] -> [D] -> Sam -> Sam

Plays the sample at the given pattern of volumes and periods (in BPMs) and sometimes skips the samples from playback. The overlapped samples are mixed together. The first argument is the probability of inclusion.

rndPat' probability volumes periods

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.

arpy :: (D -> SE Sig2) -> D -> D -> Int -> [[D]] -> Sam

The arpeggiator for the sequence of chords.

arpy instrument chordPeriod speedOfTheNote accentNumber chords 

The first argument is an instrument that takes in a frequency of the note in Hz. The second argument is the period of chord change (in beats). The next argument is the speed of the single note (in beats). The integer argument is number of notes in the group. Every n'th note is louder. The last argument is the sequence of chords. The chord is the list of frequencies.

Utils

metroS :: Bpm -> Sig -> Evt Unit

toSec :: Bpm -> D -> D

UIs

module Csound.Sam.Ui

Triggering samples

module Csound.Sam.Trig

Orphan instances

Loop Sam

Methods

loop :: Sam -> Sam

Limit Sam

Methods

lim :: DurOf Sam -> Sam -> Sam

Rest Sam

Methods

rest :: DurOf Sam -> Sam

Stretch Sam

Methods

str :: DurOf Sam -> Sam -> Sam

Delay Sam

Methods

del :: DurOf Sam -> Sam -> Sam

Compose Sam

Harmony Sam

Methods

har :: [Sam] -> Sam

(=:=) :: Sam -> Sam -> Sam

Melody Sam

Methods

mel :: [Sam] -> Sam

(+:+) :: Sam -> Sam -> Sam

At Sig Sig2 Sam

Associated Types

type AtOut Sig Sig2 Sam :: *

Methods

at :: (Sig -> Sig2) -> Sam -> AtOut Sig Sig2 Sam

At Sig2 Sig2 Sam

Associated Types

type AtOut Sig2 Sig2 Sam :: *

Methods

at :: (Sig2 -> Sig2) -> Sam -> AtOut Sig2 Sig2 Sam

MixAt Sig Sig2 Sam

Methods

mixAt :: Sig -> (Sig -> Sig2) -> Sam -> AtOut Sig Sig2 Sam

MixAt Sig2 Sig2 Sam

Methods

mixAt :: Sig -> (Sig2 -> Sig2) -> Sam -> AtOut Sig2 Sig2 Sam

At Sig (SE Sig) Sam

Associated Types

type AtOut Sig (SE Sig) Sam :: *

Methods

at :: (Sig -> SE Sig) -> Sam -> AtOut Sig (SE Sig) Sam

At Sig (SE Sig2) Sam

Associated Types

type AtOut Sig (SE Sig2) Sam :: *

Methods

at :: (Sig -> SE Sig2) -> Sam -> AtOut Sig (SE Sig2) Sam

At Sig2 (SE Sig2) Sam

Associated Types

type AtOut Sig2 (SE Sig2) Sam :: *

Methods

at :: (Sig2 -> SE Sig2) -> Sam -> AtOut Sig2 (SE Sig2) Sam

MixAt Sig (SE Sig) Sam

Methods

mixAt :: Sig -> (Sig -> SE Sig) -> Sam -> AtOut Sig (SE Sig) Sam

MixAt Sig (SE Sig2) Sam

Methods

mixAt :: Sig -> (Sig -> SE Sig2) -> Sam -> AtOut Sig (SE Sig2) Sam

MixAt Sig2 (SE Sig2) Sam

Methods

mixAt :: Sig -> (Sig2 -> SE Sig2) -> Sam -> AtOut Sig2 (SE Sig2) Sam