mei:tuplet

A group of notes with "irregular" (sometimes called "irrational") rhythmic
values, for example, three notes in the time normally occupied by two or nine in the time of
five.

Element Information

Model

Attributes

QName Type Fixed Default Use Inheritable Annotation
beam.with mei:mei_data.OTHERSTAFF optional
In the case of cross-staff beams, the beam.with attribute is used to
indicate which staff the beam is connected to; that is, the staff above or the staff
below.
bracket.place mei:mei_data.PLACE optional
Used to state where a tuplet bracket will be placed in relation to the
note heads.
bracket.visible mei:mei_data.BOOLEAN optional
States whether a bracket should be rendered with a
tuplet.
color mei:mei_data.COLOR optional
Used to indicate visual appearance. Do not confuse this with the musical
term 'color' as used in pre-CMN notation.
copyof mei:mei_data.URI optional
Points to an element of which the current element is a
copy.
corresp restriction of list of mei:mei_data.URI optional
Used to point to other elements that correspond to this one in a generic
fashion.
dots mei:mei_data.AUGMENTDOT optional
Records the number of augmentation dots required by a dotted
duration.
dur restriction of list of mei:mei_data.DURATION.additive optional
Records duration using optionally dotted, relative durational values
provided by the data.DURATION datatype. When the duration is "irrational", as is sometimes
the case with tuplets, multiple space-separated values that add up to the total duration
may be used. When dotted values are present, the dots attribute must be
ignored.
dur.ges mei:mei_data.DURATION.gestural optional
Records performed duration information that differs from the written
duration. Its value may be expressed in several forms; that is, ppq (MIDI clicks and
MusicXML 'divisions'), Humdrum **recip values, beats, seconds, or mensural duration
values.
dur.visible mei:mei_data.BOOLEAN optional
Determines if the tuplet duration is visible.
endid mei:mei_data.URI optional
Indicates the final element in a sequence of events to which the feature
applies.
facs restriction of list of mei:mei_data.URI optional
Permits the current element to reference a facsimile surface or image zone
which corresponds to it.
label xs:string optional
Provides a name or label for an element. The value may be any
string.
layer restriction of list of xs:positiveInteger optional
Identifies the layer to which a feature applies.
n optional
Provides a number-like designation for an element.
next restriction of list of mei:mei_data.URI optional
Used to point to the next event(s) in a user-defined
collection.
num xs:positiveInteger optional
Along with numbase, describes duration as a ratio. num is the first value
in the ratio, while numbase is the second.
num.format restriction of xs:token optional
Controls how the num:numbase ratio is to be displayed.
num.place mei:mei_data.PLACE optional
States where the tuplet number will be placed in relation to the note
heads.
num.visible mei:mei_data.BOOLEAN optional
Determines if the tuplet number is visible.
numbase xs:positiveInteger optional
Along with num, describes duration as a ratio. num is the first value in
the ratio, while numbase is the second.
prev restriction of list of mei:mei_data.URI optional
Points to the previous event(s) in a user-defined
collection.
sameas restriction of list of mei:mei_data.URI optional
Points to an element that is the same as the current element but is not a
literal copy of the current element.
staff restriction of list of xs:positiveInteger optional
Signifies the staff on which a notated event occurs or to which a control
event applies. Mandatory when applicable.
startid mei:mei_data.URI optional
Holds a reference to the first element in a sequence of events to which
the feature applies.
synch restriction of list of mei:mei_data.URI optional
Points to elements that are synchronous with the current
element.
tstamp mei:mei_data.BEAT optional
Encodes the onset time in terms of musical time, i.e.,
beats[.fractional_beat_part].
tstamp.ges mei:mei_data.DURATION.gestural optional
Captures performed onset time in several forms; that is, ppq (MIDI clicks
and MusicXML 'divisions'), Humdrum **recip values, beats, seconds, or mensural duration
values.
tstamp.real mei:mei_data.ISOTIME optional
Used to record the onset time in terms of ISO time.
when mei:mei_data.URI optional
Indicates the point of occurrence of this feature along a time line. Its
value must be the ID of a when element elsewhere in the document.
xml:base mei:mei_data.URI optional
Provides a base URI reference with which applications can resolve relative
URI references into absolute URI references.
xml:id xs:ID optional
Regularizes the naming of an element and thus facilitates building links
between it and other resources. Each id attribute within a document must have a unique
value.

Used By

Source

<xs:element name="tuplet">
  <xs:annotation>
    <xs:documentation>A group of notes with "irregular" (sometimes called "irrational") rhythmic values, for example, three notes in the time normally occupied by two or nine in the time of five.</xs:documentation>
  </xs:annotation>
  <xs:complexType>
    <xs:choice minOccurs="0" maxOccurs="unbounded">
      <xs:group ref="mei:mei_model.eventLike"/>
      <xs:element ref="mei:mei_model.appLike"/>
      <xs:element ref="mei:mei_model.editLike"/>
      <xs:element ref="mei:mei_model.transcriptionLike"/>
    </xs:choice>
    <xs:attributeGroup ref="mei:mei_att.common.attributes"/>
    <xs:attributeGroup ref="mei:mei_att.facsimile.attributes"/>
    <xs:attributeGroup ref="mei:mei_att.tuplet.log.attributes"/>
    <xs:attributeGroup ref="mei:mei_att.tuplet.vis.attributes"/>
    <xs:attributeGroup ref="mei:mei_att.tuplet.ges.attributes"/>
    <xs:attributeGroup ref="mei:mei_att.tuplet.anl.attributes"/>
  </xs:complexType>
</xs:element>

Sample