mei:staffDef

(staff definition) – Container for staff
meta-information.

Element Information

Model

Attributes

QName Type Fixed Default Use Inheritable Annotation
beam.color mei:mei_data.COLOR optional
Color of beams, including those associated with
tuplets.
beam.group xs:string optional
Provides an example of how automated beaming (including secondary beams)
is to be performed.
beam.rend restriction of xs:token optional
Encodes whether a beam is "feathered" and in which
direction.
beam.rests mei:mei_data.BOOLEAN optional
Indicates whether automatically-drawn beams should include rests shorter
than a quarter note duration.
beam.slope xs:decimal optional
Captures beam slope.
clef.color mei:mei_data.COLOR optional
Describes the color of the clef.
clef.dis mei:mei_data.OCTAVE.DIS optional
Records the amount of octave displacement to be applied to the
clef.
clef.dis.place mei:mei_data.PLACE optional
Records the direction of octave displacement to be applied to the
clef.
clef.line mei:mei_data.CLEFLINE optional
Contains a default value for the position of the clef. The value must be
in the range between 1 and the number of lines on the staff. The numbering of lines starts
with the lowest line of the staff.
clef.shape mei:mei_data.CLEFSHAPE optional
Encodes a value for the clef symbol.
clef.visible mei:mei_data.BOOLEAN optional
Determines whether the clef is to be displayed.
decls restriction of list of mei:mei_data.URI optional
Identifies one or more metadata elements within the header, which are
understood to apply to the element bearing this attribute and its
content.
dur.default mei:mei_data.DURATION optional
Contains a default duration in those situations when the first note, rest,
chord, etc. in a measure does not have a duration specified.
dynam.dist mei:mei_data.MEASUREMENTREL optional
Records the default distance from the staff for dynamic
marks.
grid.show mei:mei_data.BOOLEAN optional
Determines whether to display guitar chord grids.
harm.dist mei:mei_data.MEASUREMENTREL optional
Records the default distance from the staff of harmonic indications, such
as guitar chord grids or functional labels.
instr mei:mei_data.URI optional
Provides a way of pointing to a MIDI instrument definition. It must
contain the ID of an <instrDef> element elsewhere in the
document.
key.accid mei:mei_data.ACCIDENTAL.IMPLICIT optional
Contains an accidental for the tonic key, if one is required, e.g., if
key.pname equals 'c' and key.accid equals 's', then a tonic of C# is
indicated.
key.mode mei:mei_data.MODE optional
Indicates major, minor, or other tonality.
key.pname mei:mei_data.PITCHNAME optional
Holds the pitch name of the tonic key, e.g. 'c' for the key of
C.
key.sig mei:mei_data.KEYSIGNATURE optional
Indicates where the key lies in the circle of fifths.
key.sig.mixed restriction of list of mei:mei_data.KEYSIGTOKEN optional
Mixed key signatures, e.g. those consisting of a mixture of flats and
sharps (Read, p. 143, ex. 9-39), and key signatures with unorthodox placement of the
accidentals (Read, p. 141) must be indicated by setting the key.sig attribute to 'mixed'
and providing explicit key signature information in the key.sig.mixed attribute or in the
<keySig> element. It is intended that key.sig.mixed contain a series of tokens with
each token containing pitch name, accidental, and octave, such as 'a4 c5s e5f' that
indicate what key accidentals should be rendered and where they should be
placed.
key.sig.show mei:mei_data.BOOLEAN optional
Indicates whether the key signature should be
displayed.
key.sig.showchange mei:mei_data.BOOLEAN optional
Determines whether cautionary accidentals should be displayed at a key
change.
label xs:string optional
Provides a name or label for an element. The value may be any
string.
label.abbr xs:string optional
Provides a label for a group of staves on pages after the first page.
Usually, this label takes an abbreviated form.
layerscheme mei:mei_data.LAYERSCHEME optional
Indicates the number of layers and their stem
directions.
lines xs:positiveInteger optional
Indicates the number of staff lines.
lines.color restriction of list of mei:mei_data.COLOR optional
Captures the colors of the staff lines. The value is structured; that is,
it should have the same number of space-separated RGB values as the number of lines
indicated by the lines attribute. A line can be made invisible by assigning it the same
RGB value as the background, usually white.
lines.visible mei:mei_data.BOOLEAN optional
Records whether all staff lines are visible.
lyric.align mei:mei_data.MEASUREMENTREL optional
Describes the alignment of lyric syllables associated with a note or
chord.
lyric.fam mei:mei_data.FONTFAMILY optional
Sets the font family default value for lyrics.
lyric.name mei:mei_data.FONTNAME optional
Sets the font name default value for lyrics.
lyric.size mei:mei_data.FONTSIZE optional
Sets the default font size value for lyrics.
lyric.style mei:mei_data.FONTSTYLE optional
Sets the default font style value for lyrics.
lyric.weight mei:mei_data.FONTWEIGHT optional
Sets the default font weight value for lyrics.
mensur.color mei:mei_data.COLOR optional
Records the color of the mensuration sign. Do not confuse this with the
musical term 'color' as used in pre-CMN notation.
mensur.dot mei:mei_data.BOOLEAN optional
Determines if a dot is to be added to the base symbol.
mensur.form restriction of xs:token optional
Indicates whether the base symbol is written vertically or
horizontally.
mensur.loc mei:mei_data.STAFFLOC optional
Holds the staff location of the mensuration sign.
mensur.orient mei:mei_data.ORIENTATION optional
Describes the rotation or reflection of the base
symbol.
mensur.sign mei:mei_data.MENSURATIONSIGN optional
The base symbol in the mensuration sign/time signature of mensural
notation.
mensur.size mei:mei_data.SIZE optional
Describes the relative size of the mensuration sign.
mensur.slash xs:positiveInteger optional
Indicates the number lines added to the mensuration sign. For example, one
slash is added for what we now call 'alla breve'.
meter.count restriction of xs:string optional
Captures the number of beats in a measure, that is, the top number of the
meter signature. It must contain a decimal number or an additive expression that evaluates
to a decimal number, such as 2+3.
meter.rend restriction of xs:token optional
Contains an indication of how the meter signature should be
rendered.
meter.showchange mei:mei_data.BOOLEAN optional
Determines whether a new meter signature should be displayed when the
meter signature changes.
meter.sym mei:mei_data.METERSIGN optional
Indicates the use of a meter symbol instead of a numeric meter signature,
that is, 'C' for common time or 'C' with a slash for cut time.
meter.unit xs:decimal optional
Contains the number indicating the beat unit, that is, the bottom number
of the meter signature.
modusmaior mei:mei_data.MODUSMAIOR optional
Describes the maxima-long relationship.
modusminor mei:mei_data.MODUSMINOR optional
Describes the long-breve relationship.
multi.number mei:mei_data.BOOLEAN optional
Indicates whether programmatically calculated counts of multiple measures
of rest (mRest) and whole measure repeats (mRpt) in parts should be
rendered.
n xs:nonNegativeInteger optional
A non-negative integer value functioning as a "name".
notationsubtype xs:NMTOKEN optional
Provides any sub-classification of the notation contained or described by
the element, additional to that given by its notationtype attribute.
notationtype mei:mei_data.NOTATIONTYPE optional
Contains classification of the notation contained or described by the
element bearing this attribute.
num.default xs:positiveInteger optional
Along with numbase.default, describes the default duration as a ratio.
num.default is the first value in the ratio.
numbase.default xs:positiveInteger optional
Along with num.default, describes the default duration as a ratio.
numbase.default is the second value in the ratio.
octave.default mei:mei_data.OCTAVE optional
Contains a default octave specification for use when the first note, rest,
chord, etc. in a measure does not have an octave value specified.
ontheline mei:mei_data.BOOLEAN optional
Determines the placement of notes on a 1-line staff. A value of 'true'
places all notes on the line, while a value of 'false' places stems-up notes above the
line and stems-down notes below the line.
pedal.style restriction of xs:token optional
Determines whether piano pedal marks should be rendered as lines or as
terms.
ppq xs:positiveInteger optional
Indicates the number of pulses (sometimes referred to as ticks or
divisions) per quarter note. Unlike MIDI, MEI permits different values for a score and
individual staves.
prolatio mei:mei_data.PROLATIO optional
Describes the semibreve-minim relationship.
proport.num xs:positiveInteger optional
Together, proport.num and proport.numbase specify a proportional change as
a ratio, e.g., 1:3. Proport.num is for the first value in the ratio.
proport.numbase xs:positiveInteger optional
Together, proport.num and proport.numbase specify a proportional change as
a ratio, e.g., 1:3. Proport.numbase is for the second value in the
ratio.
reh.enclose restriction of xs:token optional
Describes the enclosing shape for rehearsal marks.
scale mei:mei_data.PERCENT optional
Scale factor to be applied to the feature to make it the desired display
size.
slur.lform mei:mei_data.LINEFORM optional
slur.lwidth mei:mei_data.LINEWIDTH optional
spacing mei:mei_data.MEASUREMENTREL optional
Records the absolute distance (as opposed to the relative distances
recorded in <scoreDef> elements) between this staff and the preceding one in the
same system. This value is meaningless for the first staff in a system since the
spacing.system attribute indicates the spacing between systems.
tab.strings restriction of list of restriction of xs:token optional
Provides a *written* pitch and octave for each open string or course of
strings.
tempus mei:mei_data.TEMPUS optional
Describes the breve-semibreve relationship.
text.dist mei:mei_data.MEASUREMENTREL optional
Determines how far from the staff to render text
elements.
text.fam mei:mei_data.FONTFAMILY optional
Provides a default value for the font family name of text (other than
lyrics) when this information is not provided on the individual
elements.
text.name mei:mei_data.FONTNAME optional
Provides a default value for the font name of text (other than lyrics)
when this information is not provided on the individual elements.
text.size mei:mei_data.FONTSIZE optional
Provides a default value for the font size of text (other than lyrics)
when this information is not provided on the individual elements.
text.style mei:mei_data.FONTSTYLE optional
Provides a default value for the font style of text (other than lyrics)
when this information is not provided on the individual elements.
text.weight mei:mei_data.FONTWEIGHT optional
Provides a default value for the font weight for text (other than lyrics)
when this information is not provided on the individual elements.
tie.lform mei:mei_data.LINEFORM optional
tie.lwidth mei:mei_data.LINEWIDTH optional
trans.diat xs:decimal optional
Records the amount of diatonic pitch shift, e.g., C to C♯ = 0, C to D♭ =
1, necessary to calculate the sounded pitch from the written one.
trans.semi xs:decimal optional
Records the amount of pitch shift in semitones, e.g., C to C♯ = 1, C to D♭
= 1, necessary to calculate the sounded pitch from the written one.
visible mei:mei_data.BOOLEAN optional
Indicates if a feature should be rendered when the notation is presented
graphically or sounded when it is presented in an aural form.
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="staffDef">
  <xs:annotation>
    <xs:documentation>(staff definition) – Container for staff meta-information.</xs:documentation>
  </xs:annotation>
  <xs:complexType>
    <xs:sequence>
      <xs:element minOccurs="0" maxOccurs="unbounded" ref="mei:mei_model.labelLike"/>
      <xs:choice minOccurs="0" maxOccurs="unbounded">
        <xs:element ref="mei:mei_model.instrDefLike"/>
        <xs:element ref="mei:mei_model.layerDefLike"/>
        <xs:group ref="mei:mei_model.staffDefPart"/>
      </xs:choice>
    </xs:sequence>
    <xs:attributeGroup ref="mei:mei_att.commonPart.attributes"/>
    <xs:attributeGroup ref="mei:mei_att.declaring.attributes"/>
    <xs:attributeGroup ref="mei:mei_att.staffDef.log.attributes"/>
    <xs:attributeGroup ref="mei:mei_att.staffDef.vis.attributes"/>
    <xs:attributeGroup ref="mei:mei_att.staffDef.ges.attributes"/>
    <xs:attribute name="n" type="xs:nonNegativeInteger">
      <xs:annotation>
        <xs:documentation>A non-negative integer value functioning as a "name".</xs:documentation>
      </xs:annotation>
    </xs:attribute>
  </xs:complexType>
</xs:element>

Sample