Learn R Programming

gm (version 2.0.0)

Articulation: Create Articulation Object

Description

Create an Articulation object to represent an articulation mark.

Usage

Articulation(name, i, to = NULL)

Value

A list of class Articulation.

Arguments

name

A single character, which represents the name or symbol of the articulation. For example, to create a staccato dot, name can be "staccato" or ".", which looks like a staccato. See the Details section for supported articulations.

i

A single positive integer, which represents the position of the articulation in a musical line.

to

Optional. A single character or a single positive integer, which indicates the musical line where to add the articulation.

Details

Supported articulation names and symbols:

  • "accent" or ">"

  • "staccato" or "."

  • "staccatissimo" or "'"

  • "tenuto" or "-"

  • "tenuto-staccato", "detached-legato" or "-."

  • "marcato", "strong-accent" or "^"

  • "scoop"

  • "plop"

  • "doit"

  • "fall" or "falloff"

  • "stress" or ","

  • "unstress" or "u"

  • "soft accent", "soft-accent" or "<>"

The names are from the MusicXML specification and MuseScore.

See Also

+.Music() for adding an Articulation to a Music object.

Examples

Run this code
# Create a staccato
staccato <- Articulation(".", 1)
staccato

# Add it to a `Music`
music <- Music() + Meter(4, 4) + Line(c("C4", "D4")) + staccato
music

# Generate the music score
if (interactive()) {
  show(music)
}

Run the code above in your browser using DataLab