version that you are working on. See TRANSLATION for details.
@end ignore
-@c \version "2.11.51"
+@c \version "2.12.0"
-@node Keyboard instruments
-@section Keyboard instruments
+@node Keyboard and other multi-staff instruments
+@section Keyboard and other multi-staff instruments
@lilypondfile[quote]{keyboard-headword.ly}
-This section discusses several aspects of music notation that are unique
-to keyboard instruments.
+This section discusses several aspects of music notation that are
+unique to keyboard instruments and other instruments notated on
+many staves, such as harps and vibraphones. For the purposes of
+this section this entire group of multi-staff instruments is called
+@qq{keyboards} for short, even though some of them do not have a
+keyboard.
@menu
* Common notation for keyboards::
* Piano::
* Accordion::
+* Harp::
@end menu
@node Common notation for keyboards
@subsection Common notation for keyboards
-This section discusses notation issues that may arise for most keyboard
-instruments.
+This section discusses notation issues that may arise for most
+keyboard instruments.
@menu
* References for keyboards::
@node References for keyboards
@unnumberedsubsubsec References for keyboards
+@cindex piano staves
+@cindex staves, piano
+@cindex staves, keyboard instruments
+@cindex staves, keyed instruments
+@cindex keyboard instrument staves
+@cindex keyed instrument staves
+
+@funindex PianoStaff
+
Keyboard instruments are usually notated with Piano staves. These
are two or more normal staves coupled with a brace. The same
notation is also used for other keyed instruments.
Several common issues in keyboard music are covered elsewhere:
@itemize
+
@item Keyboard music usually contains multiple voices and the
number of voices may change regularly; this is described in
@ref{Collision resolution}.
@end itemize
-@seealso
+@c @snippets
+@c @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@c {forcing-visibility-of-systems-with-multi-bar-rests-when-using-\RemoveEmptyStaffContext.ly}
+@c http://lsr.dsi.unimi.it/LSR/Item?u=1&id=312
+@seealso
Learning Manual:
@rlearning{Real music example},
@rlearning{Other uses for tweaks}.
Snippets:
@rlsr{Keyboards}.
+
@knownissues
+@cindex keyboard music, centering dynamics
+@cindex dynamics, centered in keyboard music
+@cindex piano music, centering dynamics
+@cindex centered dynamics in piano music
+@funindex staff-padding
+
Dynamics are not automatically centered, but workarounds do exist. One
option is the @q{piano centered dynamics} template under
@rlearning{Piano templates}; another option is to increase the
@cindex notes, cross-staff
@cindex cross-staff beams
@cindex beams, cross-staff
+
@funindex \change
+@funindex change
Voices can be switched between staves manually, using the command
@var{staffname}. Typical values for @var{staffname} are
@code{"up"} and @code{"down"}, or @code{"RH"} and @code{"LH"}.
+The staff to which the voice is being switched must exist at the
+time of the switch. If necessary, staves should be @qq{kept alive},
+see @ref{Keeping contexts alive}.
+
Cross-staff notes are beamed automatically:
@lilypond[verbatim,quote]
example of beam tweaking, see @rlearning{Fixing overlapping
notation}.
-@seealso
+@seealso
Learning Manual:
@rlearning{Fixing overlapping notation}.
Notation Reference:
-@ruser{Stems},
-@ruser{Automatic beams}.
+@ref{Stems},
+@ref{Automatic beams},
+@ref{Keeping contexts alive}.
Snippets:
@rlsr{Keyboards}.
@cindex changing staff automatically
@cindex automatic staff changes
@cindex staff changes, automatic
+
@funindex \autochange
+@funindex autochange
+@funindex PianoStaff
Voices can be made to switch automatically between the top and the
bottom staff. The syntax for this is
}
@end lilypond
+@cindex relative music and autochange
+@cindex autochange and relative music
+
+@funindex \relative
+@funindex relative
+
A @code{\relative} section that is outside of @code{\autochange}
has no effect on the pitches of the music, so if necessary, put
@code{\relative} inside @code{\autochange}.
If additional control is needed over the individual staves, they
can be created manually with the names @code{"up"} and
@code{"down"}. The @code{\autochange} command will then switch
-its voice between the existing staves. For example, this is
-necessary to place a key signature in the lower staff:
+its voice between the existing staves.
+
+@warning{If staves are created manually, they @emph{must} be named
+@code{"up"} and @code{"down"}.}
+
+For example, staves must be created manually in order to place a
+key signature in the lower staff:
@lilypond[quote,verbatim]
\new PianoStaff <<
>>
@end lilypond
-@seealso
+@seealso
Notation Reference:
@ref{Changing staff manually}.
Internals Reference:
@rinternals{AutoChangeMusic}.
+
@knownissues
+@cindex chords, splitting across staves with \autochange
+
The staff switches may not end up in optimal places. For high
quality output, staff switches should be specified manually.
@node Staff-change lines
@unnumberedsubsubsec Staff-change lines
-@cindex staff-change lines
-@cindex cross-staff lines
-@cindex lines, staff-change follower
+@cindex staff-change line
+@cindex staff change line
+@cindex cross-staff line
+@cindex cross staff line
+@cindex line, staff-change follower
+@cindex line, cross-staff
+@cindex line, staff-change
@cindex follow voice
+@cindex voice, following
@cindex staff switching
@cindex cross-staff
+
@funindex followVoice
+@funindex \showStaffSwitch
+@funindex showStaffSwitch
+@funindex \hideStaffSwitch
+@funindex hideStaffSwitch
Whenever a voice switches to another staff, a line connecting the
notes can be printed automatically:
>>
@end lilypond
+
@predefined
+@code{\showStaffSwitch},
+@code{\hideStaffSwitch}.
+@endpredefined
-@funindex \showStaffSwitch
-@funindex \hideStaffSwitch
-@code{\showStaffSwitch}, @code{\hideStaffSwitch}.
@seealso
-
Snippets:
@rlsr{Keyboards}.
@unnumberedsubsubsec Cross-staff stems
@cindex cross-staff notes
+@cindex cross staff notes
@cindex notes, cross-staff
@cindex cross-staff stems
+@cindex cross staff stems
@cindex stems, cross-staff
+@cindex chords, cross-staff
+@cindex cross-staff chords
+@cindex cross staff chords
+
+@funindex Stem
+@funindex cross-staff
+@funindex length
+@funindex flag-style
Chords that cross staves may be produced:
\new PianoStaff <<
\new Staff {
\relative c' {
- f8 e4 d8 <f bes,>2
+ f8 e4 d8 d f e4
}
}
\new Staff {
\override Stem #'length = #12
% do not print extra flags
\override Stem #'flag-style = #'no-flag
- a8 g4 f8
+ % prevent beaming as needed
+ a8 g4 f8 f bes\noBeam g4
}
\\
{
- f,2 d'
+ f,2 bes4 c
} >>
}
}
@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{indicating-cross-staff-chords-with-arpeggio-bracket.ly}
-@seealso
+@seealso
Snippets:
@rlsr{Keyboards}.
Internals Reference:
@rinternals{Stem}.
+
@node Piano
@subsection Piano
@node Piano pedals
@unnumberedsubsubsec Piano pedals
+
@cindex piano pedals
@cindex pedals, piano
@cindex sustain pedal
+@cindex pedal, sustain
@cindex sostenuto pedal
+@cindex pedal, sostenuto
@cindex una corda
@cindex tre corde
+@cindex sos.
+@cindex U.C.
+
@funindex \sustainOn
+@funindex sustainOn
@funindex \sustainOff
+@funindex sustainOff
@funindex \sostenutoOn
+@funindex sostenutoOn
@funindex \sostenutoOff
+@funindex sostenutoOff
@funindex \unaCorda
+@funindex unaCorda
@funindex \treCorde
+@funindex treCorde
Pianos generally have three pedals that alter the way sound is
produced: @notation{sustain}, @notation{sostenuto}
<d fis a>1\treCorde
@end lilypond
+@cindex pedal indication styles
+@cindex pedal indication, text
+@cindex pedal indication, bracket
+@cindex pedal indication, mixed
+@cindex pedal sustain style
+@cindex sustain pedal style
+
+@funindex pedalSustainStyle
+@funindex mixed
+@funindex bracket
+@funindex text
+
There are three styles of pedal indications: text, bracket, and mixed.
The sustain pedal and the una corda pedal use the text style by default
while the sostenuto pedal uses mixed by default.
The placement of the pedal commands matches the physical movement of the
sustain pedal during piano performance. Pedalling to the final bar line
-is indicated by omitting the final pedal up command.
+is indicated by omitting the final pedal off command.
-@seealso
+@seealso
Notation Reference:
@ref{Ties}.
@rinternals{PianoPedalBracket},
@rinternals{Piano_pedal_engraver}.
+
@node Accordion
@subsection Accordion
+@cindex accordion
+
This section discusses notation that is unique to the accordion.
@menu
@node Discant symbols
@unnumberedsubsubsec Discant symbols
+
@cindex accordion discant symbols
@cindex discant symbols, accordion
@cindex accordion shifts
+@cindex accordion shift symbols
Accordions are often built with more than one set of reeds that may be
in unison with, an octave above, or an octave below the written pitch.
@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{accordion-discant-symbols.ly}
-@seealso
+@seealso
Snippets:
@rlsr{Keyboards}.
+
+
+@node Harp
+@subsection Harp
+
+This section discusses notation issues that are unique to the harp.
+
+@menu
+* References for harps::
+* Harp pedals::
+@end menu
+
+@node References for harps
+@unnumberedsubsubsec References for harps
+@cindex harps
+@cindex bisbiglando
+
+Some common characteristics of harp music are covered elsewhere:
+
+@itemize
+
+@item The glissando is the most characterisic harp technique,
+@ref{Glissando}.
+
+@item A @notation{bisbigliando} is written as a tremelo @ref{Tremolo
+repeats}
+
+@item Natural harmonics are covered under @ref{Harmonics}.
+
+@item For directional arpeggios and non-arpeggios, see @ref{Arpeggio}.
+
+@end itemize
+
+@seealso
+Notation Reference:
+@ref{Tremolo repeats}
+@ref{Glissando}
+@ref{Arpeggio}
+@ref{Harmonics}
+
+@node Harp pedals
+@unnumberedsubsubsec Harp pedals
+
+@cindex harp pedals
+@cindex harp pedal diagrams
+@cindex pedals, harp
+@cindex pedal diagrams, harp
+
+Harps have seven strings per octave that may be sounded at the natural,
+flattened, or sharpened pitch. In lever harps, each string is adjusted
+individually, but in pedal harps every string with the same pitch name
+is controlled by a single pedal. From the player's left to right, the
+pedals are D, C, and B on the left and E, F, G, and A on the right.
+The position of the pedals may be indicated with text marks:
+
+@lilypond[quote,verbatim,relative=2]
+\textLengthOn
+cis1_\markup \concat \vcenter { [D \flat C \sharp B|E \sharp F \sharp G A \flat] }
+c!1_\markup \concat \vcenter {[ C \natural ]}
+@end lilypond
+
+or pedal diagrams:
+
+@lilypond[quote,verbatim,relative=2]
+\textLengthOn
+cis1_\markup { \harp-pedal #"^v-|vv-^" }
+c!1_\markup { \harp-pedal #"^o--|vv-^" }
+@end lilypond
+
+The @code{\harp-pedal} command accepts a string of characters, where
+@code{^} is the highest pedal position (flattened pitch), @code{-} is
+the middle pedal postion (natural pitch), @code{v} is the lowest pedal
+position (sharpened pitch), and @code{|} is the divider. A prefixed
+@code{o} will circle the following pedal symbol.
+
+@seealso
+Notation Reference:
+@ref{Text scripts}
+@ref{Instrument Specific Markup}