R: Continuous note decay scales

scale_decayp_exp {playitbyr} R Documentation

Continuous note decay scales

Description

These shortcut functions (with the notation scale_[sound parameter]_[scaling function]) are intended to be added onto a sonify object to specify how [data parameter] from the data (a column of the data) is to be mapped to sonic parameters (here, "decayp", the percentage of the note devoted to the decay/fade out).

Usage

  scale_decayp_exp(soundlimits, limits = NULL, by = NULL,
    ...)

  scale_decayp_continuous(soundlimits, limits = NULL,
    by = NULL, ...)

Arguments

`...`	Other parameters (currently ignored)
`soundlimits`	The limits of the sound parameter.
`limits`	The limits of the data to train, a numeric vector of length 2. All data values outside these limits are returned as `NA`. If `NULL`, the default, the function takes the minimum and maximum of the data
`by`	The unit to round the sound parameter to.

Details

In shape_scatter, there are 3 phases of a note: the attack (the initial fade-in of the note), sustain (where the note is held), and the decay (the final fade-out of the note. decayp is the percentage of the note devoted to the decay; so a note with decayp would have a very abrupt ending, whereas a note with decayp = 0.5 would gradually fade out.

_continuous scales are a linear scaling, whereas _exp is an exponential scale.

Value