The <percussion> element

Parent element: <direction-type>


The <percussion> element is used to define percussion pictogram symbols. The organization of these symbols follows the definitions in Kurt Stone's "Music Notation in the Twentieth Century" on pages 206-212 and 223. More pictograms have been added to the ones listed in Stone, based on how usage has evolved since the book was published in 1980.

Content

Exactly one of the following

Attributes

Name Type Required? Description
color color No Indicates the color of an element.
default-x tenths No Changes the computation of the default horizontal position. The origin is changed relative to the start of the entire current measure, at either the left barline or the start of the system. Positive x is right and negative x is left.

This attribute provides higher-resolution positioning data than the <offset> element. Applications reading a MusicXML file that can understand both features should generally rely on this attribute for its greater accuracy.
default-y tenths No Changes the computation of the default vertical position. The origin is changed relative to the top line of the staff. Positive y is up and negative y is down.

This attribute provides higher-resolution positioning data than the placement attribute. Applications reading a MusicXML file that can understand both attributes should generally rely on this attribute for its greater accuracy.
enclosure enclosure-shape No Formatting of an enclosure around text or symbols.
font-family font-family No A comma-separated list of font names.
font-size font-size No One of the CSS sizes or a numeric point size.
font-style font-style No Normal or italic style.
font-weight font-weight No Normal or bold weight.
halign left-center-right No In cases where text extends over more than one line, horizontal alignment and justify values can be different. The most typical case is for credits, such as:

Words and music by
Pat Songwriter

Typically this type of credit is aligned to the right, so that the position information refers to the right-most part of the text. But in this example, the text is center-justified, not right-justified.

The halign attribute is used in these situations. If it is not present, its value is the same as for the justify attribute. For elements where a justify attribute is not allowed, the default is implementation-dependent.
id ID No Specifies an ID that is unique to the entire document.
relative-x tenths No Changes the horizontal position relative to the default position, either as computed by the individual program, or as overridden by the default-x attribute. Positive x is right and negative x is left. It should be interpreted in the context of the <offset> element or directive attribute if those are present.
relative-y tenths No Changes the vertical position relative to the default position, either as computed by the individual program, or as overridden by the default-y attribute. Positive y is up and negative y is down. It should be interpreted in the context of the placement attribute if that is present.
valign valign No Indicates vertical alignment to the top, middle, bottom, or baseline of the text. The default is implementation-dependent.

Examples

This element is used in the following examples:

<beater>, <effect>, <glass>, <membrane>, <metal>, <pitched>, <stick-location>, <stick>, <timpani>, <wood>