A description of system decoration and staff names.

This page describes the visual aspects of scores involving braces, brackets, staff names and abbreviations, as well as group names and abbreviations.

Staff names

Staff names are given in tandem interpretations starting with the string *I". The staff names are related to instrument codes, such as *Icello for the violon cello. The staff names are a visual description off the instrument or other text displayed at the start of a movement, while instrument codes are for analysis purposes. Giving a staff name will override the display of an automatically generated name from an instrument code at the start of the data (but automatic staff name generation from the instrument code is not implemented yet).

Here is an example of a string quartet score, where each of the staff names are given (try changing the names in the text box on the left, and they will update as you type on the right):

**kern	**kern	**kern	**kern
*I"Cello	*I"Viola	*I"Violin 2	*I"Violin 1
*M4/4	*M4/4	*M4/4	*M4/4
=	=	=	=
1CC	1c	1g	1ee
=	=	=	=
*-	*-	*-	*-
Engraved by Verovio 5.2.0-dev-4660ee3-dirty Violin 1 Violin 2 Viola Cello

Staff abbreviations

After the first system in a movement, the will be no instrument names displayed on successive systems. An optional staff abbreviation can be given by prefixing *I' before the abbreviation string for the staff.

**kern	**kern	**kern	**kern
*I"Cello	*I"Viola	*I"Violin 2	*I"Violin 1
*I'vc.	*I'vla.	*I'vln. 2	*I'vln. 1
*M4/4	*M4/4	*M4/4	*M4/4
=1	=1	=1	=1
1CC	1c	1g	1ee
=2	=2	=2	=2
1DD	1D	1f	1aa
=3	=3	=3	=3
1EE	1G	1b	1gg
=4	=4	=4	=4
1FF	1F	1a	1cc
=5	=5	=5	=5
1GG	1D	1g	1b
=6	=6	=6	=6
1AA	1C	1e	1a
=7	=7	=7	=7
1BB	1D	1d	1f
=8	=8	=8	=8
1C;	1C;	1e;	1g;
==	==	==	==
*-	*-	*-	*-
Engraved by Verovio 5.2.0-dev-4660ee3-dirty Violin 1 Violin 2 Viola Cello vln. 1 vln. 2 vla. vc. 5

System styling

Default styling

When the system contains only a single staff, no decoration is added to the system:

**kern
*I"Cello
*I'vc.
*M4/4
=1
1CC
=2
1DD
=3
1EE
=
*-
Engraved by Verovio 5.2.0-dev-4660ee3-dirty Cello

When the system contains two staves, a brace will automatically be added, and the staves will be barred together (although this should not be done if there are lyrics attached to the top staff).

**kern	**kern
*part1	*part1
*I"Piano	*I"Piano
*M4/4	*M4/4
=1	=1
1CC	1ee
=2	=2
1DD	1b
=3	=3
1EE	1g
=	=
*-	*-
Engraved by Verovio 5.2.0-dev-4660ee3-dirty Piano

When there are three or more staves, a bracket will automatically be added, but the staves will not be barred together.

**kern	**kern	**kern
*I"part 3	*I"part 2	*I"part 1
*M4/4	*M4/4	*M4/4
=1	=1	=1
1CC	1ee	1gg
=2	=2	=2
1DD	1b	1ff
=3	=3	=3
1EE	1g	1ee
=	=	=
*-	*-	*-
Engraved by Verovio 5.2.0-dev-4660ee3-dirty part 1 part 2 part 3

System decoration

To override the default brace/bracket and barring styles, a line starting with !!!system-decoration: can give a different style. To use this system, it is expected that all parts contain staff enumerations, and these staff numbers are referenced in the system decoration string.

Here is an example for a string quartet, where the system decoration connects the bars on all staves together:

**kern	**kern	**kern	**kern
*staff4	*staff3	*staff2	*staff1
*I"Cello	*I"Viola	*I"Violin 2	*I"Violin 1
*M4/4	*M4/4	*M4/4	*M4/4
=	=	=	=
1CC	1c	1g	1ee
=	=	=	=
*-	*-	*-	*-
!!!system-decoration: [(s1,s2,s3,s4)]
Engraved by Verovio 5.2.0-dev-4660ee3-dirty Violin 1 Violin 2 Viola Cello

Staff wildcard

If you only need a single brace or bracket for the entire system, either barred or unbarred, then you can use * to represent all staves.

**kern	**kern	**kern	**kern
*staff4	*staff3	*staff2	*staff1
*I"Cello	*I"Viola	*I"Violin 2	*I"Violin 1
*M4/4	*M4/4	*M4/4	*M4/4
=	=	=	=
1CC	1c	1g	1ee
=	=	=	=
*-	*-	*-	*-
!!!system-decoration: [(*)]
Engraved by Verovio 5.2.0-dev-4660ee3-dirty Violin 1 Violin 2 Viola Cello

Here is an example of removing the bracket, but keeping the barring:

**kern	**kern	**kern	**kern
*staff4	*staff3	*staff2	*staff1
*I"Cello	*I"Viola	*I"Violin 2	*I"Violin 1
*M4/4	*M4/4	*M4/4	*M4/4
=	=	=	=
1CC	1c	1g	1ee
=	=	=	=
*-	*-	*-	*-
!!!system-decoration: (*)
Engraved by Verovio 5.2.0-dev-4660ee3-dirty Violin 1 Violin 2 Viola Cello

Notice that parentheses around staves (or the wildcard symbol) will case the staves to be barred together.

Here is an example of removing the bracket as well as the barring:

**kern	**kern	**kern	**kern
*staff4	*staff3	*staff2	*staff1
*I"Cello	*I"Viola	*I"Violin 2	*I"Violin 1
*M4/4	*M4/4	*M4/4	*M4/4
=	=	=	=
1CC	1c	1g	1ee
=	=	=	=
*-	*-	*-	*-
!!!system-decoration: *
Engraved by Verovio 5.2.0-dev-4660ee3-dirty Violin 1 Violin 2 Viola Cello

Grand staff name

There are several methods for giving a label to the grand staff. The first method is to add *part markers in each spine followed by matching non-zero integers.

**kern	**kern
*part1	*part1
*I"Piano	*
*M4/4	*M4/4
=	=
1CC	1f
=	=
*-	*-
Engraved by Verovio 5.2.0-dev-4660ee3-dirty Piano

Another method is to use group labels, which start with *I"", rather than part labels, which start with *I". This also has to be in coordination with *group markers indicating the staves that should be grouped together:

**kern	**kern
*group1	*group1
*I""Piano	*
*M4/4	*M4/4
=	=
1CC	1f
=	=
*-	*-
Engraved by Verovio 5.2.0-dev-4660ee3-dirty Piano

Instrument class grouping

Instrument class tandem interpretations can be used in an equivalent manner to *group# interpretations. Here is an example:

**kern	**kern	**kern	**kern	**kern	**kern	**kern	**kern	**kern
*staff9	*staff8	*staff7	*staff6	*staff5	*staff4	*staff3	*staff2	*staff1
*ICstr	*ICstr	*ICstr	*ICstr	*ICbras	*ICbras	*ICww	*ICww	*ICww	
*I"Cello	*I"Viola	*I"Violin 2	*I"Violin 1	*I"Trombone	*I"Trumpet	*I"Bassoon	*I"Oboe	*I"Flute
*IclefF4	*IclefC3	*IclefG2	*IclefG2	*IclefF4	*IclefG2	*IclefF4	*IclefG2	*IclefG2
*M4/4	*M4/4	*M4/4	*M4/4	*M4/4	*M4/4	*M4/4	*M4/4	*M4/4
=	=	=	=	=	=	=	=	=
1CC	1c	1cc	1ccc	1C	1cc	1C	1cc	1ccc
=	=	=	=	=	=	=	=	=
*-	*-	*-	*-	*-	*-	*-	*-	*-
!!!system-decoration: [(ww)][(bras)][(str)]
Engraved by Verovio 5.2.0-dev-4660ee3-dirty Flute Oboe Bassoon Trumpet Trombone Violin 1 Violin 2 Viola Cello

Undecorated grouping

Here is an example of giving no decoration to a group by using angle brackets (<>) in the system decoration string:

**kern	**kern	**kern	**kern	**kern
*	*	*	*group1	*group1
*	*	*	*I""Tenori	*I""Tenori
*part4	*part4	*part3	*part2	*part1
*I"Organo	*I"Organo	*I"Basso	*	*
*I'Org	*I'Org	*I'B	*I'T	*I'T
*staff5	*staff4	*staff3	*staff2	*staff1
*clefF4	*clefG2	*clefF4	*clefC4	*clefC4
*k[b-]	*k[b-]	*k[b-]	*k[b-]	*k[b-]
*M3/4	*M3/4	*M3/4	*M3/4	*M3/4
=1	=1	=1	=1	=1
2.FF	2.a 2.ff	4.F	4.A	4.f
.	.	8F	8A	8f
.	.	4F	4A	4f
=	=	=	=	=
*-	*-	*-	*-	*-
!!!system-decoration: <g1>,p3,{(p4)}
Engraved by Verovio 5.2.0-dev-4660ee3-dirty Tenori Basso Organo