gm (version 1.0.2)

Tempo: Create Tempo Object

Description

Create a Tempo object.

Tempo objects represent tempo marks.

Usage

Tempo(tempo, unit = NULL, bar = NULL, offset = NULL)

Value

A list with class Tempo.

Arguments

tempo

A number between 5 and 999 which indicates how many quarter notes per minute the tempo is.

unit

Optional. A duration notation, its abbreviation, or duration value corresponding to "whole", "half", "quarter", "eighth", "16th", with or without a dot. The default unit is "quarter".

bar

Optional. A positive integer which indicates the number of the measure at which to add the Tempo object. By default, a Tempo object will be added at the first measure.

offset

Optional. A duration value, sum of duration values or 0, which indicates the position in a measure, at which to add the Tempo object. The default value is 0.

See Also

+.Music() for adding Tempo objects to a Music object.

vignette("gm", package = "gm") for details about duration notations and duration values.

Examples

# create a Tempo object
Tempo(200)

# set unit in a Tempo object
Tempo(120, unit = "half.")

# add Tempo objects to a Music object
Music() + Tempo(200) + Tempo(100, bar = 10, offset = 1)