Type alias PrincipalVoiceAttributes

Type declaration

• color: string | null

  Indicates the color of an element.

• default-x: number | null

  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: number | null

  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: string | null

  A comma-separated list of font names.

• font-size: "xx-small" | "x-small" | "small" | "medium" | "large" | "x-large" | "xx-large" | number | null

  One of the CSS sizes or a numeric point size.

• font-style: "normal" | "italic" | null

  Normal or italic style.

• font-weight: "normal" | "bold" | null

  Normal or bold weight.

• halign: "left" | "center" | "right" | null

  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: string | null

  Specifies an ID that is unique to the entire document.

• relative-x: number | null

  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 element or directive attribute if those are present.

• relative-y: number | null

  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 element or directive attribute if those are present.

• symbol: "none" | "Hauptstimme" | "Nebenstimme" | "plain"

  Indicates the type of symbol used. When used for analysis separate from any printed score markings, it should be set to none. Otherwise if the type is stop it should be set to plain.

• type: "start" | "stop"

  Indicates if this is the start or stop of the principal voice.

• valign: "top" | "middle" | "bottom" | "baseline" | null

  Indicates vertical alignment to the top, middle, bottom, or baseline of the text. The default is implementation-dependent.