Class: Tuplet

music21 .duration. Tuplet

new Tuplet(numberNotesActual, numberNotesNormal, durationActual, durationNormal)

Represents a Tuplet; found in music21.duration.Duration#tuplets

Parameters:

Name	Type	Description
`numberNotesActual`	number	numerator of the tuplet, default 3
`numberNotesNormal`	number	denominator of the tuplet, default 2
`durationActual`	music21.duration.Duration \| number	duration or quarterLength of duration type, default music21.duration.Duration(0.5)
`durationNormal`	music21.duration.Duration \| number	unused; see music21p for description

Source:

music21/duration.js, line 336

Extends

music21.prebase.ProtoM21Object

Members

bracket :Boolean

Show a bracket above the tuplet

Type:

Boolean

Default Value:

true

Source:

music21/duration.js, line 365

placement :String

Bracket placement. Options are above or below.

Type:

String

Default Value:

'above'

Source:

music21/duration.js, line 373

tupletActualShow :String

What to show above the Tuplet. Options are number, type, or (string) none.

Type:

String

Default Value:

'number'

Source:

music21/duration.js, line 382

Methods

<static> Tuplet#setDurationType(type) → {music21.duration.Duration}

Set both durationActual and durationNormal for the tuplet.

Parameters:

Name	Type	Description
`type`	string	a duration type, such as `half`, `quarter`

Source:

music21/duration.js, line 428

Returns:

A converted music21.duration.Duration matching type

Type: music21.duration.Duration

<static> Tuplet#setRatio(actual, normal) → {undefined}

Sets the tuplet ratio.

Parameters:

Name	Type	Description
`actual`	Number	number of notes in actual (e.g., 3)
`normal`	Number	number of notes in normal (e.g., 2)

Source:

music21/duration.js, line 446

Returns:

Type: undefined

<static> Tuplet#totalTupletLength() → {Number}

Get the quarterLength corresponding to the total length that
the completed tuplet (i.e., 3 notes in a triplet) would occupy.

Source:

music21/duration.js, line 462

Returns:

A quarter length.

Type: Number

<static> Tuplet#tupletMultiplier() → {Number}

The amount by which each quarter length is multiplied to get
the tuplet. For instance, in a normal triplet, this is 0.666

Source:

music21/duration.js, line 472

Returns:

A float of the multiplier

Type: Number