lines are drawn using a separate layout object called @code{staff
symbol}.
-Two or more staves can be grouped vertically in a
-@internalsref{GrandStaff}, a @internalsref{StaffGroup}, or a
-@internalsref{ChoirStaff}.
+Two or more staves can be grouped vertically in a @code{GrandStaff}, a
+@code{StaffGroup}, or a @code{ChoirStaff}.
@menu
@itemize
@item
-In a @internalsref{GrandStaff}, the group is started with a brace
+In a @code{GrandStaff}, the group is started with a brace
at the left, and bar lines are connected between the staves.
@lilypond[verbatim,ragged-right,quote]
@end lilypond
@item
-In a @internalsref{StaffGroup}, the bar lines will be drawn through
+In a @code{StaffGroup}, the bar lines will be drawn through
all the staves, but the group is started with a bracket.
@lilypond[verbatim,ragged-right,quote]
@end lilypond
@item
-In a @internalsref{ChoirStaff}, the group is started with a
+In a @code{ChoirStaff}, the group is started with a
bracket, but bar lines are not connected.
@lilypond[verbatim,ragged-right,quote]
@commonprop
More complex nesting can be accomplished using the property
-@internalsref{systemStartDelimiterHierarchy}:
+@code{systemStartDelimiterHierarchy}:
@lilypond[quote,ragged-right,verbatim]
\new StaffGroup
@seealso
Music Glossary: @rglos{brace}, @rglos{staff}, @rglos{staves}
-@c FIXME add @rglos{bracket}
+@rglos{bracket}.
Snippets: @lsrdir{staff}
@seealso
-Music Glossary: @rglos{ossia}, @rglos{staff},
-@c FIXME: add @rglos{Frenched staff}
+Music Glossary: @rglos{ossia}, @rglos{staff}, @rglos{Frenched staff}.
Snippets: @lsrdir{staff}
@unnumberedsubsubsec Hiding staves
@cindex Frenched scores
-@cindex staves, hiding
+@cindex staves, hiding
+@cindex staves, empty
In orchestral scores, staff lines that only have rests are usually
removed; this saves some space. This style is called @q{French
-Score}. For @internalsref{Lyrics}, @internalsref{ChordNames} and
-@internalsref{FiguredBass}, this is switched on by default. When
+Score}. For @code{Lyrics}, @code{ChordNames} and
+@code{FiguredBass}, this is switched on by default. When
the lines of these contexts turn out empty after the line-breaking
process, they are removed.
-For normal staves, a specialized @internalsref{Staff} context is
+For normal staves, a specialized @code{Staff} context is
available, which does the same: staves containing nothing (or only
multi-measure rests) are removed. The context definition is
stored in @code{\RemoveEmptyStaffContext} variable. Observe how
The first system shows all staves in full. If empty staves should
be removed from the first system too, set @code{remove-first} to
-true in @internalsref{VerticalAxisGroup}.
+true in @code{VerticalAxisGroup}.
@example
\override Score.VerticalAxisGroup #'remove-first = ##t
@code{\AncientRemoveEmptyStaffContext} or
@code{\RemoveEmptyRhythmicStaffContext}.
+@cindex ossia
+
Another application of the @code{\RemoveEmptyStaffContext} is to
make ossia sections, i.e., alternative melodies on a separate
piece of staff, with help of a Frenched staff. See @ref{Staff
@seealso
+Notation Reference: @ref{Staff symbol}.
+
Snippets: @lsrdir{staff}
+Internals Reference: @internalsref{ChordNames},
+@internalsref{FiguredBass}, @internalsref{Lyrics},
+@internalsref{Staff}, @internalsref{VerticalAxisGroup}.
+
@node Writing parts
@subsection Writing parts
@seealso
+Music Glossary: @rglos{metronome}, @rglos{metronomic indication},
+@rglos{tempo indication}.
+@c FIXME : add @rglos{Mälzels Metronome}, @rglos{M.M.}, @rglos{tempo}?
+
+Notation Reference: @ref{Text markup}.
+
+Snippets: @lsrdir{staff}.
+
Internals Reference: @internalsref{MetronomeMark}, @ref{MIDI
output}.
@c perhaps also an example of how to move it horizontally?
-@seealso
-
-Snippets: @lsrdir{staff}
@node Instrument names
@unnumberedsubsubsec Instrument names
+@cindex instrument names
+@cindex instrument names, short
+
In an orchestral score, instrument names are printed at the left
side of the staves.
-This can be achieved by setting
-@internalsref{Staff}.@code{instrumentName} and
-@internalsref{Staff}.@code{shortInstrumentName}, or
-@internalsref{PianoStaff}.@code{instrumentName} and
-@internalsref{PianoStaff}.@code{shortInstrumentName}. This will
-print text before the start of the staff. For the first staff,
-@code{instrumentName} is used. If set, @code{shortInstrumentName}
-is used for the following staves.
+This can be achieved by setting @code{Staff}.@code{instrumentName} and
+@code{Staff}.@code{shortInstrumentName}, or
+@code{PianoStaff}.@code{instrumentName} and
+@code{PianoStaff}.@code{shortInstrumentName}. This will print text
+before the start of the staff. For the first staff,
+@code{instrumentName} is used. If set, @code{shortInstrumentName} is
+used for the following staves.
@lilypond[quote,verbatim,ragged-right,relative=1,fragment]
\set Staff.instrumentName = "Ploink "
c''1
@end lilypond
+@cindex instrument names, centering
+
If you wish to center the instrument names, you must center all of
them individually:
More information about adding and removing engravers can be found
in @ref{Modifying context plug-ins}.
+@cindex instrument names, changing
+
Instrument names may be changed in the middle of a piece,
@lilypond[quote,fragment,verbatim,ragged-right]
@seealso
+Notation Reference: @ref{Modifying context plug-ins}.
+
Snippets: @lsrdir{staff}
-Internals Reference: @internalsref{InstrumentName}.
+Internals Reference: @internalsref{InstrumentName},
+@internalsref{PianoStaff}, @internalsref{Staff}.
@node Quoting other voices
@unnumberedsubsubsec Quoting other voices
@cindex cues
+@cindex quoting other voices
+@cindex fragments
With quotations, fragments of other parts can be inserted into a
part directly. Before a part can be quoted, it must be marked
@refbugs
-Only the contents of the first @internalsref{Voice} occurring in
-an @code{\addQuote} command will be considered for quotation, so
+Only the contents of the first @code{Voice} occurring in an
+@code{\addQuote} command will be considered for quotation, so
@var{music} can not contain @code{\new} and @code{\context Voice}
statements that would switch to a different Voice.
Snippets: @lsrdir{staff}
-Internals Reference: @internalsref{QuoteMusic}.
+Internals Reference: @internalsref{QuoteMusic}, @internalsref{Voice}.
@node Formatting cue notes
projects / lilypond.git / blobdiff