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).
Keys
| Name | Type | Required? | Description |
|---|---|---|---|
| staff label | 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. |
|
| 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. |
|
| ID | Yes | A reference to the appropriate part. | |
| staff number | No | Optional staff within the given part. This allows you to choose which staff to use from a multi-staff part. | |
| 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 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). |
Parent objects
This object is used by the following parent objects:
- staff: "sources"
Examples
This object is used in the following examples: