The staff source object | MNX specification

# 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).

## Attributes

Name | Type | Required? | Description
--- | --- | --- | ---
label | staff label | No | An optional name for this source's region 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 | 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 | Yes | A reference to the appropriate part.
staff | staff number | No | Optional staff within the given part. This allows you to choose which staff to use from a multi-staff part.
stem | stem direction | 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 | 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).

Plus globally available attributes: _c, _x, id

## Parent objects

This object is used by the following parent objects:

- staff: "sources"

## Examples

This object is used in the following examples:

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