]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/keyboards.itely
Docs: NR 2.2.4 Harp: Minor fixes
[lilypond.git] / Documentation / user / keyboards.itely
index e1db372244d4cbd3451ab3cbfdefbf71b5fa13f5..82b097dca4a24210893b4692a61da434ed3a05af 100644 (file)
@@ -6,27 +6,32 @@
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
-@c \version "2.11.51"
+@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::
@@ -45,6 +50,7 @@ instruments.
 @cindex staves, keyed instruments
 @cindex keyboard instrument staves
 @cindex keyed instrument staves
+
 @funindex PianoStaff
 
 Keyboard instruments are usually notated with Piano staves.  These
@@ -93,8 +99,8 @@ as shown in @rlearning{Other uses for tweaks}.
 
 @end itemize
 
-@seealso
 
+@seealso
 Learning Manual:
 @rlearning{Real music example},
 @rlearning{Other uses for tweaks}.
@@ -117,6 +123,7 @@ Internals Reference:
 Snippets:
 @rlsr{Keyboards}.
 
+
 @knownissues
 
 @cindex keyboard music, centering dynamics
@@ -141,6 +148,7 @@ objects}.
 @cindex notes, cross-staff
 @cindex cross-staff beams
 @cindex beams, cross-staff
+
 @funindex \change
 @funindex change
 
@@ -184,14 +192,14 @@ center of the staff that is closest to the beam.  For a simple
 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}.
 
 Snippets:
 @rlsr{Keyboards}.
@@ -207,6 +215,7 @@ Internals Reference:
 @cindex changing staff automatically
 @cindex automatic staff changes
 @cindex staff changes, automatic
+
 @funindex \autochange
 @funindex autochange
 @funindex PianoStaff
@@ -237,6 +246,7 @@ in advance.
 
 @cindex relative music and autochange
 @cindex autochange and relative music
+
 @funindex \relative
 @funindex relative
 
@@ -268,8 +278,8 @@ necessary to place a key signature in the lower staff:
 >>
 @end lilypond
 
-@seealso
 
+@seealso
 Notation Reference:
 @ref{Changing staff manually}.
 
@@ -279,6 +289,7 @@ Snippets:
 Internals Reference:
 @rinternals{AutoChangeMusic}.
 
+
 @knownissues
 
 @cindex chords, splitting across staves with \autochange
@@ -300,8 +311,10 @@ staff based on the first note named in the chord construct.
 @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
@@ -326,12 +339,14 @@ notes can be printed automatically:
 >>
 @end lilypond
 
+
 @predefined
+@code{\showStaffSwitch},
+@code{\hideStaffSwitch}.
+@endpredefined
 
-@code{\showStaffSwitch}, @code{\hideStaffSwitch}.
 
 @seealso
-
 Snippets:
 @rlsr{Keyboards}.
 
@@ -352,6 +367,7 @@ Internals Reference:
 @cindex chords, cross-staff
 @cindex cross-staff chords
 @cindex cross staff chords
+
 @funindex Stem
 @funindex cross-staff
 @funindex length
@@ -363,7 +379,7 @@ 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 {
@@ -376,11 +392,12 @@ Chords that cross staves may be produced:
         \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
       } >>
     }
   }
@@ -391,14 +408,15 @@ Chords that cross staves may be produced:
 @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
 
@@ -415,11 +433,14 @@ piano.
 @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
@@ -453,6 +474,7 @@ c4\unaCorda d e g
 @cindex pedal indication, mixed
 @cindex pedal sustain style
 @cindex sustain pedal style
+
 @funindex pedalSustainStyle
 @funindex mixed
 @funindex bracket
@@ -477,8 +499,8 @@ 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.
 
-@seealso
 
+@seealso
 Notation Reference:
 @ref{Ties}.
 
@@ -498,6 +520,7 @@ Internals Reference:
 @rinternals{PianoPedalBracket},
 @rinternals{Piano_pedal_engraver}.
 
+
 @node Accordion
 @subsection Accordion
 
@@ -511,6 +534,7 @@ This section discusses notation that is unique to the accordion.
 
 @node Discant symbols
 @unnumberedsubsubsec Discant symbols
+
 @cindex accordion discant symbols
 @cindex discant symbols, accordion
 @cindex accordion shifts
@@ -528,7 +552,76 @@ come into use to simplify the performance instructions.
 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 {accordion-discant-symbols.ly}
 
-@seealso
 
+@seealso
 Snippets:
 @rlsr{Keyboards}.
+
+
+@node Harp
+@subsection Harp
+
+@menu
+* Harp notation::
+* Harp pedals::
+@end menu
+
+@node Harp notation
+@unnumberedsubsubsec Harp notation
+
+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
+
+@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:
+@ruser{Text scripts}