The slur object

Type: Dictionary

Keys:

Name Type Required? Description
"endNote" id object No The ID of the specific note at which this slur ends. This note must be within the event specified by this slur's "target" attribute.

For example, you can use endNote to encode which specific note, within a chord, a slur is intended to end on — in cases when music has multiple slurs end on the same event.
"lineType" line type object No The slur's line type. If not provided, the consuming software should determine the value automatically according to its own logic.
"location" slur/tie end location object No The value of location may lie either before or after the slur’s event, or it may use the special values "incoming" or "outgoing". The handling is as follows:

* If the location precedes the start of the current event, this signifies a slur starting at the given location and ending on the current event.

* If the location occurs after the start of the current event, this signifies a slur starting at the current event and ending at the given location.

* A value of "incoming" places the start location at a conventionally short distance before the current event, and ends on the current event.

* A value of "outgoing" starts on the current event, and places the end location at a conventionally short distance after the current event.

If neither target nor location is given, the effect is as if location="outgoing" was specified.
"side" slur side object No The slur's side. If not provided, the consuming software should determine the value automatically according to its own logic.
"sideEnd" slur side object No The slur’s side at the end of the slur, in cases where it differs from its initial side — for example, in cross-staff notation. If not provided, it's interpreted to have the same value as "side".
"startNote" id object No The ID of the specific note at which this slur starts. This note must be within the event that contains this slur.

For example, you can use startNote to encode which specific note, within a chord, a slur is intended to start on — in cases when music has multiple slurs starting on the same event.
"target" id object No If provided, this specifies the ID of the slur’s end event — that is, the last event over which this slur is rendered. This ID must exist in the document and must identify an event.

If not provided, the slur does not connect to a particular destination event. In this case, "location" may be used to specify the location of the other end of the slur.

Examples

This object is used in the following examples:

Slurs, Slurs (for chords), Slurs (incomplete slurs), Slurs (targeting specific notes)