The staff source object

Type: Dictionary

The staff source object is the way to specify which parts are included in a given layout. You can optionally target a specific voice or staff (for multi-voice parts).


Name Type Required? Description
"label" staff label object No An optional name for this source's part of the staff. If provided, this should be rendered to the left of the staff, vertically aligned to communicate the label is for this particular source (as opposed to other sources in the same staff).

This should only be used in cases where a single staff is sourced from more than one staff source and you want to more than one label for that staff. Otherwise, use a label on the staff object instead.
"labelref" staff labelref object No If provided, this specifies that the corresponding part's name (or shortName) should be rendered to the left of the staff. See the documentation for "label".

By using this instead of the "label" attribute, you can avoid needing to duplicate a part's name in an MNX document.
"part" id object Yes A reference to the appropriate part.
"staff" staff number object No Optional staff within the given part. This allows you to choose which staff to use from a multi-staff part.
"stem" stem direction object No The stem direction to use for all notes within the associated part. Default is "float", meaning the stem directions should be determined algorithmically.
"voice" voice name object No Optional voice within the given part. This allows you to filter the associated part's sequence data by voice.

This is useful for complex orchestral scores, where individual parts are sometimes placed on multiple staves but sometimes placed on a single staff.

If this is not provided, the layout will use all the notation data from the part (i.e., applying no filter).


This object is used in the following examples:

Multimeasure rests, Multiple layouts, Orchestral layout, Organ layout, System layouts