The <pedal> element
Parent element: <direction-type>
The <pedal> element represents piano pedal marks, including damper and sostenuto pedal marks. The soft pedal is not included here because there is no special symbol or graphic used for it beyond what can be specified with <words> and <bracket> elements.
Content
Always empty.
Attributes
Name | Type | Required? | Description |
---|---|---|---|
type | pedal-type | Yes | Distinguishes different types of pedal directions. |
abbreviated | yes-no | No | Used only when the sign attribute is yes and the type is start or sostenuto; otherwise it is ignored. If yes, the short P and S signs are used. If no, the full Ped and Sost signs are used. It is no if not specified. |
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. |
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. |
id | ID | No | Specifies an ID that is unique to the entire document. |
line | yes-no | No | If yes, then pedal lines are used. |
number | number-level | No | Distinguishes multiple pedals when they overlap in MusicXML document order. |
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. |
sign | yes-no | No | If yes, then Ped, Sost, and * signs are used. For compatibility with older versions, it is yes if not specified if the line attribute is no, and is no if not specified if the line attribute is yes. If no, the alignment attributes are ignored. |
Examples
This element is used in the following examples: