version that you are working on. See TRANSLATION for details.
@end ignore
-@c \version "2.11.38"
+@c \version "2.11.61"
-@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
+many-stringed instruments.
@menu
* References for keyboards::
@end menu
@node References for keyboards
-@subsubsection 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 harps and other keyed instruments.
+notation is also used for other keyed instruments.
Organ music is normally written with two staves inside a
@code{PianoStaff} group and third, normal staff for the pedals.
The staves in keyboard music are largely independent, but
-sometimes voices can cross between the two staves. In this
-section we discuss some notation techniques particular to keyboard
+sometimes voices can cross between the two staves. This
+section discusses notation techniques particular to keyboard
music.
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}.
@item Vertical grid lines can be shown with @ref{Grid lines}.
@item Keyboard music often contains @notation{Laissez vibrer} ties
-as well as ties on arpeggios and tremelos, described in
+as well as ties on arpeggios and tremolos, described in
@ref{Ties}.
@item Placing arpeggios across multiple voices and staves is
Notation Reference:
@ref{Grouping staves},
@ref{Instrument names},
+@ref{Collision resolution},
@ref{Writing music in parallel},
@ref{Fingering instructions},
+@ref{List of articulations},
@ref{Grid lines},
@ref{Ties},
@ref{Arpeggio},
-@ref{Tremolo repeats},
-@ref{List of articulations}.
+@ref{Tremolo repeats}.
Internals Reference:
@rinternals{PianoStaff}.
@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
objects}.
@node Changing staff manually
-@subsubsection Changing staff manually
+@unnumberedsubsubsec Changing staff manually
@cindex changing staff manually
@cindex manual staff changes
@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
@noindent
The string @var{staffname} is the name of the staff. It switches
-the current voice from its current staff to the Staff called
+the current voice from its current staff to the staff called
@var{staffname}. Typical values for @var{staffname} are
@code{"up"} and @code{"down"}, or @code{"RH"} and @code{"LH"}.
Cross-staff notes are beamed automatically:
-@lilypond[verbatim,quote,ragged-right]
+@lilypond[verbatim,quote]
\new PianoStaff <<
\new Staff = "up" {
<e' c'>8
- \change Staff = down
- g fis g
- \change Staff = up
+ \change Staff = "down"
+ g8 fis g
+ \change Staff = "up"
<g'' c''>8
- \change Staff = down
- e dis e
- \change Staff = up
+ \change Staff = "down"
+ e8 dis e
+ \change Staff = "up"
}
\new Staff = "down" {
\clef bass
- s1 % keep staff alive
+ % keep staff alive
+ s1
}
>>
@end lilypond
@rlearning{Fixing overlapping notation}.
Notation Reference:
-@ruser{Stems},
-@ruser{Automatic beams}.
+@ref{Stems},
+@ref{Automatic beams}.
Snippets:
@rlsr{Keyboards}.
Internals Reference:
-@rinternals{Beam}.
+@rinternals{Beam},
+@rinternals{ContextChange}.
@node Changing staff automatically
-@subsubsection Changing staff automatically
+@unnumberedsubsubsec Changing staff automatically
@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
@noindent
This will create two staves inside the current staff group
(usually a @code{PianoStaff}), called @code{"up"} and
-@code{"down"}. The lower staff will be in bass clef by default.
-The autochanger switches on basis of the pitch (middle C is the
+@code{"down"}. The lower staff will be in the bass clef by default.
+The autochanger switches on the basis of the pitch (middle@tie{}C is the
turning point), and it looks ahead skipping over rests to switch
in advance.
-@lilypond[quote,verbatim,ragged-right]
+@lilypond[quote,verbatim]
\new PianoStaff {
\autochange {
- g4 a b c' d' r4 a g
+ g4 a b c'
+ d'4 r a g
}
}
@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}.
its voice between the existing staves. For example, this is
necessary to place a key signature in the lower staff:
-@lilypond[quote,verbatim,ragged-right]
+@lilypond[quote,verbatim]
\new PianoStaff <<
\new Staff = "up" {
\new Voice = "melOne" {
\key g \major
\autochange \relative c' {
g8 b a c b d c e
- d r fis, g a2
+ d8 r fis, g a2
}
}
}
@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.
staff based on the first note named in the chord construct.
@node Staff-change lines
-@subsubsection Staff-change lines
-
-@cindex staff-change lines
-@cindex cross-staff lines
-@cindex lines, staff-change follower
+@unnumberedsubsubsec Staff-change lines
+
+@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:
-@lilypond[quote,ragged-right,fragment,relative=1,verbatim]
+@lilypond[quote,verbatim,relative=1]
\new PianoStaff <<
\new Staff = "one" {
\showStaffSwitch
c1
- \change Staff=two
+ \change Staff = "two"
b2 a
}
- \new Staff = "two" { \clef bass s1*2 }
+ \new Staff = "two" {
+ \clef bass
+ s1*2
+ }
>>
@end lilypond
@predefined
-@funindex \showStaffSwitch
-@funindex \hideStaffSwitch
@code{\showStaffSwitch}, @code{\hideStaffSwitch}.
@seealso
@rlsr{Keyboards}.
Internals Reference:
+@rinternals{Note_head_line_engraver},
@rinternals{VoiceFollower}.
@node Cross-staff stems
-@subsubsection Cross-staff stems
+@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
-Chords that cross staves may be produced by increasing the length
-of the stem in the lower staff, so it reaches the stem in the upper
-staff, or vice versa.
+@funindex Stem
+@funindex cross-staff
+@funindex length
+@funindex flag-style
-@lilypond[ragged-right,verbatim,quote]
+Chords that cross staves may be produced:
+
+@lilypond[verbatim,quote]
\new PianoStaff <<
- \new Staff \relative c' {
- f8 e4 d8 <f bes,>2
+ \new Staff {
+ \relative c' {
+ f8 e4 d8 d f e4
+ }
}
- \new Staff \relative c' {
- << {
- \clef bass
- \stemUp
- \override Stem #'length = #12
- \override Stem #'cross-staff = ##t
- \override Stem #'flag-style = #'no-flag
- a8 g4 f8
- } \\
- { f,2 d' }
- >>
+ \new Staff {
+ \relative c' {
+ << {
+ \clef bass
+ % stems may overlap the other staff
+ \override Stem #'cross-staff = ##t
+ % extend the stems to reach other other staff
+ \override Stem #'length = #12
+ % do not print extra flags
+ \override Stem #'flag-style = #'no-flag
+ % prevent beaming as needed
+ a8 g4 f8 f bes\noBeam g4
+ }
+ \\
+ {
+ f,2 bes4 c
+ } >>
+ }
}
>>
@end lilypond
@snippets
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{indicating-cross-staff-chords-with-arpeggio-bracket.ly}
@seealso
@rlsr{Keyboards}.
Internals Reference:
-@rinternals{Stem}
+@rinternals{Stem}.
@node Piano
@subsection Piano
@end menu
@node Piano pedals
-@subsubsection Piano pedals
+@unnumberedsubsubsec Piano pedals
+
@cindex piano pedals
@cindex pedals, piano
@cindex sustain pedal
+@cindex pedal, sustain
@cindex sostenuto pedal
-@cindex una corde
+@cindex pedal, sostenuto
+@cindex una corda
@cindex tre corde
-@funindex \sustainDown
-@funindex \sustainUp
-@funindex \sostenutoDown
-@funindex \sostenutoUp
+@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}
-(@notation{sos.}), and @notation{una corde} (@notation{U.C.}).
+(@notation{sos.}), and @notation{una corda} (@notation{U.C.}).
Sustain pedals are also found on vibraphones and celestas.
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c4\sustainDown d e g
-<c, f a>1\sustainUp
-c4\sostenutoDown e g c,
-<bes d f>1\sostenutoUp
+@lilypond[quote,verbatim,relative=2]
+c4\sustainOn d e g
+<c, f a>1\sustainOff
+c4\sostenutoOn e g c,
+<bes d f>1\sostenutoOff
c4\unaCorda d e g
<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.
-@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
-c4\sustainDown g c2\sustainUp
+@lilypond[quote,verbatim,relative=2]
+c4\sustainOn g c2\sustainOff
\set Staff.pedalSustainStyle = #'mixed
-c4\sustainDown g c d
-d\sustainUp\sustainDown g, c2\sustainUp
+c4\sustainOn g c d
+d\sustainOff\sustainOn g, c2\sustainOff
\set Staff.pedalSustainStyle = #'bracket
-c4\sustainDown g c d
-d\sustainUp\sustainDown g, c2
+c4\sustainOn g c d
+d\sustainOff\sustainOn g, c2
\bar "|."
@end lilypond
Internals Reference:
@rinternals{SustainPedal},
@rinternals{SustainPedalLineSpanner},
+@rinternals{SustainEvent},
@rinternals{SostenutoPedal},
@rinternals{SostenutoPedalLineSpanner},
+@rinternals{SostenutoEvent},
@rinternals{UnaCordaPedal},
@rinternals{UnaCordaPedalLineSpanner},
+@rinternals{UnaCordaEvent},
@rinternals{PianoPedalBracket},
@rinternals{Piano_pedal_engraver}.
@node Accordion
@subsection Accordion
+@cindex accordion
+
This section discusses notation that is unique to the accordion.
@menu
@end menu
@node Discant symbols
-@subsubsection 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.
@snippets
-@c This snippet should work once it's been tagged for the docs.
-@c @lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
-@c {accordion-discant-symbols.ly}
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{accordion-discant-symbols.ly}
@seealso
Snippets:
@rlsr{Keyboards}.
+
+
+@node Harp
+@subsection Harp
+
+TBC
+
+@ignore
+Some possibilities:
+- glissandi
+- tremolo (for bisbigliando)
+- natural harmonics
+- directional arpeggio and non-arpeggio
+- workaroung for keeping both staves visible in an orchestral
+ score,
+http://lists.gnu.org/archive/html/lilypond-user/2007-08/msg00386.html
+and http://lsr.dsi.unimi.it/LSR/Item?u=1&id=312
+
+An LSR snippet could be used to demonstrate the main items; in the
+case of glissandi, it would be desirable to have a demonstration
+of different styles.
+
+@end ignore
+
projects / lilypond.git / blobdiff