MusicXML 4.1 Draft
MusicXML 4.1 Draft > MusicXML Reference > Elements > The <tuplet> element

The <tuplet> element

Parent element: <notations>

tuplet

A tuplet element is present when a tuplet is to be displayed graphically, in addition to the sound data provided by the time-modification elements. The number attribute is used to distinguish nested tuplets. The bracket attribute is used to indicate the presence of a bracket. If unspecified, the results are implementation-dependent. The line-shape attribute is used to specify whether the bracket is straight or in the older curved or slurred style. It is straight by default.

Whereas a time-modification element shows how the cumulative, sounding effect of tuplets and double-note tremolos compare to the written note type, the tuplet element describes how this is displayed. The tuplet element also provides more detailed representation information than the time-modification element, and is needed to represent nested tuplets and other complex tuplets accurately.

The show-number attribute is used to display either the number of actual notes, the number of both actual and normal notes, or neither. It is actual by default. The show-type attribute is used to display either the actual type, both the actual and normal types, or neither. It is none by default.

Content

In this order

Attributes

Name Type Required? Description
bracket yes-no No
default-x tenths No
default-y tenths No
id xs:ID No
line-shape line-shape No
number number-level No
placement above-below No
relative-x tenths No
relative-y tenths No
show-number show-tuplet No
show-type show-tuplet No
type start-stop Yes

Examples

This element is used in the following examples:

<beam><normal-dot><time-modification><tuplet-dot><tuplet> (Nested)<tuplet> (Regular)<voice>Tutorial: Après un rêve