The <hammer-on> element

Parent element: <technical>


The <hammer-on> element is used in guitar and fretted instrument notation. Since a single slur can be marked over many notes, the <hammer-on> element is separate so the individual pair of notes can be specified. The element content can be used to specify how the <hammer-on> should be notated. An empty element leaves this choice up to the application.

Content

string

Attributes

Name Type Required? Description
type start-stop Yes Indicates if this is the start or stop of the hammer-on.
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 left-hand side of the note or the musical position within the bar. 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.
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.
number number-level No Distinguishes multiple hammer-ons when they overlap in MusicXML document order. The default value is 1.
placement above-below No Indicates whether something is above or below another element, such as a note or a notation.
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.

Examples

This element is used in the following examples:

Tutorial: Tablature