chord_arpeggiate {tabr}

Arpeggiate a chord

Description

Create an arpeggio from a chord.

Usage

chord_arpeggiate(
  chord,
  n = 0,
  by = c("note", "chord"),
  broken = FALSE,
  collapse = FALSE
)

Arguments

chord

character, a single chord.

n

integer, number of steps, negative indicates reverse direction (decreasing pitch).

by

whether each of the n steps refers to individual notes in the chord (an inversion) or raising the entire chord in its given position by one octave.

broken

logical, return result as an arpeggio of broken chords.

collapse

logical, collapse result into a single string ready for phrase construction.

Details

This function is based on chord_invert. If n = 0 then chord is returned immediately; other arguments are ignored.

Value

character

Examples

chord_arpeggiate("ce_gb_", 2)
chord_arpeggiate("ce_gb_", -2)
chord_arpeggiate("ce_gb_", 2, by = "chord")
chord_arpeggiate("ce_gb_", 1, broken = TRUE, collapse = TRUE)