version that you are working on. See TRANSLATION for details.
@end ignore
-@c \version "2.11.61"
+@c \version "2.12.0"
@node Staff notation
@section Staff notation
@lilypondfile[quote]{staff-headword.ly}
-This section explains how to influence the staff appearance, print
-scores with more than one staff, and how to apply specific
-performance marks to single staves.
+This section explains how to influence the appearance of staves,
+how to print scores with more than one staff, and how to add tempo
+indications and cue notes to staves.
@menu
* Displaying staves::
@cindex staff instantiation
@cindex staff, new
@cindex staff, single
+@cindex staff, drum
+@cindex staff, percussion
@cindex drum staff
@cindex percussion staff
@cindex Gregorian transcription staff
@cindex tabstaff
@cindex tablature
+@funindex \drummode
+@funindex drummode
+
@notation{Staves} (singular: @notation{staff}) are created with
the @code{\new} or @code{\context} commands. For details, see
@ref{Creating contexts}.
\new Staff { c4 d e f }
@end lilypond
-@code{DrumStaff} creates a five-line staff set up for a
-typical drum set. It uses different names for each instrument.
-The instrument names are set using the @code{\drummode} command.
+The @code{DrumStaff} context creates a five-line staff set up for
+a typical drum set. Each instrument is shown with a different
+symbol. The instruments are entered in drum mode following a
+@code{\drummode} command, with each instrument specified by name.
For details, see @ref{Percussion staves}.
@lilypond[verbatim,quote]
}
@end lilypond
-@c FIXME: remove when mentioned in NR 2.8
-@code{GregorianTranscriptionStaff} creates a staff to notate
-modern Gregorian chant. It does not show bar lines.
-
-@lilypond[verbatim,quote,relative=2]
-\new GregorianTranscriptionStaff { c4 d e f e d }
-@end lilypond
-
@code{RhythmicStaff} creates a single-line staff that only
displays the rhythmic values of the input. Real durations are
preserved. For details, see @ref{Showing melody rhythms}.
music: @code{MensuralStaff} and @code{VaticanaStaff}. They are
described in @ref{Pre-defined contexts}.
+The @code{GregorianTranscriptionStaff} context creates a staff to
+notate modern Gregorian chant. It does not show bar lines.
+
+@lilypond[verbatim,quote,relative=2]
+\new GregorianTranscriptionStaff { c4 d e f e d }
+@end lilypond
+
New single staff contexts may be defined. For details, see
@ref{Defining new contexts}.
@seealso
-
Music Glossary:
@rglos{staff},
@rglos{staves}.
@cindex staff group
@cindex staff, choir
@cindex staff, piano
+@cindex staff, grand
@cindex system
Various contexts exist to group single staves together in order to
@lilypond[verbatim,quote,relative=2]
\new PianoStaff <<
- \set PianoStaff.instrumentName = "Piano"
+ \set PianoStaff.instrumentName = #"Piano"
\new Staff { c1 c }
\new Staff { c1 c }
>>
@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{mensurstriche-layout-bar-lines-between-the-staves.ly}
-@c FIXME: move to NR 2.8.x when sectioning is ready
@seealso
-
Music Glossary:
@rglos{brace},
@rglos{bracket},
@cindex nested staff brackets
@cindex brackets, nesting of
@cindex braces, nesting of
-@cindex inner staff group
-@cindex inner choir staff group
-
-Two additional staff-group contexts are available that can be
-nested within a @code{StaffGroup} or @code{ChoirStaff} context:
-@code{InnerStaffGroup} and @code{InnerChoirStaff}. These contexts
-create a new bracket adjacent to the bracket of their parent staff
-group.
-An @code{InnerStaffGroup} is treated similarly to a
-@code{StaffGroup}; bar lines are connected between each staff
-within the context:
+Staff-group contexts can be nested to arbitrary depths. In this
+case, each child context creates a new bracket adjacent to the
+bracket of its parent group.
@lilypond[verbatim,quote,relative=2]
\new StaffGroup <<
\new Staff { c2 c | c2 c }
- \new InnerStaffGroup <<
- \new Staff { g2 g | g2 g }
- \new Staff { e2 e | e2 e }
- >>
->>
-@end lilypond
-
-Bar lines are @emph{not} connected between staves of an
-@code{InnerChoirStaff}, just like a @code{ChoirStaff}:
-
-@lilypond[verbatim,quote,relative=2]
-\new ChoirStaff <<
- \new Staff { c2 c | c2 c }
- \new InnerChoirStaff <<
+ \new StaffGroup <<
\new Staff { g2 g | g2 g }
- \new Staff { e2 e | e2 e }
+ \new StaffGroup \with {
+ systemStartDelimiter = #'SystemStartSquare
+ }
+ <<
+ \new Staff { e2 e | e2 e }
+ \new Staff { c2 c | c2 c }
+ >>
>>
- \new Staff { c1 | c1 }
>>
@end lilypond
@seealso
-
Notation Reference:
@ref{Grouping staves},
@ref{Instrument names},
@rlsr{Staff notation}.
Internals Reference:
-@rinternals{InnerStaffGroup},
@rinternals{StaffGroup},
-@rinternals{InnerChoirStaff},
@rinternals{ChoirStaff},
@rinternals{SystemStartBar},
@rinternals{SystemStartBrace},
@cindex adjusting staff symbol
@cindex drawing staff symbol
@cindex staff symbol, setting of
+@cindex staff symbol, drawing
@cindex stop staff lines
@cindex start staff lines
@cindex staff lines, amount of
appearance of a staff, but they must be modified before the staff
is created.
-@c FIXME most of this section should be moved to NR 5.3 or moved to LSR -td
-
The number of staff lines may be changed. The clef position and
the position of middle C may need to be modified to fit the new
staff. For an explanation, refer to the snippet section in
{ d4 d d d }
@end lilypond
-The vertical position of staff lines and the number of staff lines
-can be defined at the same time. As the following example shows,
-note positions are not influenced by the staff line positions.
-
-@warning{The @code{'line-positions} property overrides the
-@code{'line-count} property. The number of staff lines is
-implicitly defined by the number of elements in the list of values
-for @code{'line-positions}.}
-
-@lilypond[verbatim,quote,relative=1]
-\new Staff \with {
- \override StaffSymbol #'line-positions = #'(7 3 0 -4 -6 -7)
-}
-{ a4 e' f b | d1 }
-@end lilypond
-
Staff line thickness can be modified. The thickness of ledger
lines and stems are also affected, since they depend on staff line
thickness.
@end lilypond
Ledger line thickness can be set independently of staff line
-thickness.
+thickness. In the example the two numbers are factors multiplying
+the staff line thickness and the staff line spacing. The two
+contributions are added to give the ledger line thickness.
@lilypond[verbatim,quote,relative=1]
\new Staff \with {
{ a4 b c d }
@end lilypond
-The width of a staff can be modified. The units are staff
-spaces. The spacing of objects inside the staff is not affected by
-this setting.
-
-@lilypond[verbatim,quote,relative=1]
-\new Staff \with {
- \override StaffSymbol #'width = #23
-}
-{ a4 e' f b | d1 }
-@end lilypond
-
Further details about the properties of @code{StaffSymbol} can be
found in @rinternals{staff-symbol-interface}.
+@cindex stopping a staff
+@cindex starting a staff
+@cindex staff, starting
+@cindex staff, stopping
+
@funindex \startStaff
+@funindex startStaff
@funindex \stopStaff
+@funindex stopStaff
Modifications to staff properties in the middle of a score can be
placed between @code{\stopStaff} and @code{\startStaff}:
a2 a
@end lilypond
-@cindex stopping a staff
-
@noindent
In general, @code{\startStaff} and @code{\stopStaff} can be used
to stop or start a staff in the middle of a score.
@predefined
-
@code{\startStaff},
@code{\stopStaff}.
+@endpredefined
@snippets
@seealso
-
Music Glossary:
@rglos{line},
@rglos{ledger line},
@cindex staff, resizing of
@cindex resizing of staves
+@funindex \startStaff
+@funindex startStaff
+@funindex \stopStaff
+@funindex stopStaff
+
@notation{Ossia} staves can be set by creating a new simultaneous
staff in the appropriate location:
@end lilypond
@noindent
-However, the above example is usually not the desired result. To
+However, the above example is not what is usually desired. To
create ossia staves that are above the original staff, have no
time signature or clef, and have a smaller font size, tweaks must
be used. The Learning Manual describes a specific technique to
@seealso
-
Music Glossary:
@rglos{ossia},
@rglos{staff},
@cindex hiding of staves
@cindex empty staves
+@funindex \RemoveEmptyStaffContext
+@funindex RemoveEmptyStaffContext
+
+
Staff lines can be hidden by removing the
@code{Staff_symbol_engraver} from the @code{Staff} context. As an
alternative, @code{\stopStaff} may be used.
\relative c''' { a8 f e16 d c b a2 }
@end lilypond
-@funindex \RemoveEmptyStaffContext
Empty staves can be hidden by setting the
@code{\RemoveEmptyStaffContext} command in the @code{\layout}
Score}. By default, this command hides and removes all empty
staves in a score except for those in the first system.
-@warning{An empty staff may only include multi-measure rests,
-skips, spacer rests, or a combination of these elements.}
+@warning{A staff is considered empty when it contains only
+multi-measure rests, skips, spacer rests, or a combination of these
+elements.}
@lilypond[verbatim,quote,ragged-right]
\layout {
@cindex hiding ancient staves
@cindex hiding rhythmic staves
+
+@funindex \RemoveEmptyStaffContext
+@funindex RemoveEmptyStaffContext
@funindex \AncientRemoveEmptyStaffContext
+@funindex AncientRemoveEmptyStaffContext
@funindex \RemoveEmptyRhythmicStaffContext
+@funindex RemoveEmptyRhythmicStaffContext
The @code{\AncientRemoveEmptyStaffContext} command may be used to
hide empty staves in ancient music contexts. Similarly,
@predefined
-
@code{\RemoveEmptyStaffContext},
@code{\AncientRemoveEmptyStaffContext},
@code{\RemoveEmptyRhythmicStaffContext}.
+@endpredefined
@snippets
@seealso
-
Music Glossary:
@rglos{Frenched staff}.
@cindex beats per minute
@cindex metronome marking
@cindex metronome marking with text
+
@funindex \tempo
+@funindex tempo
A basic metronome mark is simple to write:
@seealso
-
Music Glossary:
@rglos{metronome},
@rglos{metronomic indication},
of @code{shortInstrumentName} is used for all succeeding staves.
@lilypond[verbatim,quote,ragged-right,relative=1]
-\set Staff.instrumentName = "Violin "
-\set Staff.shortInstrumentName = "Vln "
+\set Staff.instrumentName = #"Violin "
+\set Staff.shortInstrumentName = #"Vln "
c4.. g'16 c4.. g'16
\break
c1
@lilypond[verbatim,quote,indent=1.5\cm,relative=2]
<<
\new Staff {
- \set Staff.instrumentName = "Flute"
+ \set Staff.instrumentName = #"Flute"
f2 g4 f
}
\new Staff {
>>
@end lilypond
-@cindex indent
-@cindex short-indent
+@funindex indent
+@funindex short-indent
However, if the instrument names are longer, the instrument names
in a staff group may not be centered unless the @code{indent} and
\relative c'' <<
\new Staff {
- \set Staff.instrumentName = "Alto Flute in G"
- \set Staff.shortInstrumentName = "Fl."
+ \set Staff.instrumentName = #"Alto Flute in G"
+ \set Staff.shortInstrumentName = #"Fl."
f2 g4 f \break
g4 f g2
}
\new Staff {
- \set Staff.instrumentName = "Clarinet"
- \set Staff.shortInstrumentName = "Clar."
+ \set Staff.instrumentName = #"Clarinet"
+ \set Staff.shortInstrumentName = #"Clar."
c,4 b c2 \break
c2 b4 c
}
For details, see @ref{Modifying context plug-ins}.
@cindex instrument names, changing
+@cindex changing instrument names
Instrument names may be changed in the middle of a piece:
@lilypond[verbatim,quote,ragged-right,relative=1]
-\set Staff.instrumentName = "First"
-\set Staff.shortInstrumentName = "one"
+\set Staff.instrumentName = #"First"
+\set Staff.shortInstrumentName = #"one"
c1 c c c \break
c1 c c c \break
-\set Staff.instrumentName = "Second"
-\set Staff.shortInstrumentName = "two"
+\set Staff.instrumentName = #"Second"
+\set Staff.shortInstrumentName = #"two"
c1 c c c \break
c1 c c c \break
@end lilypond
@cindex instrument switch
@cindex switching instruments
+@funindex \addInstrumentDefinition
+@funindex addInstrumentDefinition
+@funindex \instrumentSwitch
+@funindex instrumentSwitch
+
If an instrument @emph{switch} is needed,
@code{\addInstrumentDefinition} may be used in combination with
@code{\instrumentSwitch} to create a detailed list of the
(midiInstrument . "bassoon"))
\new Staff \with {
- instrumentName = "Bassoon"
+ instrumentName = #"Bassoon"
}
\relative c' {
\clef tenor
@seealso
-
Notation Reference:
@ref{Horizontal dimensions},
@ref{Modifying context plug-ins}.
@cindex fragments
@cindex cue notes
-It is very common for one voice to double the some of the music from
-another voice. For example, the first and second violins may play the
-same notes during a passage of music. In LilyPond this is accomplished
+@funindex \addQuote
+@funindex addQuote
+@funindex \quoteDuring
+@funindex quoteDuring
+@funindex \transposition
+@funindex transposition
+
+It is very common for one voice to double some of the music from
+another voice. For example, the first and second violins may play the
+same notes during a passage of music. In LilyPond this is accomplished
by letting one voice @emph{quote} the other voice without having to
re-enter it.
-
-Before a part can be quoted, the @code{\addQuote} command must be used
-to initialize the quoted fragment. This command must be used in the
-toplevel scope. The first argument is an identifying string, and the
-second is a music expression:
+
+Before a part can be quoted, the @code{\addQuote} command must be used
+to initialize the quoted fragment. This command must be used in the
+toplevel scope. The first argument is an identifying string, and the
+second is a music expression:
@example
flute = \relative c'' @{
@seealso
-
Notation Reference:
@ref{Instrument transpositions},
@ref{Using tags}.
@cindex quoting other voices
@cindex cues, formatting
+@funindex \cueDuring
+@funindex cueDuring
+
The previous section explains how to create quotations. The
@code{\cueDuring} command is a more specialized form of
@code{\quoteDuring}, being particularly useful for inserting cue
>>
@end lilypond
+@cindex removing cues
+@cindex removing cue notes
+@cindex cue notes, removing
+
+@funindex \killCues
+@funindex killCues
+@funindex \transposedCueDuring
+@funindex transposedCueDuring
+
In addition to printing the name of the cued instrument, when cue
notes end, the name of the original instrument should be printed,
and any other changes introduced by the cued part should be
@seealso
-
Notation Reference:
@ref{Instrument transpositions},
@ref{Instrument names},