Sound.Tidal.Params

Documentation

make' :: (a -> Value) -> Param -> Pattern a -> ParamPattern

grp :: [Param] -> Pattern String -> ParamPattern

group multiple params into one

sound :: Pattern String -> ParamPattern

a pattern of strings representing sound sample names (required).

sound is a combination of the s and n parameters to allow specifying both sample name and sample variation in one:

d1 $ sound "bd:2 sn:0"

is essentially the same as:

d1 $ s "bd sn" # n "2 0"

pF :: String -> Maybe Double -> (Pattern Double -> ParamPattern, Param)

pI :: String -> Maybe Int -> (Pattern Int -> ParamPattern, Param)

pS :: String -> Maybe String -> (Pattern String -> ParamPattern, Param)

accelerate :: Pattern Double -> ParamPattern

a pattern of numbers that speed up (or slow down) samples while they play.

attack :: Pattern Double -> ParamPattern

a pattern of numbers to specify the attack time (in seconds) of an envelope applied to each sample. Only takes effect if release is also specified.

bandf :: Pattern Double -> ParamPattern

a pattern of numbers from 0 to 1. Sets the center frequency of the band-pass filter.

bandq :: Pattern Double -> ParamPattern

a pattern of numbers from 0 to 1. Sets the q-factor of the band-pass filter.

begin :: Pattern Double -> ParamPattern

a pattern of numbers from 0 to 1. Skips the beginning of each sample, e.g. `0.25` to cut off the first quarter from each sample.

Using `begin "-1"` combined with `cut "-1"` means that when the sample cuts itself it will begin playback from where the previous one left off, so it will sound like one seamless sample. This allows you to apply a synth param across a long sample in a way similar to chop:

cps 0.5

d1 $ sound "breaks125*8"  begin "-1"  coarse "1 2 4 8 16 32 64 128"

This will play the breaks125 sample and apply the changing coarse parameter over the sample. Compare to:

d1 $ (chop 8 $ sounds "breaks125")  coarse "1 2 4 8 16 32 64 128"

which performs a similar effect, but due to differences in implementation sounds different.

channel :: Pattern Int -> ParamPattern

choose the physical channel the pattern is sent to, this is super dirt specific

clhatdecay :: Pattern Double -> ParamPattern

coarse :: Pattern Int -> ParamPattern

fake-resampling, a pattern of numbers for lowering the sample rate, i.e. 1 for original 2 for half, 3 for a third and so on.

crush :: Pattern Double -> ParamPattern

bit crushing, a pattern of numbers from 1 (for drastic reduction in bit-depth) to 16 (for barely no reduction).

cut :: Pattern Int -> ParamPattern

In the style of classic drum-machines, cut will stop a playing sample as soon as another samples with in same cutgroup is to be played.

An example would be an open hi-hat followed by a closed one, essentially muting the open.

d1 $ stack [
  sound "bd",
  sound "~ [~ [ho:2 hc/2]]" # cut "1"
  ]

This will mute the open hi-hat every second cycle when the closed one is played.

Using cut with negative values will only cut the same sample. This is useful to cut very long samples

d1 $ sound "bev, [ho:3]" # cut "-1"

Using `cut "0"` is effectively _no_ cutgroup.

cutoff :: Pattern Double -> ParamPattern

a pattern of numbers from 0 to 1. Applies the cutoff frequency of the low-pass filter.

cutoffegint :: Pattern Double -> ParamPattern

decay :: Pattern Double -> ParamPattern

delay :: Pattern Double -> ParamPattern

a pattern of numbers from 0 to 1. Sets the level of the delay signal.

delayfeedback :: Pattern Double -> ParamPattern

a pattern of numbers from 0 to 1. Sets the amount of delay feedback.

delaytime :: Pattern Double -> ParamPattern

a pattern of numbers from 0 to 1. Sets the length of the delay.

detune :: Pattern Double -> ParamPattern

dry :: Pattern Double -> ParamPattern

when set to `1` will disable all reverb for this pattern. See room and size for more information about reverb.

end :: Pattern Double -> ParamPattern

gain :: Pattern Double -> ParamPattern

a pattern of numbers that specify volume. Values less than 1 make the sound quieter. Values greater than 1 make the sound louder.

gate :: Pattern Double -> ParamPattern

hatgrain :: Pattern Double -> ParamPattern

hcutoff :: Pattern Double -> ParamPattern

a pattern of numbers from 0 to 1. Applies the cutoff frequency of the high-pass filter.

hold :: Pattern Double -> ParamPattern

a pattern of numbers to specify the hold time (in seconds) of an envelope applied to each sample. Only takes effect if attack and release are also specified.

hresonance :: Pattern Double -> ParamPattern

a pattern of numbers from 0 to 1. Applies the resonance of the high-pass filter.

kriole :: Pattern Int -> ParamPattern

lagogo :: Pattern Double -> ParamPattern

lclap :: Pattern Double -> ParamPattern

lclaves :: Pattern Double -> ParamPattern

lclhat :: Pattern Double -> ParamPattern

lcrash :: Pattern Double -> ParamPattern

lfo :: Pattern Double -> ParamPattern

lfocutoffint :: Pattern Double -> ParamPattern

lfodelay :: Pattern Double -> ParamPattern

lfoint :: Pattern Double -> ParamPattern

lfopitchint :: Pattern Double -> ParamPattern

lfoshape :: Pattern Double -> ParamPattern

lfosync :: Pattern Double -> ParamPattern

lhitom :: Pattern Double -> ParamPattern

lkick :: Pattern Double -> ParamPattern

llotom :: Pattern Double -> ParamPattern

lock :: Pattern Double -> ParamPattern

A pattern of numbers. Specifies whether delaytime is calculated relative to cps. When set to 1, delaytime is a direct multiple of a cycle.

loop :: Pattern Int -> ParamPattern

loops the sample (from begin to end) the specified number of times.

lophat :: Pattern Double -> ParamPattern

lsnare :: Pattern Double -> ParamPattern

n :: Pattern Int -> ParamPattern

specifies the sample variation to be used

nudge :: Pattern Double -> ParamPattern

Pushes things forward (or backwards within built-in latency) in time. Allows for nice things like _swing_ feeling:

d1 $ stack [
  sound "bd bd/4",
  sound "hh(5,8)"
  ] # nudge "[0 0.04]*4"

Low values will give a more _human_ feeling, high values might result in quite the contrary.

octave :: Pattern Int -> ParamPattern

offset :: Pattern Double -> ParamPattern

ophatdecay :: Pattern Double -> ParamPattern

orbit :: Pattern Int -> ParamPattern

a pattern of numbers. An orbit is a global parameter context for patterns. Patterns with the same orbit will share hardware output bus offset and global effects, e.g. reverb and delay. The maximum number of orbits is specified in the superdirt startup, numbers higher than maximum will wrap around.

pan :: Pattern Double -> ParamPattern

a pattern of numbers between 0 and 1, from left to right (assuming stereo).

pitch1 :: Pattern Double -> ParamPattern

pitch2 :: Pattern Double -> ParamPattern

pitch3 :: Pattern Double -> ParamPattern

portamento :: Pattern Double -> ParamPattern

release :: Pattern Double -> ParamPattern

a pattern of numbers to specify the release time (in seconds) of an envelope applied to each sample. Only takes effect if attack is also specified.

resonance :: Pattern Double -> ParamPattern

a pattern of numbers from 0 to 1. Specifies the resonance of the low-pass filter.

room :: Pattern Double -> ParamPattern

a pattern of numbers from 0 to 1. Sets the level of reverb.

sagogo :: Pattern Double -> ParamPattern

sclap :: Pattern Double -> ParamPattern

sclaves :: Pattern Double -> ParamPattern

scrash :: Pattern Double -> ParamPattern

semitone :: Pattern Double -> ParamPattern

shape :: Pattern Double -> ParamPattern

wave shaping distortion, a pattern of numbers from 0 for no distortion up to 1 for loads of distortion.

size :: Pattern Double -> ParamPattern

a pattern of numbers from 0 to 1. Sets the perceptual size (reverb time) of the room to be used in reverb.

slide :: Pattern Double -> ParamPattern

speed :: Pattern Double -> ParamPattern

a pattern of numbers from 0 to 1, which changes the speed of sample playback, i.e. a cheap way of changing pitch

s :: Pattern String -> ParamPattern

a pattern of strings. Selects the sample to be played.

stutterdepth :: Pattern Double -> ParamPattern

stuttertime :: Pattern Double -> ParamPattern

sustain :: Pattern Double -> ParamPattern

tomdecay :: Pattern Double -> ParamPattern

unit :: Pattern String -> ParamPattern

only accepts a value of "c". Used in conjunction with speed, it time-stretches a sample to fit in a cycle.

velocity :: Pattern Double -> ParamPattern

vcfegint :: Pattern Double -> ParamPattern

vcoegint :: Pattern Double -> ParamPattern

voice :: Pattern Double -> ParamPattern

vowel :: Pattern String -> ParamPattern

formant filter to make things sound like vowels, a pattern of either a, e, i, o or u. Use a rest (`~`) for no effect.

dur :: Pattern Double -> ParamPattern

modwheel :: Pattern Double -> ParamPattern

expression :: Pattern Double -> ParamPattern

sustainpedal :: Pattern Double -> ParamPattern

att :: Pattern Double -> ParamPattern

chdecay :: Pattern Double -> ParamPattern

ctf :: Pattern Double -> ParamPattern

ctfg :: Pattern Double -> ParamPattern

delayfb :: Pattern Double -> ParamPattern

delayt :: Pattern Double -> ParamPattern

det :: Pattern Double -> ParamPattern

gat :: Param

hg :: Pattern Double -> ParamPattern

lag :: Pattern Double -> ParamPattern

lbd :: Pattern Double -> ParamPattern

lch :: Pattern Double -> ParamPattern

lcl :: Pattern Double -> ParamPattern

lcp :: Pattern Double -> ParamPattern

lcr :: Pattern Double -> ParamPattern

lfoc :: Pattern Double -> ParamPattern

lfoi :: Pattern Double -> ParamPattern

lfop :: Pattern Double -> ParamPattern

lht :: Pattern Double -> ParamPattern

llt :: Pattern Double -> ParamPattern

loh :: Pattern Double -> ParamPattern

lsn :: Pattern Double -> ParamPattern

ohdecay :: Pattern Double -> ParamPattern

pit1 :: Pattern Double -> ParamPattern

pit2 :: Pattern Double -> ParamPattern

pit3 :: Pattern Double -> ParamPattern

por :: Pattern Double -> ParamPattern

sag :: Pattern Double -> ParamPattern

scl :: Pattern Double -> ParamPattern

scp :: Pattern Double -> ParamPattern

scr :: Pattern Double -> ParamPattern

sld :: Pattern Double -> ParamPattern

std :: Pattern Double -> ParamPattern

stt :: Pattern Double -> ParamPattern

sus :: Pattern Double -> ParamPattern

tdecay :: Pattern Double -> ParamPattern

vcf :: Pattern Double -> ParamPattern

vco :: Pattern Double -> ParamPattern

voi :: Pattern Double -> ParamPattern

note :: Pattern Int -> ParamPattern

midinote :: Pattern Int -> ParamPattern

drum :: Pattern String -> ParamPattern

drumN :: String -> Int