]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/user/pitches.itely
Merge branch 'master' of git://git.sv.gnu.org/lilypond
[lilypond.git] / Documentation / user / pitches.itely
1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @ignore
3    Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
4
5     When revising a translation, copy the HEAD committish of the
6     version that you are working on.  See TRANSLATION for details.
7 @end ignore
8
9
10 @node Pitches
11 @section Pitches
12
13 @lilypondfile[quote]{pitches-headword.ly}
14
15 This section discusses how to specify the pitch of notes.  There
16 are three steps to this process: input, modification, and output.
17
18 @menu
19 * Writing pitches::             
20 * Changing multiple pitches::   
21 * Displaying pitches::          
22 * Note heads::                  
23 @end menu
24
25
26 @node Writing pitches
27 @subsection Writing pitches
28
29 This section discusses how to input pitches.  There are two
30 different ways to place notes in octaves: absolute and relative
31 mode.  In most cases, relative mode will be more convenient.
32
33 @menu
34 * Absolute octave entry::       
35 * Relative octave entry::       
36 * Accidentals::                 
37 * Note names in other languages::  
38 @end menu
39
40
41 @node Absolute octave entry
42 @unnumberedsubsubsec Absolute octave entry
43
44 @cindex pitch names
45 @cindex pitches
46 @cindex absolute
47 @cindex absolute octave specification
48
49 A pitch name is specified using lowercase letters@tie{}@code{a}
50 through@tie{}@code{g}.  The note names @code{c} to @code{b} are
51 engraved in the octave below middle C.
52
53 @c NOTE: don't use c' here.
54 @lilypond[verbatim,quote,ragged-right,fragment]
55 \clef bass
56 c d e f
57 g a b c
58 d e f g
59 @end lilypond
60
61 @funindex '
62 @funindex ,
63
64 Other octaves may be specified with a single quote@tie{}(@code{'})
65 or comma@tie{}(@code{,}) character.  Each@tie{}@code{'} raises the
66 pitch by one octave; each@tie{}@code{,} lowers the pitch by an
67 octave.
68
69 @lilypond[verbatim,quote,ragged-right,fragment]
70 \clef treble
71 c' c'' e' g
72 d'' d' d c
73 \clef bass
74 c, c,, e, g
75 d,, d, d c
76 @end lilypond
77
78 @seealso
79
80 Music Glossary: @rglos{Pitch names}.
81
82 Snippets: @lsrdir{Pitches,Pitches}.
83
84
85 @node Relative octave entry
86 @unnumberedsubsubsec Relative octave entry
87
88 @cindex relative
89 @cindex relative octave specification
90 @funindex \relative
91
92 When octaves are specified in absolute mode it is easy to
93 accidentally put a pitch in the wrong octave.  Relative octave
94 mode reduces these errors since most of the time it is not
95 necessary to indicate any octaves at all.  Furthermore, in
96 absolute mode a single mistake may be difficult to spot, while in
97 relative mode a single error puts the rest of the piece off by one
98 octave.
99
100 @example
101 \relative @var{startpitch} @var{musicexpr}
102 @end example
103
104 In relative mode, each note is assumed to be as close to the
105 previous note as possible.  This means that the octave of pitches
106 in @var{musicexpr} is calculated as follows:
107
108 @itemize
109 @item
110 If no octave changing mark is used on a pitch, its octave is calculated
111 so that the interval with the previous note is less than a fifth.  This
112 interval is determined without considering accidentals.
113
114 @item
115 An octave changing mark@tie{}@code{'} or@tie{}@code{,} can be added to
116 respectively raise or lower a pitch by an extra octave, relative to
117 the pitch calculated without an octave mark.
118
119 @item
120 Multiple octave changing marks can be used.  For example, @code{''}@tie{}and
121 @code{,,}@tie{} will alter the pitch by two octaves.
122
123 @item
124 The pitch of the first note is relative to
125 @code{@var{startpitch}}.  @var{startpitch} is specified in
126 absolute octave mode, and it is recommended that it be a octave of
127 @code{c}.
128
129 @end itemize
130
131 Here is the relative mode shown in action:
132
133 @lilypond[verbatim,quote,ragged-right]
134 \relative c {
135   \clef bass
136   c d e f
137   g a b c
138   d e f g
139 }
140 @end lilypond
141
142 Octave changing marks are used for intervals greater than a
143 fourth:
144
145 @lilypond[verbatim,quote,ragged-right]
146 \relative c'' {
147   c g c f,
148   c' a, e'' c
149 }
150 @end lilypond
151
152 A note sequence without a single octave mark can nevertheless span
153 large intervals:
154
155 @lilypond[verbatim,quote,ragged-right]
156 \relative c {
157   c f b e
158   a d g c
159 }
160 @end lilypond
161
162 If the preceding item is a chord, the first note of the chord is
163 used as the reference point for the octave placement of a
164 following note or chord.  Inside chords, the next note is always
165 relative to the preceding one.
166
167 @lilypond[verbatim,quote,ragged-right]
168 \relative c' {
169   c
170   <c e g>
171   % the C is now an octave higher
172   <c' e g'>
173   % the C returns to the original pitch
174   <c, e, g''>
175 }
176 @end lilypond
177
178 As explained above, the octave of pitches is calculated only with
179 the note names, regardless of any alterations.  Therefore, an
180 E-double-sharp following a B will be placed higher, while an
181 F-double-flat will be placed lower.  In other words, a
182 double-augmented fourth is considered a smaller interval than a
183 double-diminished fifth, regardless of the number of semitones
184 that each interval contains.
185
186 @lilypond[verbatim,quote,ragged-right]
187 \relative c'' {
188   c2 fis
189   c2 ges
190   b2 eisis
191   b2 feses
192 }
193 @end lilypond
194
195
196 @seealso
197
198 Music Glossary: @rglos{fifth}, @rglos{interval}, @rglos{Pitch names}.
199
200 Notation Reference: @ref{Octave checks}.
201
202 Snippets: @lsrdir{Pitches,Pitches}.
203
204
205 @funindex \transpose
206 @funindex \chordmode
207 @funindex \relative
208
209 @knownissues
210
211 The relative conversion will not affect @code{\transpose},
212 @code{\chordmode} or @code{\relative} sections in its argument.
213 To use relative mode within transposed music, an additional
214 @code{\relative} must be placed inside @code{\transpose}.
215
216 @c NOTE: DEPRECATED
217 If no @var{startpitch} is specified for @code{\relative},
218 then@tie{}@code{c'} is assumed.  However, this is a deprecated
219 option and may disappear in future versions, so its use is
220 discouraged.
221
222
223
224 @node Accidentals
225 @unnumberedsubsubsec Accidentals
226
227 @cindex accidental
228 @cindex key signature
229 @cindex clef
230
231 @warning{New users are sometimes confused about accidentals and
232 key signatures.  In LilyPond, note names are the raw input; key
233 signatures and clefs determine how this raw input is displayed.
234 An unaltered note like@tie{}@code{c} means @q{C natural},
235 regardless of the key signature or clef.  For more information,
236 see @rlearning{Accidentals and key signatures}.}
237
238 @cindex note names, Dutch
239 @cindex note names, default
240 @cindex sharp
241 @cindex flat
242 @cindex double sharp
243 @cindex sharp, double
244 @cindex double flat
245 @cindex flat, double
246 @cindex natural sign
247
248 A @notation{sharp} pitch is made by adding @code{is} to the note name,
249 and a @notation{flat} pitch by adding @code{es}.  As you might expect,
250 a @notation{double sharp} or @notation{double flat} is made by adding
251 @code{isis} or @code{eses}.  This syntax is derived from Dutch note
252 naming conventions.  To use other names for accidentals, see
253 @ref{Note names in other languages}.
254
255 @lilypond[verbatim,quote,ragged-right,fragment,relative=2]
256 ais1 aes aisis aeses
257 @end lilypond
258
259 A natural will cancel the effect of an accidental or key
260 signature.  However, naturals are not encoded into the note name
261 syntax with a suffix; a natural pitch is shown as a simple note
262 name:
263
264 @lilypond[verbatim,quote,ragged-right,fragment,relative=2]
265 a4 aes a2
266 @end lilypond
267
268 @cindex quarter tones
269 @cindex semi-flats, semi-sharps
270
271 Quarter tones may be added; the following is a series of Cs with
272 increasing pitches
273
274 @lilypond[verbatim,quote,ragged-right,fragment,relative=2]
275 ceseh1 ces ceh c cih cis cisih
276 @end lilypond
277
278
279
280 @cindex accidental, reminder
281 @cindex accidental, cautionary
282 @cindex accidental, parenthesized
283 @cindex reminder accidental
284 @funindex ?
285 @cindex cautionary accidental
286 @cindex parenthesized accidental
287 @funindex !
288
289 Normally accidentals are printed automatically, but you may also
290 print them manually.  A reminder accidental can be forced by
291 adding an exclamation mark@tie{}@code{!} after the pitch.  A
292 cautionary accidental (i.e., an accidental within parentheses) can
293 be obtained by adding the question mark@tie{}@code{?} after the
294 pitch.  These extra accidentals can also be used to produce
295 natural signs.
296
297 @lilypond[verbatim,quote,ragged-right,fragment,relative=2]
298 cis cis cis! cis? c c c! c?
299 @end lilypond
300
301 Accidentals on tied notes are only printed at the beginning of a
302 new system:
303
304 @lilypond[verbatim,quote,ragged-right,fragment,relative=2]
305 cis1 ~ cis ~
306 \break
307 cis
308 @end lilypond
309
310
311 @snippets
312
313 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
314 {preventing-extra-naturals-from-being-automatically-added.ly}
315
316 @seealso
317
318 Music Glossary: @rglos{sharp}, @rglos{flat}, @rglos{double sharp},
319 @rglos{double flat}, @rglos{Pitch names}, @rglos{quarter-tone}.
320
321 Learning Manual: @rlearning{Accidentals and key signatures}.
322
323 Notation Reference: @ref{Automatic accidentals},
324 @ref{Musica ficta accidentals},
325 @ref{Note names in other languages}.
326
327 Snippets: @lsrdir{Pitches,Pitches}.
328
329
330 @knownissues
331
332 There are no generally accepted standards for denoting
333 quarter-tone accidentals, so LilyPond's symbol does not conform to
334 any standard.
335
336
337
338 @node Note names in other languages
339 @unnumberedsubsubsec Note names in other languages
340
341 There are predefined sets of note names for various other
342 languages.  To use them, include the language-specific init file.
343 For example, to use English notes names, add @code{\include
344 "english.ly"} to the top of the input file.  The available
345 language files and the note names they define are:
346
347 @cindex note names, other languages
348 @cindex pitch names, other languages
349
350 @smallexample
351 @multitable {nederlands.ly} {do re mi fa sol la sib si} {-iss/-is} {-ess/-es} {-ss/-x/-sharpsharp} {-essess/-eses}
352 @headitem Language
353   @tab Note names
354   @tab sharp @tab flat @tab double sharp @tab double flat
355 @item nederlands.ly
356   @tab c d e f g a bes b
357   @tab -is @tab -es @tab -isis @tab -eses
358 @item english.ly
359   @tab c d e f g a bf b
360   @tab -s/-sharp @tab -f/-flat @tab -ss/-x/-sharpsharp
361     @tab -ff/-flatflat
362 @item deutsch.ly
363   @tab c d e f g a b h
364   @tab -is @tab -es @tab -isis @tab -eses
365 @item norsk.ly
366   @tab c d e f g a b h
367   @tab -iss/-is @tab -ess/-es @tab -ississ/-isis
368     @tab -essess/-eses
369 @item svenska.ly
370   @tab c d e f g a b h
371   @tab -iss @tab -ess @tab -ississ @tab -essess
372 @item suomi.ly
373   @tab c d e f g a b h
374   @tab -is @tab -es @tab -isis @tab -eses
375 @item italiano.ly
376   @tab do re mi fa sol la sib si
377   @tab -d @tab -b @tab -dd @tab -bb
378 @item catalan.ly
379   @tab do re mi fa sol la sib si
380   @tab -d/-s @tab -b @tab -dd/-ss @tab -bb
381 @item espanol.ly
382   @tab do re mi fa sol la sib si
383   @tab -s @tab -b @tab -ss @tab -bb
384 @item portugues.ly
385   @tab do re mi fa sol la sib si
386   @tab -s @tab -b @tab -ss @tab -bb
387 @item vlaams.ly
388   @tab do re mi fa sol la sib si
389   @tab -k @tab -b @tab -kk @tab -bb
390 @end multitable
391 @end smallexample
392
393 In Dutch, @code{aes} is contracted to @code{as}, but both forms
394 are accepted in LilyPond.  Similarly, both @code{es} and
395 @code{ees} are accepted.  This also applies to
396 @code{aeses}@tie{}/@tie{}@code{ases} and
397 @code{eeses}@tie{}/@tie{}@code{eses}.  Sometimes only these
398 contracted names are defined in the corresponding language files.
399
400 @lilypond[verbatim,quote,ragged-right,fragment,relative=2]
401 a2 as e es a ases e eses
402 @end lilypond
403
404
405 Some music uses microtones whose alterations are fractions of a
406 @q{normal} sharp or flat.  The note names for quarter-tones
407 defined in the various language files are listed in the following
408 table.  Here the prefixes @notation{semi-} and @notation{sesqui-}
409 mean @q{half} and @q{one and a half}, respectively.  For the other
410 languages, no special names have been defined yet.
411
412 @smallexample
413 @multitable {nederlands.ly} {do re mi fa sol la sib si} {-iss/-is} {-ess/-es} {-ississ/-isis} {-ississ/-isis}
414 @headitem Language
415   @tab Note names
416   @tab semi-sharp @tab semi-flat @tab sesqui-sharp @tab sesqui-flat
417
418 @item nederlands.ly
419   @tab c d e f g a bes b
420   @tab -ih @tab -eh @tab -isih @tab -eseh
421 @item english.ly
422   @tab c d e f g a bf b
423   @tab -qs @tab -qf @tab -tqs @tab -tqf
424 @item deutsch.ly
425   @tab c d e f g a b h
426   @tab -ih @tab -eh @tab -isih @tab -eseh
427 @item italiano.ly
428   @tab do re mi fa sol la sib si
429   @tab -sd @tab -sb @tab -dsd @tab -bsb
430 @item portugues.ly
431   @tab do re mi fa sol la sib si
432   @tab -sqt @tab -bqt @tab -stqt @tab -btqt
433 @end multitable
434 @end smallexample
435
436
437 @seealso
438
439 Music Glossary: @rglos{Pitch names}.
440
441 Snippets: @lsrdir{Pitches,Pitches}.
442
443
444 @node Changing multiple pitches
445 @subsection Changing multiple pitches
446
447 This section discusses how to modify pitches.
448
449 @menu
450 * Octave checks::               
451 * Transpose::                   
452 @end menu
453
454 @node Octave checks
455 @unnumberedsubsubsec Octave checks
456
457 @cindex octave correction
458 @cindex octave check
459 @funindex =
460 @funindex \octave
461
462 In relative mode, it is easy to forget an octave changing mark.
463 Octave checks make such errors easier to find by displaying a
464 warning and correcting the octave if a note is found in an
465 unexpected octave.
466
467 To check the octave of a specific note, specify the absolute
468 octave after the @code{=}@tie{}symbol.  This example will generate
469 a warning (and change the pitch) because the second note is the
470 absolute octave @code{d''} instead of @code{d'} as indicated by
471 the octave correction.
472
473 @lilypond[verbatim,quote,ragged-right,fragment]
474 \relative c'' {
475   c2 d='4 d
476   e2 f
477 }
478 @end lilypond
479
480 The octave of notes may also be checked with the
481 @code{\octave}@tie{}@var{controlpitch} command.  @var{controlpitch} is
482 specified in absolute mode.  This checks that the interval between the
483 previous note and the @var{controlpitch} is within a fourth (i.e. the
484 normal calculation of relative mode).  If this check fails, a warning
485 is printed, but the previous note is not changed.  Future notes are
486 relative to the @var{controlpitch}.
487
488 @lilypond[verbatim,quote,ragged-right,fragment]
489 \relative c'' {
490   c2 d
491   \octave c'
492   e2 f
493 }
494 @end lilypond
495
496 Compare the two bars below.  The first and third @code{\octave}
497 check fail, but the second one does not fail.
498
499 @lilypond[verbatim,quote,ragged-right,fragment]
500 \relative c'' {
501   c4 f g f
502
503   c4
504   \octave c'
505   f
506   \octave c'
507   g
508   \octave c'
509   f
510 }
511 @end lilypond
512
513
514 @seealso
515
516 Snippets: @lsrdir{Pitches,Pitches}.
517
518
519 @node Transpose
520 @unnumberedsubsubsec Transpose
521
522 @cindex transpose
523 @cindex transposition
524 @cindex transposition of pitches
525 @funindex \transpose
526
527 A music expression can be transposed with @code{\transpose}.  The
528 syntax is
529
530 @example
531 \transpose @var{frompitch} @var{topitch} @var{musicexpr}
532 @end example
533
534 @noindent
535 This means that @var{musicexpr} is transposed by the interval
536 between the pitches @var{frompitch} and @var{topitch}: any note
537 with pitch @var{frompitch} is changed to @var{topitch} and any
538 other note is transposed by the same interval.  Both pitches are
539 entered in absolute mode.
540
541 Consider a piece written in the key of D-major.  It can be
542 transposed up to E-major; note that the key signature is
543 automatically transposed as well.
544
545 @lilypond[verbatim,quote,ragged-right]
546 \transpose d e {
547   \relative c' {
548     \key d \major
549     d4 fis a d
550   }
551 }
552 @end lilypond
553
554 If a part written in C (normal concert pitch) is to be played on
555 the A clarinet (for which an A is notated as a C and thus sounds a
556 minor third lower than notated), the appropriate part will be
557 produced with:
558
559 @lilypond[verbatim,quote,ragged-right]
560 \transpose a c' {
561   \relative c' {
562     \key c \major
563     c4 d e g
564   }
565 }
566 @end lilypond
567
568 @noindent
569 Note that we specify @code{\key c \major} explicitly.  If we do
570 not specify a key signature, the notes will be transposed but no
571 key signature will be printed.
572
573 @code{\transpose} distinguishes between enharmonic pitches: both
574 @code{\transpose c cis} or @code{\transpose c des} will transpose
575 up a semitone.  The first version will print sharps and the notes
576 will remain on the same scale step, the second version will print
577 flats on the scale step above.
578
579 @lilypond[verbatim,quote,ragged-right]
580 mus = \relative c' { c d e f }
581 \new Staff {
582   \transpose c cis { \mus }
583   \transpose c des { \mus }
584 }
585 @end lilypond
586
587 @cindex transposing instruments
588
589 @code{\transpose} may also be used in a different way, to input
590 written notes for a transposing instrument.  The previous examples
591 show how to enter pitches in C (or @notation{concert pitch}) and
592 typeset them for a transposing instrument, but the opposite is
593 also possible if you for example have a set of instrumental parts
594 and want to print a conductor's score.  For example, when entering
595 music for a B-flat trumpet that begins on a notated E (concert D),
596 one would write:
597
598 @example
599 musicInBflat = @{ e4 @dots{} @}
600 \transpose c bes, \musicInBflat
601 @end example
602
603 @noindent
604 To print this music in F (e.g., rearranging to a French horn) you
605 could wrap the existing music with another @code{\transpose}:
606
607 @example
608 musicInBflat = @{ e4 @dots{} @}
609 \transpose f c' @{ \transpose c bes, \musicInBflat @}
610 @end example
611
612 @noindent
613 For more information about transposing instruments,
614 see @ref{Instrument transpositions}.
615
616
617 @snippets
618
619 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
620 {transposing-pitches-with-minimum-accidentals-smart-transpose.ly}
621
622
623 @seealso
624
625 Notation Reference: @ref{Instrument transpositions}.
626
627 Snippets: @lsrdir{Pitches,Pitches}.
628
629 Internals Reference: @internalsref{TransposedMusic}.
630
631 @funindex \transpose
632 @funindex \chordmode
633 @funindex \relative
634
635 @knownissues
636
637
638 The relative conversion will not affect @code{\transpose},
639 @code{\chordmode} or @code{\relative} sections in its argument.
640 To use relative mode within transposed music, an additional
641 @code{\relative} must be placed inside @code{\transpose}.
642
643
644 @node Displaying pitches
645 @subsection Displaying pitches
646
647 This section discusses how to alter the output of pitches.
648
649 @menu
650 * Clef::                        
651 * Key signature::               
652 * Ottava brackets::             
653 * Instrument transpositions::   
654 * Automatic accidentals::       
655 * Ambitus::                     
656 @end menu
657
658
659 @node Clef
660 @unnumberedsubsubsec Clef
661
662 @funindex \clef
663 @cindex G clef
664 @cindex C clef
665 @cindex F clef
666 @cindex treble clef
667 @cindex violin clef
668 @cindex alto clef
669 @cindex tenor clef
670 @cindex bass clef
671 @cindex french clef
672 @cindex soprano clef
673 @cindex mezzosoprano clef
674 @cindex baritone clef
675 @cindex varbaritone clef
676 @cindex subbass clef
677 @cindex clef
678 @cindex ancient clef
679 @cindex clef, ancient
680 @cindex clef, G
681 @cindex clef, C
682 @cindex clef, F
683 @cindex clef, treble
684 @cindex clef, violin 
685 @cindex clef, alto 
686 @cindex clef, tenor
687 @cindex clef, bass 
688 @cindex clef, french 
689 @cindex clef, soprano 
690 @cindex clef, mezzosoprano 
691 @cindex clef, baritone 
692 @cindex clef, varbaritone 
693 @cindex subbass clef, subbass 
694
695 The clef is set with the @code{\clef} @var{clefname} command.
696 Middle C is shown in every example.
697
698 @lilypond[verbatim,quote,ragged-right,fragment,relative=1]
699 \clef treble
700 c2 c
701 \clef alto
702 c2 c
703 \clef tenor
704 c2 c
705 \clef bass
706 c2 c
707 @end lilypond
708
709 Other clefs include:
710
711 @lilypond[verbatim,quote,ragged-right,fragment,relative=1]
712 \clef french
713 c2 c
714 \clef soprano
715 c2 c
716 \clef mezzosoprano
717 c2 c
718 \clef baritone
719 c2 c
720
721 \break
722
723 \clef varbaritone
724 c2 c
725 \clef subbass
726 c2 c
727 \clef percussion
728 c2 c
729 \clef tab
730 c2 c
731 @end lilypond
732
733 Further supported clefs are described under @ref{Ancient clefs}.
734
735 @cindex transposing clefs
736 @cindex clef, transposing
737 @cindex octave transposition
738
739 By adding @code{_8} or @code{^8} to the clef name, the clef is
740 transposed one octave down or up, respectively, and @code{_15} and
741 @code{^15} transposes by two octaves.  The argument @var{clefname}
742 must be enclosed in quotes when it contains underscores or digits.
743
744 @cindex choral tenor clef
745
746 @lilypond[verbatim,quote,ragged-right,fragment,relative=1]
747 \clef "treble_8"
748 c2 c
749 \clef "bass^15"
750 c2 c
751 @end lilypond
752
753
754 @snippets
755
756 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
757 {clefs-commonly-tweaked-properties.ly}
758
759
760 @seealso
761
762 Notation Reference: @ref{Ancient clefs}.
763
764 Snippets: @lsrdir{Pitches,Pitches}.
765
766 Internals Reference: @internalsref{Clef}.
767
768
769 @node Key signature
770 @unnumberedsubsubsec Key signature
771
772 @cindex key signature
773 @funindex \key
774
775 @warning{New users are sometimes confused about accidentals and
776 key signatures.  In LilyPond, note names are the raw input; key
777 signatures and clefs determine how this raw input is displayed.
778 An unaltered note like@tie{}@code{c} means @q{C natural},
779 regardless of the key signature or clef.  For more information,
780 see @rlearning{Accidentals and key signatures}.}
781
782 The key signature indicates the tonality in which a piece is
783 played.  It is denoted by a set of alterations (flats or sharps)
784 at the start of the staff.  Setting or changing the key signature
785 is done with the @code{\key} command:
786
787 @example
788 \key @var{pitch} @var{mode}
789 @end example
790
791 @funindex \major
792 @funindex \minor
793 @funindex \ionian
794 @funindex \locrian
795 @funindex \aeolian
796 @funindex \mixolydian
797 @funindex \lydian
798 @funindex \phrygian
799 @funindex \dorian
800 @cindex church modes
801 @cindex modes
802
803 Here, @var{mode} should be @code{\major} or @code{\minor} to get a
804 key signature of @var{pitch}-major or @var{pitch}-minor,
805 respectively.  You may also use the standard mode names, also
806 called @q{church modes}: @code{\ionian}, @code{\dorian},
807 @code{\phrygian}, @code{\lydian}, @code{\mixolydian},
808 @code{\aeolian}, and @code{\locrian}.
809
810 @lilypond[verbatim,quote,ragged-right,fragment,relative=2]
811 \key g \major
812 fis1
813 f
814 fis
815 @end lilypond
816
817
818 @snippets
819
820 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
821 {preventing-natural-signs-from-being-printed-when-the-key-signature-changes.ly}
822
823 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
824 {non-traditional-key-signatures.ly}
825
826
827 @seealso
828
829 Music Glossary: @rglos{church mode}, @rglos{scordatura}.
830
831 Learning Manual: @rlearning{Accidentals and key signatures}.
832
833 Snippets: @lsrdir{Pitches,Pitches}.
834
835 Internals Reference: @internalsref{KeyCancellation},
836 @internalsref{KeySignature}, @internalsref{Key_engraver}.
837
838
839 @node Ottava brackets
840 @unnumberedsubsubsec Ottava brackets
841
842 @cindex ottava
843 @cindex 15ma
844 @cindex 8va
845 @cindex 8ve
846 @cindex octavation
847
848 @notation{Ottava brackets} introduce an extra transposition of an
849 octave for the staff:
850
851 @lilypond[verbatim,quote,ragged-right,fragment,relative=2]
852 a'2 b
853 #(set-octavation 1)
854 a b
855 #(set-octavation 0)
856 a b
857 @end lilypond
858
859 The @code{set-octavation} function also takes -1 (for 8va bassa),
860 2@tie{}(for 15ma), and -2 (for 15ma bassa) as arguments.
861
862
863 @snippets
864
865 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
866 {ottava-text.ly}
867
868
869 @seealso
870
871 Music Glossary: @rglos{octavation}.
872
873 Snippets: @lsrdir{Pitches,Pitches}.
874
875 Internals Reference: @internalsref{OttavaBracket}.
876
877
878
879 @node Instrument transpositions
880 @unnumberedsubsubsec Instrument transpositions
881
882 @cindex transposition, MIDI
883 @cindex transposition, instrument
884 @cindex transposing instrument
885 @cindex MIDI
886 @funindex \transposition
887
888 When typesetting scores that involve transposing instruments, some
889 parts can be typeset in a different pitch than the
890 @notation{concert pitch}.  In these cases, the key of the
891 @notation{transposing instrument} should be specified; otherwise
892 the MIDI output and cues in other parts will produce incorrect
893 pitches.  For more information about quotations, see @ref{Quoting
894 other voices}.
895
896 @example
897 \transposition @var{pitch}
898 @end example
899
900 The pitch to use for @code{\transposition} should correspond to
901 the real sound heard when a@tie{}@code{c'} written on the staff is
902 played by the transposing instrument.  This pitch is entered in
903 absolute mode, so an instrument that produces a real sound which
904 is one tone higher than the printed music should use
905 @code{\transposition d'}.  @code{\transposition} should
906 @emph{only} be used if the pitches are @emph{not} being entered in
907 concert pitch.
908
909 Here are a few notes for violin and B-flat clarinet where the
910 parts have been entered using the notes and key as they appear in
911 each part of the conductor's score.  The two instruments are
912 playing in unison.
913
914 @lilypond[verbatim,quote,ragged-right]
915 \new GrandStaff <<
916   \new Staff = "Vln" {
917     \relative c'' {
918       \set Staff.instrumentName = "Vln"
919       \set Staff.midiInstrument="violin"
920       % strictly speaking not necessary, but a good reminder
921       \transposition c'
922
923       \key c \major
924       g4( c8) r c r c4
925     }
926   }
927   \new Staff = "clarinet" {
928     \relative c'' {
929       \set Staff.instrumentName = \markup {Cl (B\flat)}
930       \set Staff.midiInstrument="clarinet"
931       \transposition bes
932
933       % not concert pitch
934       \key d \major
935       a4( d8) r d r d4
936     }
937   }
938 >>
939 @end lilypond
940
941 The @code{\transposition} may be changed during a piece.  For
942 example, a clarinetist may switch from an A clarinet to a B-flat
943 clarinet.
944
945 @lilypond[verbatim,quote,ragged-right,fragment,relative=2]
946 \set Staff.instrumentName = "Cl (A)"
947 \key a \major
948 \transposition a
949 c d e f
950 \textLengthOn
951 r1^\markup{Switch to B\flat clarinet}
952
953 \key bes \major
954 \transposition bes
955 c2 g
956 @end lilypond
957
958
959 @seealso
960
961 Music Glossary: @rglos{concert pitch}, @rglos{transposing instrument}.
962
963 Notation Reference: @ref{Quoting other voices}, @ref{Transpose}.
964
965 Snippets: @lsrdir{Pitches,Pitches}.
966
967
968 @node Automatic accidentals
969 @unnumberedsubsubsec Automatic accidentals
970
971 @cindex automatic accidentals
972 @cindex accidentals, automatic
973 @cindex accidentals
974 @cindex accidental style
975 @cindex default accidental style
976 @cindex accidental style, default
977 @funindex set-accidental-style
978
979 There are many different conventions on how to typeset
980 accidentals.  LilyPond provides a function to specify which
981 accidental style to use.  This function is called as follows
982
983 @example
984 \new Staff <<
985   #(set-accidental-style 'voice)
986   @{ @dots{} @}
987 >>
988 @end example
989
990 The accidental style applies to the current @code{Staff} by
991 default (with the exception of the styles @code{piano} and
992 @code{piano-cautionary}, which are explained below).  Optionally,
993 the function can take a second argument that determines in which
994 scope the style should be changed.  For example, to use the same
995 style in all staves of the current @code{StaffGroup}, use
996
997 @example
998 #(set-accidental-style 'voice 'StaffGroup)
999 @end example
1000
1001 The following accidental styles are supported.  To demonstrate
1002 each style, we use the following example:
1003
1004 @lilypond[verbatim,quote,ragged-right]
1005 musicA = {
1006   <<
1007     \relative c' {
1008       cis'8 fis, d'4 <a cis>8 f bis4 |
1009       cis2. <c, g'>4 |
1010     }
1011     \\
1012     \relative c' {
1013       ais'2 cis, |
1014       fis8 b a4 cis2 |
1015     }
1016   >>
1017 }
1018
1019 musicB = {
1020   \clef bass
1021   \new Voice {
1022     \voiceTwo \relative c' {
1023       <fis, a cis>4
1024       \change Staff = up
1025       cis'
1026       \change Staff = down
1027       <fis, a>
1028       \change Staff = up
1029       dis' |
1030       \change Staff = down
1031       <fis, a cis>4 gis <f a d>2 |
1032     }
1033   }
1034 }
1035
1036 \new PianoStaff {
1037   <<
1038     \context Staff = "up" {
1039       %%% change the next line as desired:
1040       #(set-accidental-style 'default)
1041       \musicA
1042     }
1043     \context Staff = "down" {
1044       %%% change the next line as desired:
1045       #(set-accidental-style 'default)
1046       \musicB
1047     }
1048   >>
1049 }
1050 @end lilypond
1051
1052 Note that the last lines of this example can be replaced by the
1053 following, as long as the same accidental style should be used in
1054 both staves.
1055 @example
1056 \new PianoStaff @{
1057   <<
1058     \context Staff = "up" @{
1059       %%% change the next line as desired:
1060       #(set-accidental-style 'default 'Score)
1061       \musicA
1062     @}
1063     \context Staff = "down" @{
1064       \musicB
1065     @}
1066   >>
1067 @}
1068 @end example
1069
1070
1071 @c NOTE: don't use verbatim in this table.
1072 @table @code
1073 @item default
1074 This is the default typesetting behavior.  It corresponds to
1075 eighteenth-century common practice: accidentals are remembered to
1076 the end of the measure in which they occur and only on their own
1077 octave.  Thus, in the example below, no natural signs are printed
1078 before the@tie{}@code{b} in the second measure or the
1079 last@tie{}@code{c}:
1080
1081 @lilypond[quote,ragged-right]
1082 musicA = {
1083   <<
1084     \relative c' {
1085       cis'8 fis, d'4 <a cis>8 f bis4 |
1086       cis2. <c, g'>4 |
1087     }
1088     \\
1089     \relative c' {
1090       ais'2 cis, |
1091       fis8 b a4 cis2 |
1092     }
1093   >>
1094 }
1095
1096 musicB = {
1097   \clef bass
1098   \new Voice {
1099     \voiceTwo \relative c' {
1100       <fis, a cis>4
1101       \change Staff = up
1102       cis'
1103       \change Staff = down
1104       <fis, a>
1105       \change Staff = up
1106       dis' |
1107       \change Staff = down
1108       <fis, a cis>4 gis <f a d>2 |
1109     }
1110   }
1111 }
1112
1113 \new PianoStaff {
1114   <<
1115     \context Staff = "up" {
1116       #(set-accidental-style 'default)
1117       \musicA
1118     }
1119     \context Staff = "down" {
1120       #(set-accidental-style 'default)
1121       \musicB
1122     }
1123   >>
1124 }
1125 @end lilypond
1126
1127 @item voice
1128 The normal behavior is to remember the accidentals on Staff-level.
1129 In this style, however, accidentals are typeset individually for
1130 each voice.  Apart from that, the rule is similar to
1131 @code{default}.
1132
1133 As a result, accidentals from one voice do not get canceled in
1134 other voices, which is often an unwanted result: in the following
1135 example, it is hard to determine whether the second@tie{}@code{a}
1136 should be played natural or sharp.  The @code{voice} option should
1137 therefore be used only if the voices are to be read solely by
1138 individual musicians.  If the staff is to be used by one musician
1139 (e.g., a conductor or in a piano score) then @code{modern} or
1140 @code{modern-cautionary} should be used instead.
1141
1142
1143 @lilypond[quote,ragged-right]
1144 musicA = {
1145   <<
1146     \relative c' {
1147       cis'8 fis, d'4 <a cis>8 f bis4 |
1148       cis2. <c, g'>4 |
1149     }
1150     \\
1151     \relative c' {
1152       ais'2 cis, |
1153       fis8 b a4 cis2 |
1154     }
1155   >>
1156 }
1157
1158 musicB = {
1159   \clef bass
1160   \new Voice {
1161     \voiceTwo \relative c' {
1162       <fis, a cis>4
1163       \change Staff = up
1164       cis'
1165       \change Staff = down
1166       <fis, a>
1167       \change Staff = up
1168       dis' |
1169       \change Staff = down
1170       <fis, a cis>4 gis <f a d>2 |
1171     }
1172   }
1173 }
1174
1175 \new PianoStaff {
1176   <<
1177     \context Staff = "up" {
1178       #(set-accidental-style 'voice)
1179       \musicA
1180     }
1181     \context Staff = "down" {
1182       #(set-accidental-style 'voice)
1183       \musicB
1184     }
1185   >>
1186 }
1187 @end lilypond
1188
1189 @item modern
1190 @cindex accidentals, modern style
1191 @cindex modern style accidentals
1192 @funindex modern style accidentals
1193
1194 This rule corresponds to the common practice in the twentieth
1195 century.  It prints the same accidentals as @code{default}, with
1196 two exceptions that serve to avoid ambiguity: after temporary
1197 accidentals, cancellation marks are printed also in the following
1198 measure (for notes in the same octave) and, in the same measure,
1199 for notes in other octaves.  Hence the naturals before
1200 the@tie{}@code{b} and the@tie{}@code{c} in the second measure of
1201 the upper staff:
1202
1203 @lilypond[quote,ragged-right]
1204 musicA = {
1205   <<
1206     \relative c' {
1207       cis'8 fis, d'4 <a cis>8 f bis4 |
1208       cis2. <c, g'>4 |
1209     }
1210     \\
1211     \relative c' {
1212       ais'2 cis, |
1213       fis8 b a4 cis2 |
1214     }
1215   >>
1216 }
1217
1218 musicB = {
1219   \clef bass
1220   \new Voice {
1221     \voiceTwo \relative c' {
1222       <fis, a cis>4
1223       \change Staff = up
1224       cis'
1225       \change Staff = down
1226       <fis, a>
1227       \change Staff = up
1228       dis' |
1229       \change Staff = down
1230       <fis, a cis>4 gis <f a d>2 |
1231     }
1232   }
1233 }
1234
1235 \new PianoStaff {
1236   <<
1237     \context Staff = "up" {
1238       #(set-accidental-style 'modern)
1239       \musicA
1240     }
1241     \context Staff = "down" {
1242       #(set-accidental-style 'modern)
1243       \musicB
1244     }
1245   >>
1246 }
1247 @end lilypond
1248
1249 @item modern-cautionary
1250 @cindex accidentals, modern cautionary style
1251 @cindex modern style accidentals
1252 @cindex modern style cautionary accidentals
1253 @cindex modern accidental style
1254 @cindex modern cautionary accidental style
1255 @funindex modern-cautionary
1256
1257 This rule is similar to @code{modern}, but the @q{extra}
1258 accidentals (the ones not typeset by @code{default}) are typeset
1259 as cautionary accidentals.  They are by default printed with
1260 parentheses, but they can also be printed in reduced size by
1261 defining the @code{cautionary-style} property of
1262 @code{AccidentalSuggestion}.
1263
1264
1265 @lilypond[quote,ragged-right]
1266 musicA = {
1267   <<
1268     \relative c' {
1269       cis'8 fis, d'4 <a cis>8 f bis4 |
1270       cis2. <c, g'>4 |
1271     }
1272     \\
1273     \relative c' {
1274       ais'2 cis, |
1275       fis8 b a4 cis2 |
1276     }
1277   >>
1278 }
1279
1280 musicB = {
1281   \clef bass
1282   \new Voice {
1283     \voiceTwo \relative c' {
1284       <fis, a cis>4
1285       \change Staff = up
1286       cis'
1287       \change Staff = down
1288       <fis, a>
1289       \change Staff = up
1290       dis' |
1291       \change Staff = down
1292       <fis, a cis>4 gis <f a d>2 |
1293     }
1294   }
1295 }
1296
1297 \new PianoStaff {
1298   <<
1299     \context Staff = "up" {
1300       #(set-accidental-style 'modern-cautionary)
1301       \musicA
1302     }
1303     \context Staff = "down" {
1304       #(set-accidental-style 'modern-cautionary)
1305       \musicB
1306     }
1307   >>
1308 }
1309 @end lilypond
1310
1311 @item modern-voice
1312 @cindex accidentals, multivoice
1313 @cindex accidentals, modern
1314 @cindex modern accidentals
1315 @cindex multivoice accidentals
1316 @cindex accidental style, modern
1317 @cindex modern accidental style
1318 @funindex modern-voice
1319
1320 This rule is used for multivoice accidentals to be read both by
1321 musicians playing one voice and musicians playing all voices.
1322 Accidentals are typeset for each voice, but they @emph{are}
1323 canceled across voices in the same @code{Staff}.  Hence,
1324 the@tie{}@code{a} in the last measure is canceled because the
1325 previous cancellation was in a different voice, and
1326 the@tie{}@code{d} in the lower staff is canceled because of the
1327 accidental in a different voice in the previous measure:
1328
1329
1330 @lilypond[quote,ragged-right]
1331 musicA = {
1332   <<
1333     \relative c' {
1334       cis'8 fis, d'4 <a cis>8 f bis4 |
1335       cis2. <c, g'>4 |
1336     }
1337     \\
1338     \relative c' {
1339       ais'2 cis, |
1340       fis8 b a4 cis2 |
1341     }
1342   >>
1343 }
1344
1345 musicB = {
1346   \clef bass
1347   \new Voice {
1348     \voiceTwo \relative c' {
1349       <fis, a cis>4
1350       \change Staff = up
1351       cis'
1352       \change Staff = down
1353       <fis, a>
1354       \change Staff = up
1355       dis' |
1356       \change Staff = down
1357       <fis, a cis>4 gis <f a d>2 |
1358     }
1359   }
1360 }
1361
1362 \new PianoStaff {
1363   <<
1364     \context Staff = "up" {
1365       #(set-accidental-style 'modern-voice)
1366       \musicA
1367     }
1368     \context Staff = "down" {
1369       #(set-accidental-style 'modern-voice)
1370       \musicB
1371     }
1372   >>
1373 }
1374 @end lilypond
1375
1376 @cindex accidental style, modern voice cautionary
1377 @cindex accidental style, cautionary, modern voice
1378 @cindex accidental style, voice, modern cautionary
1379 @funindex modern-voice-cautionary
1380 @item modern-voice-cautionary
1381
1382 This rule is the same as @code{modern-voice}, but with the extra
1383 accidentals (the ones not typeset by @code{voice}) typeset
1384 as cautionaries.  Even though all accidentals typeset by
1385 @code{default} @emph{are} typeset with this rule,
1386 some of them are typeset as cautionaries.
1387
1388 @lilypond[quote,ragged-right]
1389 musicA = {
1390   <<
1391     \relative c' {
1392       cis'8 fis, d'4 <a cis>8 f bis4 |
1393       cis2. <c, g'>4 |
1394     }
1395     \\
1396     \relative c' {
1397       ais'2 cis, |
1398       fis8 b a4 cis2 |
1399     }
1400   >>
1401 }
1402
1403 musicB = {
1404   \clef bass
1405   \new Voice {
1406     \voiceTwo \relative c' {
1407       <fis, a cis>4
1408       \change Staff = up
1409       cis'
1410       \change Staff = down
1411       <fis, a>
1412       \change Staff = up
1413       dis' |
1414       \change Staff = down
1415       <fis, a cis>4 gis <f a d>2 |
1416     }
1417   }
1418 }
1419
1420 \new PianoStaff {
1421   <<
1422     \context Staff = "up" {
1423       #(set-accidental-style 'modern-voice-cautionary)
1424       \musicA
1425     }
1426     \context Staff = "down" {
1427       #(set-accidental-style 'modern-voice-cautionary)
1428       \musicB
1429     }
1430   >>
1431 }
1432 @end lilypond
1433
1434 @item piano
1435 @cindex piano accidentals
1436 @cindex piano accidentals
1437 @cindex accidentals, piano
1438 @cindex piano accidental style
1439 @cindex accidental style, piano
1440
1441 This rule reflects twentieth-century practice for piano notation.
1442 Its behavior is very similar to @code{modern} style, but here
1443 accidentals also get canceled across the staves in the same
1444 GrandStaff or PianoStaff, hence all the cancellations of the final
1445 notes.
1446
1447 This accidental style applies to the current @code{GrandStaff} or
1448 @code{PianoStaff} by default.
1449
1450 @lilypond[quote,ragged-right]
1451 musicA = {
1452   <<
1453     \relative c' {
1454       cis'8 fis, d'4 <a cis>8 f bis4 |
1455       cis2. <c, g'>4 |
1456     }
1457     \\
1458     \relative c' {
1459       ais'2 cis, |
1460       fis8 b a4 cis2 |
1461     }
1462   >>
1463 }
1464
1465 musicB = {
1466   \clef bass
1467   \new Voice {
1468     \voiceTwo \relative c' {
1469       <fis, a cis>4
1470       \change Staff = up
1471       cis'
1472       \change Staff = down
1473       <fis, a>
1474       \change Staff = up
1475       dis' |
1476       \change Staff = down
1477       <fis, a cis>4 gis <f a d>2 |
1478     }
1479   }
1480 }
1481
1482 \new PianoStaff {
1483   <<
1484     \context Staff = "up" {
1485       #(set-accidental-style 'piano)
1486       \musicA
1487     }
1488     \context Staff = "down" {
1489       \musicB
1490     }
1491   >>
1492 }
1493 @end lilypond
1494
1495 @item piano-cautionary
1496 @funindex #(set-accidental-style 'piano-cautionary)
1497 @cindex accidentals, piano cautionary
1498 @cindex cautionary accidentals, piano
1499 @cindex piano cautionary accidentals
1500 @cindex accidental style, piano cautionary
1501 @cindex cautionary accidental style, piano
1502 @cindex piano cautionary accidental style
1503
1504 Same as @code{#(set-accidental-style 'piano)} but with the extra
1505 accidentals typeset as cautionaries.
1506
1507 @lilypond[quote,ragged-right]
1508 musicA = {
1509   <<
1510     \relative c' {
1511       cis'8 fis, d'4 <a cis>8 f bis4 |
1512       cis2. <c, g'>4 |
1513     }
1514     \\
1515     \relative c' {
1516       ais'2 cis, |
1517       fis8 b a4 cis2 |
1518     }
1519   >>
1520 }
1521
1522 musicB = {
1523   \clef bass
1524   \new Voice {
1525     \voiceTwo \relative c' {
1526       <fis, a cis>4
1527       \change Staff = up
1528       cis'
1529       \change Staff = down
1530       <fis, a>
1531       \change Staff = up
1532       dis' |
1533       \change Staff = down
1534       <fis, a cis>4 gis <f a d>2 |
1535     }
1536   }
1537 }
1538
1539 \new PianoStaff {
1540   <<
1541     \context Staff = "up" {
1542       #(set-accidental-style 'piano-cautionary)
1543       \musicA
1544     }
1545     \context Staff = "down" {
1546       \musicB
1547     }
1548   >>
1549 }
1550 @end lilypond
1551
1552 @item no-reset
1553 @funindex no-reset accidental style
1554 @cindex accidental style, no reset
1555 @cindex no reset accidental style
1556
1557 This is the same as @code{default} but with accidentals lasting
1558 @q{forever} and not only within the same measure:
1559
1560 @lilypond[quote,ragged-right]
1561 musicA = {
1562   <<
1563     \relative c' {
1564       cis'8 fis, d'4 <a cis>8 f bis4 |
1565       cis2. <c, g'>4 |
1566     }
1567     \\
1568     \relative c' {
1569       ais'2 cis, |
1570       fis8 b a4 cis2 |
1571     }
1572   >>
1573 }
1574
1575 musicB = {
1576   \clef bass
1577   \new Voice {
1578     \voiceTwo \relative c' {
1579       <fis, a cis>4
1580       \change Staff = up
1581       cis'
1582       \change Staff = down
1583       <fis, a>
1584       \change Staff = up
1585       dis' |
1586       \change Staff = down
1587       <fis, a cis>4 gis <f a d>2 |
1588     }
1589   }
1590 }
1591
1592 \new PianoStaff {
1593   <<
1594     \context Staff = "up" {
1595       #(set-accidental-style 'no-reset)
1596       \musicA
1597     }
1598     \context Staff = "down" {
1599       #(set-accidental-style 'no-reset)
1600       \musicB
1601     }
1602   >>
1603 }
1604 @end lilypond
1605
1606 @item forget
1607 @funindex forget accidental style
1608 @cindex forget accidental style
1609 @cindex accidental style, forget
1610
1611 This is the opposite of @code{no-reset}: Accidentals are not
1612 remembered at all -- and hence all accidentals are typeset
1613 relative to the key signature, regardless of what was before in
1614 the music:
1615
1616 @lilypond[quote,ragged-right]
1617 musicA = {
1618   <<
1619     \relative c' {
1620       cis'8 fis, d'4 <a cis>8 f bis4 |
1621       cis2. <c, g'>4 |
1622     }
1623     \\
1624     \relative c' {
1625       ais'2 cis, |
1626       fis8 b a4 cis2 |
1627     }
1628   >>
1629 }
1630
1631 musicB = {
1632   \clef bass
1633   \new Voice {
1634     \voiceTwo \relative c' {
1635       <fis, a cis>4
1636       \change Staff = up
1637       cis'
1638       \change Staff = down
1639       <fis, a>
1640       \change Staff = up
1641       dis' |
1642       \change Staff = down
1643       <fis, a cis>4 gis <f a d>2 |
1644     }
1645   }
1646 }
1647
1648 \new PianoStaff {
1649   <<
1650     \context Staff = "up" {
1651       #(set-accidental-style 'forget)
1652       \musicA
1653     }
1654     \context Staff = "down" {
1655       #(set-accidental-style 'forget)
1656       \musicB
1657     }
1658   >>
1659 }
1660 @end lilypond
1661 @end table
1662
1663 @snippets
1664
1665 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
1666 {dodecaphonic-style-accidentals-for-each-note-including-naturals.ly}
1667
1668
1669 @seealso
1670
1671 Snippets: @lsrdir{Pitches,Pitches}.
1672
1673 Internals Reference: @internalsref{Accidental_engraver},
1674 @internalsref{Accidental}, @internalsref{AccidentalSuggestion},
1675 @internalsref{AccidentalPlacement}, @internalsref{GrandStaff} and
1676 @internalsref{PianoStaff}, @internalsref{Staff}.
1677
1678
1679 @cindex accidentals and simultaneous notes
1680 @cindex simultaneous notes and accidentals
1681 @cindex accidentals in chords
1682 @cindex chords, accidentals in
1683
1684 @knownissues
1685
1686 Simultaneous notes are considered to be entered in sequential
1687 mode.  This means that in a chord the accidentals are typeset as
1688 if the notes in the chord happen one at a time, in the order in
1689 which they appear in the input file.  This is a problem when
1690 accidentals in a chord depend on each other, which does not happen
1691 for the default accidental style.  The problem can be solved by
1692 manually inserting@tie{}@code{!} and@tie{}@code{?} for the
1693 problematic notes.
1694
1695
1696 @node Ambitus
1697 @unnumberedsubsubsec Ambitus
1698
1699 @cindex ambitus
1700 @cindex range of pitches
1701 @cindex pitch range
1702
1703 The term @notation{ambitus} (pl. ambitus) denotes a range of
1704 pitches for a given voice in a part of music.  It may also denote
1705 the pitch range that a musical instrument is capable of playing.
1706 Ambitus are printed on vocal parts so that performers can easily
1707 determine if it matches their capabilities.
1708
1709 Ambitus are denoted at the beginning of a piece near the initial
1710 clef.  The range is graphically specified by two note heads that
1711 represent the lowest and highest pitches.  Accidentals are only
1712 printed if they are not part of the key signature.
1713
1714 @lilypond[verbatim,quote,ragged-right]
1715 \layout {
1716   \context {
1717     \Voice
1718     \consists Ambitus_engraver
1719   }
1720 }
1721
1722 \relative c'' {
1723   aes c e2 cis,2
1724 }
1725 @end lilypond
1726
1727
1728 @snippets
1729
1730 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
1731 {adding-ambiti-per-voice.ly}
1732
1733 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
1734 {ambiti-multiple-voices.ly}
1735
1736
1737 @seealso
1738
1739 Music Glossary: @rglos{ambitus}.
1740
1741 Snippets: @lsrdir{Pitches,Pitches}.
1742
1743 Internals Reference: @internalsref{Ambitus},
1744 @internalsref{AmbitusLine}, @internalsref{AmbitusNoteHead},
1745 @internalsref{AmbitusAccidental}, @internalsref{Ambitus_engraver},
1746 @internalsref{Staff}, @internalsref{Voice}.
1747
1748
1749 @knownissues
1750
1751 There is no collision handling in the case of multiple per-voice
1752 ambitus.
1753
1754
1755 @node Note heads
1756 @subsection Note heads
1757
1758 This section suggests ways of altering note heads.
1759
1760 @menu
1761 * Special note heads::          
1762 * Easy notation note heads::    
1763 * Shape note heads::            
1764 * Improvisation::               
1765 @end menu
1766
1767 @node Special note heads
1768 @unnumberedsubsubsec Special note heads
1769
1770 @cindex note heads, special
1771 @cindex note heads, cross
1772 @cindex note heads, diamond
1773 @cindex note heads, parlato
1774 @cindex note heads, harmonic
1775 @cindex note heads, guitar
1776 @cindex special note heads
1777 @cindex cross note heads
1778 @cindex diamond note heads
1779 @cindex parlato note heads
1780 @cindex harmonic note heads
1781 @cindex guitar note heads
1782
1783 Different note heads are used by various instruments for various
1784 meanings -- crosses are used for @q{parlato} with vocalists,
1785 stopped notes on guitar; diamonds are used for harmonics on string
1786 instruments, etc.  There is a shorthand (@code{\harmonic}) for
1787 diamond shapes; the other note head styles are produced by
1788 tweaking the property:
1789
1790 @lilypond[verbatim,quote,ragged-right,fragment,relative=1]
1791 c4 d
1792 \override NoteHead #'style = #'cross
1793 e f
1794 \revert NoteHead #'style
1795 e d <c f\harmonic> <d a'\harmonic>
1796 @end lilypond
1797
1798 @noindent
1799 To see all note head styles, see @ref{Note head styles}.
1800
1801
1802 @seealso
1803
1804 Snippets: @lsrdir{Pitches,Pitches}.
1805
1806 Notation Reference: @ref{Note head styles}.
1807
1808 Internals Reference: @internalsref{NoteHead},
1809 @internalsref{LedgerLineSpanner}.
1810
1811
1812 @node Easy notation note heads
1813 @unnumberedsubsubsec Easy notation note heads
1814
1815 @cindex note heads, practice
1816 @cindex note heads, easy notation
1817 @cindex easy notation
1818 @cindex Hal Leonard
1819 @cindex beginners' music
1820 @cindex music, beginners'
1821 @cindex easy play note heads
1822 @cindex note heads, easy play
1823
1824 The @q{easy play} note head includes a note name inside the head.
1825 It is used in music for beginners.
1826
1827 @lilypond[verbatim,quote,ragged-right]
1828 #(set-global-staff-size 26)
1829 \relative c' {
1830   \easyHeadsOn
1831   c2 e4 f
1832   g1
1833   \easyHeadsOff
1834   c,1
1835 }
1836 @end lilypond
1837
1838 The command @code{\easyHeadsOn} overrides settings for the
1839 @code{NoteHead} object.  These settings can be reverted with the command
1840 @code{\easyHeadsOff}. To make the letters readable, it has to be printed
1841 in a large font size.  To print with a larger font, see @ref{Setting the
1842 staff size}.
1843
1844 @predefined
1845
1846 @funindex \easyHeadsOn
1847 @funindex \easyHeadsOff
1848 @code{\easyHeadsOn}, @code{\easyHeadsOff}
1849
1850 @seealso
1851
1852 Notation Reference: @ref{Setting the staff size}.
1853
1854 Snippets: @lsrdir{Pitches,Pitches},
1855
1856 Internals Reference: @internalsref{NoteHead}.
1857
1858
1859 @node Shape note heads
1860 @unnumberedsubsubsec Shape note heads
1861
1862 @cindex note heads, shape
1863 @cindex note heads, Aiken
1864 @cindex note heads, sacred harp
1865 @cindex shape notes
1866 @cindex Aiken shape note heads
1867 @cindex sacred harp note heads
1868 @funindex \key
1869 @funindex shapeNoteStyles
1870 @funindex \aikenHeads
1871 @funindex \sacredHarpHeads
1872
1873 In shape note head notation, the shape of the note head
1874 corresponds to the harmonic function of a note in the scale.  This
1875 notation was popular in nineteenth-century American song books.
1876
1877 Shape note heads can be produced by setting @code{\aikenHeads} or
1878 @code{\sacredHarpHeads}, depending on the style desired.
1879
1880 @lilypond[verbatim,fragment,quote,ragged-right,relative=1]
1881 \aikenHeads
1882 c8 d4 e8 a2 g1
1883 \sacredHarpHeads
1884 c,8 d4 e8 a2 g1
1885 @end lilypond
1886
1887 Shapes are typeset according to the step in the scale, where
1888 the base of the scale is determined by the @code{\key} command.
1889
1890 @snippets
1891
1892 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
1893 {applying-noteheads-styles-depending-on-the-step-of-the-scale.ly}
1894
1895 @noindent
1896 To see all note head styles, see @ref{Note head styles}.
1897
1898 @seealso
1899
1900 Snippets: @lsrdir{Pitches,Pitches}.
1901
1902 Notation Reference: @ref{Note head styles}.
1903
1904
1905 @node Improvisation
1906 @unnumberedsubsubsec Improvisation
1907
1908 @cindex improvisation
1909 @cindex slashed note heads
1910 @cindex note heads, improvisation
1911 @cindex note heads, slashed
1912
1913 Improvisation is sometimes denoted with slashed note heads, where
1914 the performer may choose any pitch but should play the specified
1915 rhythm.  Such note heads can be created:
1916
1917 @lilypond[verbatim,quote,ragged-right]
1918 \new Voice \with {
1919   \consists Pitch_squash_engraver
1920 } \transpose c c' {
1921   e8 e g a a16( bes) a8 g
1922   \improvisationOn
1923   e8
1924   ~e2~e8 f4 fis8
1925   ~fis2
1926   \improvisationOff
1927   a16(bes) a8 g e
1928 }
1929 @end lilypond
1930
1931
1932 @predefined
1933
1934 @funindex \improvisationOn
1935 @funindex \improvisationOff
1936
1937 @code{\improvisationOn}, @code{\improvisationOff}
1938
1939 @seealso
1940
1941 Snippets: @lsrdir{Pitches,Pitches}.
1942
1943 Internals Reference: @internalsref{Pitch_squash_engraver},
1944 @internalsref{Voice}.
1945
1946