R: Continuous scales for note attacks

scale_attkp_continuous {playitbyr} R Documentation

Continuous scales for note attacks

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, "attkp", the sharpness of a note's initial attack).

Usage

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

  scale_attkp_exp(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. attkp is the percentage of the note devoted to the attack; so a note with attkp = 0.01 would have a very quick start of the note, whereas a note with attkp = 0.5 would gradually fade in.

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

Value