rest

<rest>

A non-sounding event found in the source being transcribed.

Module MEI.shared

Attributes


@altsym(optional)Provides a way of pointing to a user-defined symbol. It must contain an ID of a <symbolDef> element elsewhere in the document. Value conforms to data.URI. att.altsym
@beam(optional)Indicates that this event is "under a beam". One or more values from data.BEAM, separated by spaces. att.beamed
@color(optional)Used to indicate visual appearance. Do not confuse this with the musical term 'color' as used in pre-CMN notation. Value conforms to data.COLOR. att.color
@copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI. att.common.anl
@corresp(optional)Used to point to other elements that correspond to this one in a generic fashion. One or more values from data.URI, separated by spaces. att.common.anl
@dots(optional)Records the number of augmentation dots required by a dotted duration. Value conforms to data.AUGMENTDOT. att.augmentdots
@dur(optional)Records the duration of a feature using the relative durational values provided by the data.DURATION datatype. Value conforms to data.DURATION. att.duration.musical
@dur.ges(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. Value conforms to data.DURATION.gestural. att.duration.performed
@enclose(optional)Records the characters often used to mark accidentals, articulations, and sometimes notes as having a cautionary or editorial function. For an example of cautionary accidentals enclosed in parentheses, see Read, p. 131, ex. 9-14. Value conforms to data.ENCLOSURE. att.enclosingchars
@facs(optional)Permits the current element to reference a facsimile surface or image zone which corresponds to it. One or more values from data.URI, separated by spaces. att.facsimile
@fermata(optional)Indicates the attachment of a fermata to this element. If visual information about the fermata needs to be recorded, then a <fermata> element should be employed instead. Value conforms to data.PLACE. att.fermatapresent
@fontfam(optional)Contains the name of a font-family. Value conforms to data.FONTFAMILY. att.typography
@fontname(optional)Holds the name of a font. Value conforms to data.FONTNAME. att.typography
@fontsize(optional)Indicates the size of a font expressed in printers' points, i.e., 1/72nd of an inch, relative terms, e.g., "small", "larger", etc., or percentage values relative to "normal" size, e.g., "125%". Value conforms to data.FONTSIZE. att.typography
@fontstyle(optional)Records the style of a font, i.e, italic, oblique, or normal. Value conforms to data.FONTSTYLE. att.typography
@fontweight(optional)Used to indicate bold type. Value conforms to data.FONTWEIGHT. att.typography
@ho(optional)Records a horizontal adjustment to a feature's programmatically-determined location in terms of staff interline distance; that is, in units of 1/2 the distance between adjacent staff lines. Value conforms to data.MEASUREMENTREL. att.visualoffset.ho
@instr(optional)Provides a way of pointing to a MIDI instrument definition. It must contain the ID of an <instrDef> element elsewhere in the document. Value conforms to data.URI. att.instrumentident
@label(optional)Provides a name or label for an element. The value may be any string. Value of datatype string. att.commonPart
@layer(optional)Identifies the layer to which a feature applies. One or more values of datatype positiveInteger, separated by spaces. att.layerident
@loc(optional)Holds the staff location of the feature. Value conforms to data.STAFFLOC. att.staffloc
@n(optional)Provides a number-like designation for an element. Value conforms to token. att.common
@next(optional)Used to point to the next event(s) in a user-defined collection. One or more values from data.URI, separated by spaces. att.common.anl
@num(optional)Along with numbase, describes duration as a ratio. num is the first value in the ratio, while numbase is the second. Value of datatype positiveInteger. att.duration.ratio
@numbase(optional)Along with num, describes duration as a ratio. num is the first value in the ratio, while numbase is the second. Value of datatype positiveInteger. att.duration.ratio
@oloc(optional)Records staff location in terms of written octave. Value conforms to data.OCTAVE. att.staffloc.pitched
@ploc(optional)Captures staff location in terms of written pitch name. Value conforms to data.PITCHNAME. att.staffloc.pitched
@prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces. att.common.anl
@sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element. One or more values from data.URI, separated by spaces. att.common.anl
@size(optional)Describes the relative size of a feature. Value conforms to data.SIZE. att.relativesize
@spaces(optional)States how many spaces are covered by the rest. Value of datatype positiveInteger. att.rest.vis.mensural
@staff(optional)Signifies the staff on which a notated event occurs or to which a control event applies. Mandatory when applicable. One or more values of datatype positiveInteger, separated by spaces. att.staffident
@synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces. att.common.anl
@to(optional)Records a timestamp adjustment of a feature's programmatically-determined location in terms of musical time; that is, beats. Value conforms to data.TSTAMPOFFSET. att.visualoffset.to
@tstamp(optional)Encodes the onset time in terms of musical time, i.e., beats[.fractional_beat_part]. Value conforms to data.BEAT. att.timestamp.musical
@tstamp.ges(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. Value conforms to data.DURATION.gestural. att.timestamp.performed
@tstamp.real(optional)Used to record the onset time in terms of ISO time. Value conforms to data.ISOTIME. att.timestamp.performed
@tuplet(optional)Indicates that this feature participates in a tuplet. If visual information about the tuplet needs to be recorded, then a <tuplet> element should be employed. One or more values from data.TUPLET, separated by spaces. att.tupletpresent
@vo(optional)Records the vertical adjustment of a feature's programmatically-determined location in terms of staff interline distance; that is, in units of 1/2 the distance between adjacent staff lines. Value conforms to data.MEASUREMENTREL. att.visualoffset.vo
@when(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. Value conforms to data.URI. att.alignment
@x(optional)Encodes an x coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value of datatype decimal. att.xy
@xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references. Value conforms to data.URI. att.commonPart
@xml: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. Value of datatype ID. att.id
@y(optional)Encodes an y coordinate for a feature in an output coordinate system. When it is necessary to record the placement of a feature in a facsimile image, use the facs attribute. Value of datatype decimal. att.xy

Member of

model.eventLike

Contained by

MEI.cmnbeam tuplet

MEI.critapplem rdg

MEI.edittransabbr add corr damage del expan orig reg restore sic supplied unclear

MEI.mensuralligature

MEI.neumesineume syllable uneume

MEI.sharedlayer

May contain

MEI.critappapp

MEI.edittransadd choice corr damage del gap handShift orig reg restore sic subst supplied unclear

MEI.shareddot

Declaration


                  <classes>
                     
                     <memberOf
                           key="att.common"/>
                     
                     <memberOf
                           key="att.facsimile"/>
                     
                     <memberOf
                           key="att.rest.log"/>
                     
                     <memberOf
                           key="att.rest.vis"/>
                     
                     <memberOf
                           key="att.rest.ges"/>
                     
                     <memberOf
                           key="att.rest.anl"/>
                     
                     <memberOf
                           key="model.eventLike"/>
                     </classes>
                  <content>
                     
                     <rng:zeroOrMore>
                        
                        <rng:choice>
                           
                           <rng:ref
                                 
                                 name="dot"
                                 />
                           
                           <rng:ref
                                 
                                 name="model.appLike"
                                 />
                           
                           <rng:ref
                                 
                                 name="model.editLike"
                                 />
                           
                           <rng:ref
                                 
                                 name="model.transcriptionLike"
                                 />
                           </rng:choice>
                        </rng:zeroOrMore>
                     </content>

Remarks

See (Read, p. 96-102). Do not confuse this element with the space element, which is used as an aid for visual alignment.

Constraint

The value of @line must be less than or equal to the number of lines on the staff.


                  <sch:rule context="mei:rest[@line]">
                     
                     <sch:let name="thisstaff" value="ancestor::mei:staff/@n"/>
                     
                     <sch:assert test="number(@line) <= number(preceding::mei:staffDef[@n=$thisstaff and @lines][1]/@lines)">The value of @line must be less than or equal to the number of lines on the
                        staff.</sch:assert>
                     </sch:rule>