Documentation/notation/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.  For details, see the Contributors'
   7     Guide, node Updating translation committishes..
   8 @end ignore
   9
  10 @c \version "2.19.53"
  11
  12
  13 @node Pitches
  14 @section Pitches
  15
  16 @lilypondfile[quote]{pitches-headword.ly}
  17
  18 This section discusses how to specify the pitch of notes.  There
  19 are three steps to this process: input, modification, and output.
  20
  21 @menu
  22 * Writing pitches::
  23 * Changing multiple pitches::
  24 * Displaying pitches::
  25 * Note heads::
  26 @end menu
  27
  28
  29 @node Writing pitches
  30 @subsection Writing pitches
  31
  32 This section discusses how to input pitches.  There are two
  33 different ways to place notes in octaves: absolute and relative
  34 mode.  In most cases, relative mode will be more convenient.
  35
  36 @menu
  37 * Absolute octave entry::
  38 * Relative octave entry::
  39 * Accidentals::
  40 * Note names in other languages::
  41 @end menu
  42
  43
  44 @node Absolute octave entry
  45 @unnumberedsubsubsec Absolute octave entry
  46
  47 @cindex pitch names
  48 @cindex pitches
  49 @cindex absolute
  50 @cindex absolute octave specification
  51 @cindex octave specification, absolute
  52 @cindex absolute octave entry
  53 @cindex octave entry, absolute
  54
  55 A pitch name is specified using lowercase letters@tie{}@code{a}
  56 through@tie{}@code{g}.  The note names @code{c} to @code{b} are
  57 engraved in the octave below middle C.
  58
  59 @c don't use c' here.
  60 @lilypond[verbatim,quote]
  61 {
  62   \clef bass
  63   c4 d e f
  64   g4 a b c
  65   d4 e f g
  66 }
  67 @end lilypond
  68
  69 @cindex octave changing mark
  70
  71 @funindex '
  72 @funindex ,
  73
  74 Other octaves may be specified with a single quote@tie{}(@code{'})
  75 or comma@tie{}(@code{,}) character.  Each@tie{}@code{'} raises the
  76 pitch by one octave; each@tie{}@code{,} lowers the pitch by an
  77 octave.
  78
  79 @lilypond[verbatim,quote]
  80 {
  81   \clef treble
  82   c'4 e' g' c''
  83   c'4 g b c'
  84   \clef bass
  85   c,4 e, g, c
  86   c,4 g,, b,, c,
  87 }
  88 @end lilypond
  89
  90 @funindex \fixed
  91 Common octave marks can be entered just once on a reference pitch
  92 after @code{\fixed} placed before the music.  Pitches inside
  93 @code{\fixed} only need @code{'} or@tie{}@code{,} marks
  94 when they are above or below the octave of the reference pitch.
  95
  96 @lilypond[verbatim,quote]
  97 {
  98   \fixed c' {
  99     \clef treble
 100     c4 e g c'
 101     c4 g, b, c
 102   }
 103   \clef bass
 104   \fixed c, {
 105     c4 e g c'
 106     c4 g, b, c
 107   }
 108 }
 109 @end lilypond
 110
 111 Pitches in the music expression following @code{\fixed} are
 112 unaffected by any enclosing @code{\relative}, discussed next.
 113
 114 @seealso
 115 Music Glossary:
 116 @rglos{Pitch names}.
 117
 118 Snippets:
 119 @rlsr{Pitches}.
 120
 121
 122 @node Relative octave entry
 123 @unnumberedsubsubsec Relative octave entry
 124
 125 @cindex relative
 126 @cindex relative octave entry
 127 @cindex octave entry, relative
 128 @cindex relative octave specification
 129 @cindex octave specification, relative
 130
 131 @funindex \relative
 132
 133 Absolute octave entry requires specifying the octave for every
 134 single note.  Relative octave entry, in contrast, specifies each
 135 octave in relation to the last note: changing one note's octave
 136 will affect all of the following notes.
 137
 138 Relative note mode has to be entered explicitly using the
 139 @code{\relative} command:
 140
 141 @example
 142 \relative @var{startpitch} @var{musicexpr}
 143 @end example
 144
 145 In relative mode, each note is assumed to be as close to the
 146 previous note as possible.  This means that the octave of each
 147 pitch inside @code{@var{musicexpr}} is calculated as follows:
 148
 149 @itemize
 150 @item
 151 If no octave changing mark is used on a pitch, its octave is
 152 calculated so that the interval with the previous note is less
 153 than a fifth.  This interval is determined without considering
 154 accidentals.
 155
 156 @item
 157 An octave changing mark@tie{}@code{'} or@tie{}@code{,} can be
 158 added to respectively raise or lower a pitch by an extra octave,
 159 relative to the pitch calculated without an octave mark.
 160
 161 @item
 162 Multiple octave changing marks can be used.  For example,
 163 @code{''}@tie{}and@tie{}@code{,,} will alter the pitch by two
 164 octaves.
 165
 166 @item
 167 The pitch of the first note is relative to
 168 @code{@var{startpitch}}.  @code{@var{startpitch}} is specified in
 169 absolute octave mode.  Which choices are meaningful?
 170
 171 @table @asis
 172 @item an octave of @code{c}
 173 Identifying middle C with @code{c'} is quite basic, so finding
 174 octaves of @code{c} tends to be straightforward.  If your music
 175 starts with @code{gis} above @code{c'''}, you'd write something
 176 like @code{\relative c''' @{ gis' @dots{} @}}
 177
 178 @item an octave of the first note inside
 179 Writing @code{\relative gis''' @{ gis @dots{} @}} makes it easy to
 180 determine the absolute pitch of the first note inside.
 181
 182 @item no explicit starting pitch
 183 The form @code{\relative @{ gis''' @dots{} @}} serves
 184 as a compact version of the previous option: the first note
 185 inside is written in absolute pitch itself.  (This happens to be
 186 equivalent to choosing @code{f} as the reference pitch.)
 187 @end table
 188
 189 The documentation will usually employ the last option.
 190 @end itemize
 191
 192 Here is the relative mode shown in action:
 193
 194 @lilypond[verbatim,quote]
 195 \relative {
 196   \clef bass
 197   c d e f
 198   g a b c
 199   d e f g
 200 }
 201 @end lilypond
 202
 203 Octave changing marks are used for intervals greater than a
 204 fourth:
 205
 206 @lilypond[verbatim,quote]
 207 \relative {
 208   c'' g c f,
 209   c' a, e'' c
 210 }
 211 @end lilypond
 212
 213 A note sequence without a single octave mark can nevertheless span
 214 large intervals:
 215
 216 @lilypond[verbatim,quote]
 217 \relative {
 218   c f b e
 219   a d g c
 220 }
 221 @end lilypond
 222
 223 When @code{\relative} blocks are nested, the innermost
 224 @code{\relative} block starts with its own reference pitch
 225 independently of the outer @code{\relative}.
 226
 227 @lilypond[verbatim,quote]
 228 \relative {
 229   c' d e f
 230   \relative {
 231     c'' d e f
 232   }
 233 }
 234 @end lilypond
 235
 236 @code{\relative} has no effect on @code{\chordmode} blocks.
 237
 238 @lilypond[verbatim,quote]
 239 \new Staff {
 240   \relative c''' {
 241     \chordmode { c1 }
 242   }
 243   \chordmode { c1 }
 244 }
 245 @end lilypond
 246
 247 @code{\relative} is not allowed inside of @code{\chordmode} blocks.
 248
 249 Music inside a @code{\transpose} block is absolute unless a
 250 @code{\relative} is included.
 251
 252 @lilypond[verbatim,quote]
 253 \relative {
 254   d' e
 255   \transpose f g {
 256     d e
 257     \relative {
 258       d' e
 259     }
 260   }
 261 }
 262 @end lilypond
 263
 264
 265 @cindex chords and relative octave entry
 266 @cindex relative octave entry and chords
 267
 268 If the preceding item is a chord, the first note of the chord is
 269 used as the reference point for the octave placement of a
 270 following note or chord.  Inside chords, the next note is always
 271 relative to the preceding one.  Examine the next example
 272 carefully, paying attention to the @code{c} notes.
 273
 274 @lilypond[verbatim,quote]
 275 \relative {
 276   c'
 277   <c e g>
 278   <c' e g'>
 279   <c, e, g''>
 280 }
 281 @end lilypond
 282
 283 As explained above, the octave of pitches is calculated only with
 284 the note names, regardless of any alterations.  Therefore, an
 285 E-double-sharp following a B will be placed higher, while an
 286 F-double-flat will be placed lower.  In other words, a
 287 double-augmented fourth is considered a smaller interval than a
 288 double-diminished fifth, regardless of the number of semitones
 289 that each interval contains.
 290
 291 @lilypond[verbatim,quote]
 292 \relative {
 293   c''2 fis
 294   c2 ges
 295   b2 eisis
 296   b2 feses
 297 }
 298 @end lilypond
 299
 300
 301 @seealso
 302 Music Glossary:
 303 @rglos{fifth},
 304 @rglos{interval},
 305 @rglos{Pitch names}.
 306
 307 Notation Reference:
 308 @ref{Octave checks}.
 309
 310 Snippets:
 311 @rlsr{Pitches}.
 312
 313 Internals Reference:
 314 @rinternals{RelativeOctaveMusic}.
 315
 316 @cindex relative octave entry and transposition
 317 @cindex transposition and relative octave entry
 318
 319 @funindex \transpose
 320 @funindex \chordmode
 321 @funindex \relative
 322
 323
 324 @node Accidentals
 325 @unnumberedsubsubsec Accidentals
 326
 327 @cindex accidental
 328 @cindex key signature
 329 @cindex clef
 330
 331 @c duplicated in Key signature and Accidentals
 332 @warning{New users are sometimes confused about accidentals and
 333 key signatures.  In LilyPond, note names specify pitches; key
 334 signatures and clefs determine how these pitches are displayed.
 335 An unaltered note like@tie{}@code{c} means @q{C natural},
 336 regardless of the key signature or clef.  For more information,
 337 see @rlearning{Pitches and key signatures}.}
 338
 339 @cindex note names, Dutch
 340 @cindex note names, default
 341 @cindex default note names
 342 @cindex sharp
 343 @cindex flat
 344 @cindex double sharp
 345 @cindex sharp, double
 346 @cindex double flat
 347 @cindex flat, double
 348 @cindex natural sign
 349 @cindex natural pitch
 350
 351 A @notation{sharp} pitch is made by adding @code{is} to the note
 352 name, and a @notation{flat} pitch by adding @code{es}.  As you
 353 might expect, a @notation{double sharp} or @notation{double flat}
 354 is made by adding @code{isis} or @code{eses}.  This syntax is
 355 derived from Dutch note naming conventions.  To use other names
 356 for accidentals, see @ref{Note names in other languages}.
 357
 358 @lilypond[verbatim,quote,fragment]
 359 \relative c'' { ais1 aes aisis aeses }
 360 @end lilypond
 361
 362 A natural pitch is entered as a simple note name; no suffix is
 363 required.  A natural sign will be printed when needed to cancel
 364 the effect of an earlier accidental or key signature.
 365
 366 @lilypond[verbatim,quote,fragment]
 367 \relative c'' { a4 aes a2 }
 368 @end lilypond
 369
 370 @cindex quarter tones
 371 @cindex semi-flats
 372 @cindex semi-sharps
 373
 374 Quarter tones may be added; the following is a series of Cs with
 375 increasing pitches:
 376
 377 @lilypond[verbatim,quote,fragment]
 378 \relative c'' { ceseh1 ces ceh c cih cis cisih }
 379 @end lilypond
 380
 381
 382
 383 @cindex accidental, reminder
 384 @cindex accidental, cautionary
 385 @cindex accidental, parenthesized
 386 @cindex reminder accidental
 387 @cindex cautionary accidental
 388 @cindex parenthesized accidental
 389
 390 @funindex ?
 391 @funindex !
 392
 393
 394 Normally accidentals are printed automatically, but you may also
 395 print them manually.  A reminder accidental can be forced by
 396 adding an exclamation mark@tie{}@code{!} after the pitch.  A
 397 cautionary accidental (i.e., an accidental within parentheses) can
 398 be obtained by adding the question mark@tie{}@code{?} after the
 399 pitch.
 400
 401 @lilypond[verbatim,quote,fragment]
 402 \relative c'' { cis cis cis! cis? c c c! c? }
 403 @end lilypond
 404
 405 @cindex accidental on tied note
 406 @cindex tied note, accidental
 407
 408 Accidentals on tied notes are only printed at the beginning of a
 409 new system:
 410
 411 @lilypond[verbatim,quote,fragment,ragged-right]
 412 \relative c'' {
 413   cis1~ 1~
 414   \break
 415   cis
 416 }
 417 @end lilypond
 418
 419
 420 @snippets
 421
 422 @lilypondfile[verbatim,quote,texidoc,doctitle,ragged-right]
 423 {hiding-accidentals-on-tied-notes-at-the-start-of-a-new-system.ly}
 424
 425 @lilypondfile[verbatim,quote,texidoc,doctitle]
 426 {preventing-extra-naturals-from-being-automatically-added.ly}
 427
 428 @seealso
 429 Music Glossary:
 430 @rglos{sharp},
 431 @rglos{flat},
 432 @rglos{double sharp},
 433 @rglos{double flat},
 434 @rglos{Pitch names},
 435 @rglos{quarter tone}.
 436
 437 Learning Manual:
 438 @rlearning{Pitches and key signatures}.
 439
 440 Notation Reference:
 441 @ref{Automatic accidentals},
 442 @ref{Annotational accidentals (musica ficta)},
 443 @ref{Note names in other languages}.
 444
 445 Snippets:
 446 @rlsr{Pitches}.
 447
 448 Internals Reference:
 449 @rinternals{Accidental_engraver},
 450 @rinternals{Accidental},
 451 @rinternals{AccidentalCautionary},
 452 @rinternals{accidental-interface}.
 453
 454 @cindex accidental, quarter-tone
 455 @cindex quarter-tone accidental
 456
 457 @knownissues
 458 There are no generally accepted standards for denoting
 459 quarter-tone accidentals, so LilyPond's symbols do not conform to
 460 any standard.
 461
 462
 463 @node Note names in other languages
 464 @unnumberedsubsubsec Note names in other languages
 465
 466 @cindex note names, other languages
 467 @cindex pitch names, other languages
 468 @cindex language, note names in other
 469 @cindex language, pitch names in other
 470
 471 There are predefined sets of note and accidental names for various
 472 other languages.  Selecting the note name language is usually done
 473 at the beginning of the file; the following example is written
 474 using Italian note names:
 475
 476 @lilypond[quote,verbatim]
 477 \language "italiano"
 478
 479 \relative {
 480   do' re mi sib
 481 }
 482 @end lilypond
 483
 484 The available languages and the note names they define are:
 485
 486 @quotation
 487 @multitable {@code{nederlands}} {do re/re mi fa sol la sib si}
 488 @headitem Language
 489   @tab Note Names
 490 @item @code{nederlands}
 491   @tab c d e f g a bes b
 492 @item @code{catalan}
 493   @tab do re mi fa sol la sib si
 494 @item @code{deutsch}
 495   @tab c d e f g a b h
 496 @item @code{english}
 497   @tab c d e f g a bf b
 498 @item @code{espanol} or @code{español}
 499   @tab do re mi fa sol la sib si
 500 @item @code{français}
 501   @tab do ré/re mi fa sol la sib si
 502 @item @code{italiano}
 503   @tab do re mi fa sol la sib si
 504 @item @code{norsk}
 505   @tab c d e f g a b h
 506 @item @code{portugues}
 507   @tab do re mi fa sol la sib si
 508 @item @code{suomi}
 509   @tab c d e f g a b h
 510 @item @code{svenska}
 511   @tab c d e f g a b h
 512 @item @code{vlaams}
 513   @tab do re mi fa sol la sib si
 514 @end multitable
 515 @end quotation
 516
 517 In addition to note names, accidental suffixes may
 518 also vary depending on the language:
 519
 520 @quotation
 521 @multitable {@code{nederlands}} {-@code{s}/-@code{-sharp}} {-@code{f}/-@code{-flat}} {-@code{ss}/-@code{x}/-@code{-sharpsharp}} {-@code{ff}/-@code{-flatflat}}
 522 @headitem Language
 523   @tab sharp @tab flat @tab double sharp @tab double flat
 524 @item @code{nederlands}
 525   @tab -@code{is} @tab -@code{es} @tab -@code{isis} @tab -@code{eses}
 526 @item @code{catalan}
 527   @tab -@code{d}/-@code{s} @tab -@code{b} @tab -@code{dd}/-@code{ss} @tab -@code{bb}
 528 @item @code{deutsch}
 529   @tab -@code{is} @tab -@code{es} @tab -@code{isis} @tab -@code{eses}
 530 @item @code{english}
 531   @tab -@code{s}/-@code{-sharp} @tab -@code{f}/-@code{-flat} @tab -@code{ss}/-@code{x}/-@code{-sharpsharp}
 532     @tab -@code{ff}/-@code{-flatflat}
 533 @item @code{espanol} or @code{español}
 534   @tab -@code{s} @tab -@code{b} @tab -@code{ss}/-@code{x} @tab -@code{bb}
 535 @item @code{français}
 536   @tab -@code{d} @tab -@code{b} @tab -@code{dd}/-@code{x} @tab -@code{bb}
 537 @item @code{italiano}
 538   @tab -@code{d} @tab -@code{b} @tab -@code{dd} @tab -@code{bb}
 539 @item @code{norsk}
 540   @tab -@code{iss}/-@code{is} @tab -@code{ess}/-@code{es} @tab -@code{ississ}/-@code{isis}
 541     @tab -@code{essess}/-@code{eses}
 542 @item @code{portugues}
 543   @tab -@code{s} @tab -@code{b} @tab -@code{ss} @tab -@code{bb}
 544 @item @code{suomi}
 545   @tab -@code{is} @tab -@code{es} @tab -@code{isis} @tab -@code{eses}
 546 @item @code{svenska}
 547   @tab -@code{iss} @tab -@code{ess} @tab -@code{ississ} @tab -@code{essess}
 548 @item @code{vlaams}
 549   @tab -@code{k} @tab -@code{b} @tab -@code{kk} @tab -@code{bb}
 550 @end multitable
 551 @end quotation
 552
 553 In Dutch, @code{aes} is contracted to @code{as}, but both forms
 554 are accepted in LilyPond.  Similarly, both @code{es} and
 555 @code{ees} are accepted.  This also applies to
 556 @code{aeses}@tie{}/@tie{}@code{ases} and
 557 @code{eeses}@tie{}/@tie{}@code{eses}.  Sometimes only these
 558 contracted names are defined in the corresponding language files.
 559
 560 @lilypond[verbatim,quote,fragment]
 561 \relative c'' { a2 as e es a ases e eses }
 562 @end lilypond
 563
 564
 565 @cindex microtones
 566 @cindex semi-sharp
 567 @cindex semi-flat
 568 @cindex sesqui-sharp
 569 @cindex sesqui-flat
 570
 571 Some music uses microtones whose alterations are fractions of a
 572 @q{normal} sharp or flat.  The following table lists note names
 573 for quarter-tone accidentals in various languages; here the prefixes
 574 @notation{semi-} and @notation{sesqui-} respectively
 575 mean @q{half} and @q{one and a half}.  Languages that do not
 576 appear in this table do not provide special note names yet.
 577
 578 @quotation
 579 @multitable {@code{nederlands}} {@b{semi-sharp}} {@b{semi-flat}} {@b{sesqui-sharp}} {@b{sesqui-flat}}
 580 @headitem Language
 581   @tab semi-sharp @tab semi-flat @tab sesqui-sharp @tab sesqui-flat
 582
 583 @item @code{nederlands}
 584   @tab -ih @tab -eh @tab -isih @tab -eseh
 585 @item @code{deutsch}
 586   @tab -ih @tab -eh @tab -isih @tab -eseh
 587 @item @code{english}
 588   @tab -qs @tab -qf @tab -tqs @tab -tqf
 589 @item @code{espanol} or @code{español}
 590   @tab -cs @tab -cb @tab -tcs @tab -tcb
 591 @item @code{français}
 592   @tab -sd @tab -sb @tab -dsd @tab -bsb
 593 @item @code{italiano}
 594   @tab -sd @tab -sb @tab -dsd @tab -bsb
 595 @item @code{portugues}
 596   @tab -sqt @tab -bqt @tab -stqt @tab -btqt
 597 @end multitable
 598 @end quotation
 599
 600 Most languages presented here are commonly associated with
 601 Western classical music, also referred to as
 602 @notation{Common Practice Period}.  However, alternate
 603 pitches and tuning systems are also supported: see
 604 @ref{Common notation for non-Western music}.
 605
 606 @seealso
 607 Music Glossary:
 608 @rglos{Pitch names},
 609 @rglos{Common Practice Period}.
 610
 611 Notation Reference:
 612 @ref{Common notation for non-Western music}.
 613
 614 Installed Files:
 615 @file{scm/define-note-names.scm}.
 616
 617 Snippets:
 618 @rlsr{Pitches}.
 619
 620
 621 @node Changing multiple pitches
 622 @subsection Changing multiple pitches
 623
 624 This section discusses how to modify pitches.
 625
 626 @menu
 627 * Octave checks::
 628 * Transpose::
 629 * Inversion::
 630 * Retrograde::
 631 * Modal transformations::
 632 @end menu
 633
 634 @node Octave checks
 635 @unnumberedsubsubsec Octave checks
 636
 637 @cindex octave correction
 638 @cindex octave check
 639 @cindex control pitch
 640
 641 @funindex =
 642 @funindex \octaveCheck
 643 @funindex controlpitch
 644
 645 In relative mode, it is easy to forget an octave changing mark.
 646 Octave checks make such errors easier to find by displaying a
 647 warning and correcting the octave if a note is found in an
 648 unexpected octave.
 649
 650 To check the octave of a note, specify the absolute octave after
 651 the @code{=}@tie{}symbol.  This example will generate a warning
 652 (and change the pitch) because the second note is the absolute
 653 octave @code{d''} instead of @code{d'} as indicated by the octave
 654 correction.
 655
 656 @lilypond[verbatim,quote]
 657 \relative {
 658   c''2 d='4 d
 659   e2 f
 660 }
 661 @end lilypond
 662
 663 The octave of notes may also be checked with the
 664 @code{\octaveCheck@tie{}@var{controlpitch}} command.
 665 @code{@var{controlpitch}} is specified in absolute mode.  This
 666 checks that the interval between the previous note and the
 667 @code{@var{controlpitch}} is within a fourth (i.e., the normal
 668 calculation of relative mode).  If this check fails, a warning is
 669 printed.  While the previous note itself is not changed, future
 670 notes are relative to the corrected value.
 671
 672 @lilypond[verbatim,quote]
 673 \relative {
 674   c''2 d
 675   \octaveCheck c'
 676   e2 f
 677 }
 678 @end lilypond
 679
 680 Compare the two bars below.  The first and third @code{\octaveCheck}
 681 checks fail, but the second one does not fail.
 682
 683 @lilypond[verbatim,quote]
 684 \relative {
 685   c''4 f g f
 686
 687   c4
 688   \octaveCheck c'
 689   f
 690   \octaveCheck c'
 691   g
 692   \octaveCheck c'
 693   f
 694 }
 695 @end lilypond
 696
 697 @seealso
 698 Snippets:
 699 @rlsr{Pitches}.
 700
 701 Internals Reference:
 702 @rinternals{RelativeOctaveCheck}.
 703
 704
 705 @node Transpose
 706 @unnumberedsubsubsec Transpose
 707
 708 @cindex transpose
 709 @cindex transposing
 710 @cindex transposition
 711 @cindex transposition of pitches
 712 @cindex transposition of notes
 713 @cindex pitches, transposition of
 714 @cindex notes, transposition of
 715
 716 @funindex \transpose
 717
 718 A music expression can be transposed with @code{\transpose}.  The
 719 syntax is
 720
 721 @example
 722 \transpose @var{frompitch} @var{topitch} @var{musicexpr}
 723 @end example
 724
 725 @noindent
 726 This means that @code{@var{musicexpr}} is transposed by the
 727 interval between the pitches @code{@var{frompitch}} and
 728 @code{@var{topitch}}: any note with pitch @code{@var{frompitch}}
 729 is changed to @code{@var{topitch}} and any other note is
 730 transposed by the same interval.  Both pitches are entered in
 731 absolute mode.
 732
 733 @warning{Music inside a @code{@bs{}transpose} block is absolute
 734 unless a @code{@bs{}relative} is included in the block.}
 735
 736 Consider a piece written in the key of D-major.  It can be
 737 transposed up to E-major; note that the key signature is
 738 automatically transposed as well.
 739
 740 @lilypond[verbatim,quote]
 741 \transpose d e {
 742   \relative {
 743     \key d \major
 744     d'4 fis a d
 745   }
 746 }
 747 @end lilypond
 748
 749 @cindex transposing instruments
 750 @cindex instruments, transposing
 751
 752 If a part written in C (normal @notation{concert pitch}) is to be
 753 played on the A clarinet (for which an A is notated as a C and
 754 thus sounds a minor third lower than notated), the appropriate
 755 part will be produced with:
 756
 757 @lilypond[verbatim,quote]
 758 \transpose a c' {
 759   \relative {
 760     \key c \major
 761     c'4 d e g
 762   }
 763 }
 764 @end lilypond
 765
 766 @noindent
 767 Note that we specify @w{@code{\key c \major}} explicitly.  If we
 768 do not specify a key signature, the notes will be transposed but
 769 no key signature will be printed.
 770
 771 @code{\transpose} distinguishes between enharmonic pitches: both
 772 @w{@code{\transpose c cis}} or @w{@code{\transpose c des}} will
 773 transpose up a semitone.  The first version will print sharps and
 774 the notes will remain on the same scale step, the second version
 775 will print flats on the scale step above.
 776
 777 @lilypond[verbatim,quote]
 778 music = \relative { c' d e f }
 779 \new Staff {
 780   \transpose c cis { \music }
 781   \transpose c des { \music }
 782 }
 783 @end lilypond
 784
 785
 786 @code{\transpose} may also be used in a different way, to input
 787 written notes for a transposing instrument.  The previous examples
 788 show how to enter pitches in C (or @notation{concert pitch}) and
 789 typeset them for a transposing instrument, but the opposite is
 790 also possible if you for example have a set of instrumental parts
 791 and want to print a conductor's score.  For example, when entering
 792 music for a B-flat trumpet that begins on a notated E (concert D),
 793 one would write:
 794
 795 @example
 796 musicInBflat = @{ e4 @dots{} @}
 797 \transpose c bes, \musicInBflat
 798 @end example
 799
 800 @noindent
 801 To print this music in F (e.g., rearranging to a French horn) you
 802 could wrap the existing music with another @code{\transpose}:
 803
 804 @example
 805 musicInBflat = @{ e4 @dots{} @}
 806 \transpose f c' @{ \transpose c bes, \musicInBflat @}
 807 @end example
 808
 809 @noindent
 810 For more information about transposing instruments,
 811 see @ref{Instrument transpositions}.
 812
 813
 814 @snippets
 815
 816 @lilypondfile[verbatim,quote,texidoc,doctitle]
 817 {transposing-pitches-with-minimum-accidentals-smart-transpose.ly}
 818
 819 @seealso
 820 Notation Reference:
 821 @ref{Instrument transpositions},
 822 @ref{Inversion},
 823 @ref{Modal transformations},
 824 @ref{Relative octave entry},
 825 @ref{Retrograde}.
 826
 827 Snippets:
 828 @rlsr{Pitches}.
 829
 830 Internals Reference:
 831 @rinternals{TransposedMusic}.
 832
 833 @funindex \transpose
 834 @funindex \chordmode
 835 @funindex \relative
 836
 837 @knownissues
 838 The relative conversion will not affect @code{\transpose},
 839 @code{\chordmode} or @code{\relative} sections in its argument.  To use
 840 relative mode within transposed music, an additional @code{\relative}
 841 must be placed inside @code{\transpose}.
 842
 843 Triple accidentals will not be printed if using @code{\transpose}. An
 844 @q{enharmonically equivalent} pitch will be used instead (e.g., d-flat
 845 rather than e-triple-flat).
 846
 847
 848 @node Inversion
 849 @unnumberedsubsubsec Inversion
 850
 851 @cindex inversion
 852 @cindex operation, inversion
 853 @funindex \inversion
 854
 855 A music expression can be inverted and transposed in a single
 856 operation with:
 857
 858 @example
 859 \inversion @var{around-pitch} @var{to-pitch} @var{musicexpr}
 860 @end example
 861
 862 The @code{@var{musicexpr}} is inverted interval-by-interval around
 863 @code{@var{around-pitch}}, and then transposed so that
 864 @code{@var{around-pitch}} is mapped to @code{@var{to-pitch}}.
 865
 866 @lilypond[verbatim,quote]
 867 music = \relative { c' d e f }
 868 \new Staff {
 869   \music
 870   \inversion d' d' \music
 871   \inversion d' ees' \music
 872 }
 873 @end lilypond
 874
 875 @warning{Motifs to be inverted should be expressed in absolute form
 876 or be first converted to absolute form by enclosing them in a
 877 @code{\relative} block.}
 878
 879 @seealso
 880 Notation Reference:
 881 @ref{Modal transformations},
 882 @ref{Retrograde},
 883 @ref{Transpose}.
 884
 885
 886 @node Retrograde
 887 @unnumberedsubsubsec Retrograde
 888
 889 @cindex retrograde transformation
 890 @cindex transformation, retrograde
 891 @cindex operation, retrograde
 892 @funindex \retrograde
 893
 894 A music expression can be reversed to produce its retrograde:
 895
 896 @lilypond[verbatim,quote]
 897 music = \relative { c'8. ees16( fis8. a16 b8.) gis16 f8. d16 }
 898
 899 \new Staff {
 900   \music
 901   \retrograde \music
 902 }
 903 @end lilypond
 904
 905 @knownissues
 906 @code{\retrograde} is a rather simple tool.  Since many events are
 907 @q{mirrored} rather than exchanged, tweaks and directional
 908 modifiers for opening spanners need to be added at the matching
 909 closing spanners: @code{^(} needs to be ended by @code{^)}, every
 910 @code{\<} or @code{\cresc} needs to be ended by @code{\!} or
 911 @code{\endcr}, every @code{\>} or @code{\decr} needs to be ended
 912 by @code{\enddecr}.  Property-changing commands/overrides with a
 913 lasting effect will likely cause surprises.
 914
 915 @seealso
 916 Notation Reference:
 917 @ref{Inversion},
 918 @ref{Modal transformations},
 919 @ref{Transpose}.
 920
 921
 922 @node Modal transformations
 923 @unnumberedsubsubsec Modal transformations
 924
 925 @cindex modal transformations
 926 @cindex transformations, modal
 927 @cindex operations, modal
 928
 929 In a musical composition that is based on a scale, a motif is
 930 frequently transformed in various ways.  It may be
 931 @notation{transposed} to start at different places in the scale or
 932 it may be @notation{inverted} around a pivot point in the scale.
 933 It may also be reversed to produce its @notation{retrograde}, see
 934 @ref{Retrograde}.
 935
 936 @warning{Any note that does not lie within the given scale will be
 937 left untransformed.}
 938
 939 @subsubsubheading Modal transposition
 940
 941 @cindex modal transposition
 942 @cindex transposition, modal
 943 @cindex operation, transposition
 944 @funindex \modalTranspose
 945
 946 A motif can be transposed within a given scale with:
 947
 948 @example
 949 \modalTranspose @var{from-pitch} @var{to-pitch} @var{scale} @var{motif}
 950 @end example
 951
 952 The notes of @var{motif} are shifted within the @var{scale} by the
 953 number of scale degrees given by the interval between @var{to-pitch}
 954 and @var{from-pitch}:
 955
 956 @lilypond[verbatim,quote]
 957 diatonicScale = \relative { c' d e f g a b }
 958 motif = \relative { c'8 d e f g a b c }
 959
 960 \new Staff {
 961   \motif
 962   \modalTranspose c f \diatonicScale \motif
 963   \modalTranspose c b, \diatonicScale \motif
 964 }
 965 @end lilypond
 966
 967 An ascending scale of any length and with any intervals may be
 968 specified:
 969
 970 @lilypond[verbatim,quote]
 971 pentatonicScale = \relative { ges aes bes des ees }
 972 motif = \relative { ees'8 des ges,4 <ges' bes,> <ges bes,> }
 973
 974 \new Staff {
 975   \motif
 976   \modalTranspose ges ees' \pentatonicScale \motif
 977 }
 978 @end lilypond
 979
 980 When used with a chromatic scale @code{\modalTranspose} has a
 981 similar effect to @code{\transpose}, but with the ability to
 982 specify the names of the notes to be used:
 983
 984 @lilypond[verbatim,quote]
 985 chromaticScale = \relative { c' cis d dis e f fis g gis a ais b }
 986 motif = \relative { c'8 d e f g a b c }
 987
 988 \new Staff {
 989   \motif
 990   \transpose c f \motif
 991   \modalTranspose c f \chromaticScale \motif
 992 }
 993 @end lilypond
 994
 995 @subsubsubheading Modal inversion
 996
 997 @cindex modal inversion
 998 @cindex inversion, modal
 999 @cindex operation, modal inversion
1000 @funindex \modalInversion
1001
1002 A motif can be inverted within a given scale around a given pivot
1003 note and transposed in a single operation with:
1004
1005 @example
1006 \modalInversion @var{around-pitch} @var{to-pitch} @var{scale} @var{motif}
1007 @end example
1008
1009 The notes of @var{motif} are placed the same number of scale degrees
1010 from the @var{around-pitch} note within the @var{scale}, but in the
1011 opposite direction, and the result is then shifted within the
1012 @var{scale} by the number of scale degrees given by the interval between
1013 @var{to-pitch} and @var{around-pitch}.
1014
1015 So to simply invert around a note in the scale use the same value for
1016 @var{around-pitch} and @var{to-pitch}:
1017
1018 @lilypond[verbatim,quote]
1019 octatonicScale = \relative { ees' f fis gis a b c d }
1020 motif = \relative { c'8. ees16 fis8. a16 b8. gis16 f8. d16 }
1021
1022 \new Staff {
1023   \motif
1024   \modalInversion fis' fis' \octatonicScale \motif
1025 }
1026 @end lilypond
1027
1028 To invert around a pivot between two notes in the scale, invert around
1029 one of the notes and then transpose by one scale degree.  The two notes
1030 specified can be interpreted as bracketing the pivot point:
1031
1032 @lilypond[verbatim,quote]
1033 scale = \relative { c' g' }
1034 motive = \relative { c' c g' c, }
1035
1036 \new Staff {
1037   \motive
1038   \modalInversion c' g' \scale \motive
1039 }
1040 @end lilypond
1041
1042 The combined operation of inversion and retrograde produce the
1043 retrograde-inversion:
1044
1045 @lilypond[verbatim,quote]
1046 octatonicScale = \relative { ees' f fis gis a b c d }
1047 motif = \relative { c'8. ees16 fis8. a16 b8. gis16 f8. d16 }
1048
1049 \new Staff {
1050   \motif
1051   \retrograde \modalInversion c' c' \octatonicScale \motif
1052 }
1053 @end lilypond
1054
1055 @seealso
1056 Notation Reference:
1057 @ref{Inversion},
1058 @ref{Retrograde},
1059 @ref{Transpose}.
1060
1061
1062 @node Displaying pitches
1063 @subsection Displaying pitches
1064
1065 This section discusses how to alter the output of pitches.
1066
1067 @menu
1068 * Clef::
1069 * Key signature::
1070 * Ottava brackets::
1071 * Instrument transpositions::
1072 * Automatic accidentals::
1073 * Ambitus::
1074 @end menu
1075
1076
1077 @node Clef
1078 @unnumberedsubsubsec Clef
1079
1080 @cindex G clef
1081 @cindex C clef
1082 @cindex F clef
1083 @cindex treble clef
1084 @cindex violin clef
1085 @cindex alto clef
1086 @cindex tenor clef
1087 @cindex bass clef
1088 @cindex french clef
1089 @cindex soprano clef
1090 @cindex mezzosoprano clef
1091 @cindex baritone clef
1092 @cindex varbaritone clef
1093 @cindex subbass clef
1094 @cindex clef
1095 @cindex ancient clef
1096 @cindex clef, ancient
1097 @cindex clef, G
1098 @cindex clef, C
1099 @cindex clef, F
1100 @cindex clef, treble
1101 @cindex clef, violin
1102 @cindex clef, alto
1103 @cindex clef, tenor
1104 @cindex clef, bass
1105 @cindex clef, french
1106 @cindex clef, soprano
1107 @cindex clef, mezzosoprano
1108 @cindex clef, baritone
1109 @cindex clef, varbaritone
1110 @cindex clef, subbass
1111
1112
1113 @funindex \clef
1114
1115 Without any explicit command, the default clef for LilyPond is the
1116 treble (or @emph{G}) clef.
1117
1118 @lilypond[verbatim,quote,fragment,ragged-right]
1119 c'2 c'
1120 @end lilypond
1121
1122 However, the clef can be changed by using the @code{\clef} command and
1123 an appropriate clef name.  @emph{Middle C} is shown in each of the
1124 following examples.
1125
1126 @lilypond[verbatim,quote,fragment]
1127 \clef treble
1128 c'2 c'
1129 \clef alto
1130 c'2 c'
1131 \clef tenor
1132 c'2 c'
1133 \clef bass
1134 c'2 c'
1135 @end lilypond
1136
1137 For the full range of possible clef names see @ref{Clef styles}.
1138
1139 Specialized clefs, such as those used in @emph{Ancient} music, are
1140 described in @ref{Mensural clefs} and @ref{Gregorian clefs}.  Music that
1141 requires tablature clefs is discussed in @ref{Default tablatures} and
1142 @ref{Custom tablatures}.
1143
1144 @cindex Cue clefs
1145 @cindex Clefs with cue notes
1146 For mixing clefs when using cue notes, see the @code{\cueClef} and
1147 @code{\cueDuringWithClef} commands in @ref{Formatting cue notes}.
1148
1149 @cindex transposing clef
1150 @cindex clef, transposing
1151 @cindex octave transposition
1152 @cindex optional octave transposition
1153 @cindex octave transposition, optional
1154 @cindex choral tenor clef
1155 @cindex tenor clef, choral
1156
1157 By adding@tie{}@code{_8} or@tie{}@code{^8} to the clef name, the
1158 clef is transposed one octave down or up respectively,
1159 and@tie{}@code{_15} and@tie{}@code{^15} transpose by two octaves.
1160 Other integers can be used if required.  Clef names containing
1161 non-alphabetic characters must be enclosed in quotes
1162
1163 @lilypond[verbatim,quote,fragment]
1164 \clef treble
1165 c'2 c'
1166 \clef "treble_8"
1167 c'2 c'
1168 \clef "bass^15"
1169 c'2 c'
1170 \clef "alto_2"
1171 c'2 c'
1172 \clef "G_8"
1173 c'2 c'
1174 \clef "F^5"
1175 c'2 c'
1176 @end lilypond
1177
1178 Optional octavation can be obtained by enclosing the numeric
1179 argument in parentheses or brackets:
1180
1181 @lilypond[verbatim,quote,fragment]
1182 \clef "treble_(8)"
1183 c'2 c'
1184 \clef "bass^[15]"
1185 c'2 c'
1186 @end lilypond
1187
1188 The pitches are displayed as if the numeric argument were
1189 given without parentheses/brackets.
1190
1191 By default, a clef change taking place at a line break will cause
1192 the new clef symbol to be printed at the end of the previous line,
1193 as a @emph{warning} clef, as well as the beginning of the next.
1194 This @emph{warning} clef can be suppressed.
1195
1196 @lilypond[verbatim,quote,fragment]
1197 \clef treble { c'2 c' } \break
1198 \clef bass { c'2 c' } \break
1199 \clef alto
1200   \set Staff.explicitClefVisibility = #end-of-line-invisible
1201   { c'2 c' } \break
1202   \unset Staff.explicitClefVisibility
1203 \clef bass { c'2 c' } \break
1204 @end lilypond
1205
1206 By default, a clef that has previously been printed will not be
1207 re-printed if the same @code{\clef} command is issued again and
1208 will be ignored.  The command
1209 @code{\set Staff.forceClef = ##t} changes this behaviour.
1210
1211 @lilypond[verbatim,quote,fragment]
1212   \clef treble
1213   c'1
1214   \clef treble
1215   c'1
1216   \set Staff.forceClef = ##t
1217   c'1
1218   \clef treble
1219   c'1
1220 @end lilypond
1221
1222 @noindent
1223 To be more precise, it is not the @code{\clef} command itself that
1224 prints a clef.  Instead, it sets or changes a property of the
1225 @code{Clef_engraver}, which then decides by its own whether to
1226 display a clef or not in the current staff.  The @code{forceClef}
1227 property overrides this decision locally to re-print a clef once.
1228
1229 When there is a manual clef change, the glyph of the changed clef
1230 will be smaller than normal.  This behaviour can be overridden.
1231
1232 @lilypond[verbatim,quote,fragment]
1233   \clef "treble"
1234   c'1
1235   \clef "bass"
1236   c'1
1237   \clef "treble"
1238   c'1
1239   \override Staff.Clef.full-size-change = ##t
1240   \clef "bass"
1241   c'1
1242   \clef "treble"
1243   c'1
1244   \revert Staff.Clef.full-size-change
1245   \clef "bass"
1246   c'1
1247   \clef "treble"
1248   c'1
1249 @end lilypond
1250
1251 @snippets
1252 @lilypondfile[verbatim,quote,texidoc,doctitle]
1253 {tweaking-clef-properties.ly}
1254
1255 @seealso
1256 Notation Reference:
1257 @ref{Mensural clefs},
1258 @ref{Gregorian clefs},
1259 @ref{Default tablatures},
1260 @ref{Custom tablatures},
1261 @ref{Formatting cue notes}.
1262
1263 Installed Files:
1264 @file{scm/parser-clef.scm}.
1265
1266 Snippets:
1267 @rlsr{Pitches}.
1268
1269 Internals Reference:
1270 @rinternals{Clef_engraver},
1271 @rinternals{Clef},
1272 @rinternals{ClefModifier},
1273 @rinternals{clef-interface}.
1274
1275 @knownissues
1276 Ottavation numbers attached to clefs are treated as separate
1277 grobs.  So any @code{\override} done to the @var{Clef} will also
1278 need to be applied, as a separate @code{\override}, to the
1279 @var{ClefModifier} grob.
1280
1281 @lilypond[fragment,quote,verbatim]
1282 \new Staff \with {
1283   \override Clef.color = #blue
1284   \override ClefModifier.color = #red
1285 }
1286
1287 \clef "treble_8" c'4
1288 @end lilypond
1289
1290
1291 @node Key signature
1292 @unnumberedsubsubsec Key signature
1293
1294 @cindex key signature
1295
1296 @funindex \key
1297
1298 @c duplicated in Key signature and Accidentals
1299 @warning{New users are sometimes confused about accidentals and
1300 key signatures.  In LilyPond, note names are the raw input; key
1301 signatures and clefs determine how this raw input is displayed.
1302 An unaltered note like@tie{}@code{c} means @q{C natural},
1303 regardless of the key signature or clef.  For more information,
1304 see @rlearning{Pitches and key signatures}.}
1305
1306 The key signature indicates the tonality in which a piece is
1307 played.  It is denoted by a set of alterations (flats or sharps)
1308 at the start of the staff.  The key signature may be altered:
1309
1310 @example
1311 \key @var{pitch} @var{mode}
1312 @end example
1313
1314 @funindex \major
1315 @funindex \minor
1316 @funindex \ionian
1317 @funindex \locrian
1318 @funindex \aeolian
1319 @funindex \mixolydian
1320 @funindex \lydian
1321 @funindex \phrygian
1322 @funindex \dorian
1323
1324 @cindex church modes
1325 @cindex modes
1326 @cindex major
1327 @cindex minor
1328 @cindex ionian
1329 @cindex locrian
1330 @cindex aeolian
1331 @cindex mixolydian
1332 @cindex lydian
1333 @cindex phrygian
1334 @cindex dorian
1335
1336 @noindent
1337 Here, @code{@var{mode}} should be @code{\major} or @code{\minor}
1338 to get a key signature of @code{@var{pitch}}-major or
1339 @code{@var{pitch}}-minor, respectively.  You may also use the
1340 standard mode names, also called @notation{church modes}:
1341 @code{\ionian}, @code{\dorian}, @code{\phrygian}, @code{\lydian},
1342 @code{\mixolydian}, @code{\aeolian}, and @code{\locrian}.
1343
1344 @lilypond[verbatim,quote,fragment]
1345 \relative {
1346   \key g \major
1347   fis''1
1348   f
1349   fis
1350 }
1351 @end lilypond
1352
1353 Additional modes can be defined, by listing the alterations
1354 for each scale step when the mode starts on C.
1355
1356 @lilypond[verbatim,quote]
1357 freygish = #`((0 . ,NATURAL) (1 . ,FLAT) (2 . ,NATURAL)
1358     (3 . ,NATURAL) (4 . ,NATURAL) (5 . ,FLAT) (6 . ,FLAT))
1359
1360 \relative {
1361   \key c \freygish c'4 des e f
1362   \bar "||" \key d \freygish d es fis g
1363 }
1364 @end lilypond
1365
1366 Accidentals in the key signature may be printed in octaves other
1367 than their traditional positions, or in multiple octaves, by
1368 using the @code{flat-positions} and @code{sharp-positions}
1369 properties of @code{KeySignature}.  Entries in these properties
1370 specify the range of staff-positions where accidentals will be
1371 printed.  If a single position is specified in an entry, the
1372 accidentals are placed within the octave ending at that staff
1373 position.
1374
1375 @lilypond[verbatim, quote,fragment]
1376 \override Staff.KeySignature.flat-positions = #'((-5 . 5))
1377 \override Staff.KeyCancellation.flat-positions = #'((-5 . 5))
1378 \clef bass \key es \major es g bes d'
1379 \clef treble \bar "||" \key es \major es' g' bes' d''
1380
1381 \override Staff.KeySignature.sharp-positions = #'(2)
1382 \bar "||" \key b \major b' fis' b'2
1383 @end lilypond
1384
1385 @snippets
1386
1387 @lilypondfile[verbatim,quote,texidoc,doctitle]
1388 {preventing-natural-signs-from-being-printed-when-the-key-signature-changes.ly}
1389
1390 @lilypondfile[verbatim,quote,texidoc,doctitle]
1391 {non-traditional-key-signatures.ly}
1392
1393
1394 @seealso
1395 Music Glossary:
1396 @rglos{church mode},
1397 @rglos{scordatura}.
1398
1399 Learning Manual:
1400 @rlearning{Pitches and key signatures}.
1401
1402 Snippets:
1403 @rlsr{Pitches}.
1404
1405 Internals Reference:
1406 @rinternals{KeyChangeEvent},
1407 @rinternals{Key_engraver},
1408 @rinternals{Key_performer},
1409 @rinternals{KeyCancellation},
1410 @rinternals{KeySignature},
1411 @rinternals{key-signature-interface}.
1412
1413
1414 @node Ottava brackets
1415 @unnumberedsubsubsec Ottava brackets
1416
1417 @cindex ottava
1418 @cindex 15ma
1419 @cindex 8va
1420 @cindex 8ve
1421 @cindex octavation
1422
1423 @funindex set-octavation
1424 @funindex \ottava
1425
1426 @notation{Ottava brackets} introduce an extra transposition of an
1427 octave for the staff:
1428
1429 @lilypond[verbatim,quote]
1430 \relative a' {
1431   a2 b
1432   \ottava #-2
1433   a2 b
1434   \ottava #-1
1435   a2 b
1436   \ottava #0
1437   a2 b
1438   \ottava #1
1439   a2 b
1440   \ottava #2
1441   a2 b
1442 }
1443 @end lilypond
1444
1445 @snippets
1446
1447 @lilypondfile[verbatim,quote,texidoc,doctitle]
1448 {ottava-text.ly}
1449
1450 @lilypondfile[verbatim,quote,texidoc,doctitle]
1451 {adding-an-ottava-marking-to-a-single-voice.ly}
1452
1453 @lilypondfile[verbatim,quote,texidoc,doctitle]
1454 {modifying-the-ottava-spanner-slope.ly}
1455
1456 @seealso
1457 Music Glossary:
1458 @rglos{octavation}.
1459
1460 Snippets:
1461 @rlsr{Pitches}.
1462
1463 Internals Reference:
1464 @rinternals{Ottava_spanner_engraver},
1465 @rinternals{OttavaBracket},
1466 @rinternals{ottava-bracket-interface}.
1467
1468
1469 @node Instrument transpositions
1470 @unnumberedsubsubsec Instrument transpositions
1471
1472 @cindex transposition, MIDI
1473 @cindex transposition, instrument
1474 @cindex transposing instrument
1475 @cindex MIDI
1476 @cindex MIDI transposition
1477
1478 @funindex \transposition
1479
1480 When typesetting scores that involve transposing instruments, some
1481 parts can be typeset in a different pitch than the
1482 @notation{concert pitch}.  In these cases, the key of the
1483 @notation{transposing instrument} should be specified; otherwise
1484 the MIDI output and cues in other parts will produce incorrect
1485 pitches.  For more information about quotations, see
1486 @ref{Quoting other voices}.
1487
1488 @example
1489 \transposition @var{pitch}
1490 @end example
1491
1492 The pitch to use for @code{\transposition} should correspond to
1493 the real sound heard when a@tie{}@code{c'} written on the staff is
1494 played by the transposing instrument.  This pitch is entered in
1495 absolute mode, so an instrument that produces a real sound which
1496 is one tone higher than the printed music should use
1497 @w{@code{\transposition d'}}.  @code{\transposition} should
1498 @emph{only} be used if the pitches are @emph{not} being entered in
1499 concert pitch.
1500
1501 Here are a few notes for violin and B-flat clarinet where the
1502 parts have been entered using the notes and key as they appear in
1503 each part of the conductor's score.  The two instruments are
1504 playing in unison.
1505
1506 @lilypond[verbatim,quote]
1507 \new GrandStaff <<
1508   \new Staff = "violin" {
1509     \relative c'' {
1510       \set Staff.instrumentName = #"Vln"
1511       \set Staff.midiInstrument = #"violin"
1512       % not strictly necessary, but a good reminder
1513       \transposition c'
1514
1515       \key c \major
1516       g4( c8) r c r c4
1517     }
1518   }
1519   \new Staff = "clarinet" {
1520     \relative c'' {
1521       \set Staff.instrumentName = \markup { Cl (B\flat) }
1522       \set Staff.midiInstrument = #"clarinet"
1523       \transposition bes
1524
1525       \key d \major
1526       a4( d8) r d r d4
1527     }
1528   }
1529 >>
1530 @end lilypond
1531
1532 The @code{\transposition} may be changed during a piece.  For
1533 example, a clarinetist may be required to switch from an A clarinet
1534 to a B-flat clarinet.
1535
1536 @lilypond[verbatim,quote]
1537 flute = \relative c'' {
1538   \key f \major
1539   \cueDuring #"clarinet" #DOWN {
1540     R1 _\markup\tiny "clarinet"
1541     c4 f e d
1542     R1 _\markup\tiny "clarinet"
1543   }
1544 }
1545 clarinet = \relative c'' {
1546   \key aes \major
1547   \transposition a
1548   aes4 bes c des
1549   R1^\markup { muta in B\flat }
1550   \key g \major
1551   \transposition bes
1552   d2 g,
1553 }
1554 \addQuote "clarinet" \clarinet
1555 <<
1556   \new Staff \with { instrumentName = #"Flute" }
1557     \flute
1558   \new Staff \with { instrumentName = #"Cl (A)" }
1559     \clarinet
1560 >>
1561 @end lilypond
1562
1563 @seealso
1564 Music Glossary:
1565 @rglos{concert pitch},
1566 @rglos{transposing instrument}.
1567
1568 Notation Reference:
1569 @ref{Quoting other voices},
1570 @ref{Transpose}.
1571
1572 Snippets:
1573 @rlsr{Pitches}.
1574
1575
1576 @node Automatic accidentals
1577 @unnumberedsubsubsec Automatic accidentals
1578
1579 @cindex accidental style
1580 @cindex accidental style, default
1581 @cindex accidentals
1582 @cindex accidentals, automatic
1583 @cindex automatic accidentals
1584 @cindex default accidental style
1585
1586 @funindex \accidentalStyle
1587 @funindex voice
1588 @funindex default
1589
1590 There are many different conventions on how to typeset
1591 accidentals.  LilyPond provides a function to specify which
1592 accidental style to use.  This function is called as follows:
1593
1594 @example
1595 \new Staff <<
1596   \accidentalStyle voice
1597   @{ @dots{} @}
1598 >>
1599 @end example
1600
1601 The accidental style applies to the current @code{Staff} by
1602 default (with the exception of the styles @code{piano} and
1603 @code{piano-cautionary}, which are explained below).  Optionally,
1604 the function can take a second argument that determines in which
1605 scope the style should be changed.  For example, to use the same
1606 style in all staves of the current @code{StaffGroup}, use:
1607
1608 @example
1609 \accidentalStyle StaffGroup.voice
1610 @end example
1611
1612 The following accidental styles are supported.  To demonstrate
1613 each style, we use the following example:
1614
1615
1616 @lilypond[verbatim,quote]
1617 musicA = {
1618   <<
1619     \relative {
1620       cis''8 fis, bes4 <a cis>8 f bis4 |
1621       cis2. <c, g'>4 |
1622     }
1623     \\
1624     \relative {
1625       ais'2 cis, |
1626       fis8 b a4 cis2 |
1627     }
1628   >>
1629 }
1630
1631 musicB = {
1632   \clef bass
1633   \new Voice {
1634     \voiceTwo \relative {
1635       <fis a cis>8[ <fis a cis>
1636       \change Staff = up
1637       cis' cis
1638       \change Staff = down
1639       <fis, a> <fis a>]
1640       \showStaffSwitch
1641       \change Staff = up
1642       dis'4 |
1643       \change Staff = down
1644       <fis, a cis>4 gis <f a d>2 |
1645     }
1646   }
1647 }
1648
1649 \new PianoStaff {
1650   <<
1651     \context Staff = "up" {
1652       \accidentalStyle default
1653       \musicA
1654     }
1655     \context Staff = "down" {
1656       \accidentalStyle default
1657       \musicB
1658     }
1659   >>
1660 }
1661 @end lilypond
1662
1663 Note that the last lines of this example can be replaced by the
1664 following, as long as the same accidental style should be used in
1665 both staves.
1666
1667 @example
1668 \new PianoStaff @{
1669   <<
1670     \context Staff = "up" @{
1671       %%% change the next line as desired:
1672       \accidentalStyle Score.default
1673       \musicA
1674     @}
1675     \context Staff = "down" @{
1676       \musicB
1677     @}
1678   >>
1679 @}
1680 @end example
1681
1682
1683 @c don't use verbatim in this table.
1684 @table @code
1685 @item default
1686
1687 @cindex default accidental style
1688 @cindex accidental style, default
1689
1690 @funindex default
1691
1692 This is the default typesetting behavior.  It corresponds to
1693 eighteenth-century common practice: accidentals are remembered to
1694 the end of the measure in which they occur and only in their own
1695 octave.  Thus, in the example below, no natural signs are printed
1696 before the@tie{}@code{b} in the second measure or the
1697 last@tie{}@code{c}:
1698
1699 @lilypond[quote]
1700 musicA = {
1701   <<
1702     \relative {
1703       cis''8 fis, bes4 <a cis>8 f bis4 |
1704       cis2. <c, g'>4 |
1705     }
1706     \\
1707     \relative {
1708       ais'2 cis, |
1709       fis8 b a4 cis2 |
1710     }
1711   >>
1712 }
1713
1714 musicB = {
1715   \clef bass
1716   \new Voice {
1717     \voiceTwo \relative {
1718       <fis a cis>8[ <fis a cis>
1719       \change Staff = up
1720       cis' cis
1721       \change Staff = down
1722       <fis, a> <fis a>]
1723       \showStaffSwitch
1724       \change Staff = up
1725       dis'4 |
1726       \change Staff = down
1727       <fis, a cis>4 gis <f a d>2 |
1728     }
1729   }
1730 }
1731
1732 \new PianoStaff {
1733   <<
1734     \context Staff = "up" {
1735       \accidentalStyle default
1736       \musicA
1737     }
1738     \context Staff = "down" {
1739       \accidentalStyle default
1740       \musicB
1741     }
1742   >>
1743 }
1744 @end lilypond
1745
1746 @item voice
1747
1748 @cindex accidental style, voice
1749 @cindex voice accidental style
1750 @cindex accidental style, modern
1751 @cindex modern accidental style
1752 @cindex accidental style, modern-cautionary
1753 @cindex modern-cautionary accidental style
1754
1755 @funindex voice
1756
1757 The normal behavior is to remember the accidentals at
1758 @code{Staff}-level.  In this style, however, accidentals are
1759 typeset individually for each voice.  Apart from that, the rule is
1760 similar to @code{default}.
1761
1762 As a result, accidentals from one voice do not get canceled in
1763 other voices, which is often an unwanted result: in the following
1764 example, it is hard to determine whether the second@tie{}@code{a}
1765 should be played natural or sharp.  The @code{voice} option should
1766 therefore be used only if the voices are to be read solely by
1767 individual musicians.  If the staff is to be used by one musician
1768 (e.g., a conductor or in a piano score) then @code{modern} or
1769 @code{modern-cautionary} should be used instead.
1770
1771
1772 @lilypond[quote]
1773 musicA = {
1774   <<
1775     \relative {
1776       cis''8 fis, bes4 <a cis>8 f bis4 |
1777       cis2. <c, g'>4 |
1778     }
1779     \\
1780     \relative {
1781       ais'2 cis, |
1782       fis8 b a4 cis2 |
1783     }
1784   >>
1785 }
1786
1787 musicB = {
1788   \clef bass
1789   \new Voice {
1790     \voiceTwo \relative {
1791       <fis a cis>8[ <fis a cis>
1792       \change Staff = up
1793       cis' cis
1794       \change Staff = down
1795       <fis, a> <fis a>]
1796       \showStaffSwitch
1797       \change Staff = up
1798       dis'4 |
1799       \change Staff = down
1800       <fis, a cis>4 gis <f a d>2 |
1801     }
1802   }
1803 }
1804
1805 \new PianoStaff {
1806   <<
1807     \context Staff = "up" {
1808       \accidentalStyle voice
1809       \musicA
1810     }
1811     \context Staff = "down" {
1812       \accidentalStyle voice
1813       \musicB
1814     }
1815   >>
1816 }
1817 @end lilypond
1818
1819 @item modern
1820
1821 @cindex accidentals, modern style
1822 @cindex modern style accidentals
1823
1824 @funindex modern
1825
1826 This rule corresponds to the common practice in the twentieth
1827 century.  It omits some extra natural signs, which were
1828 traditionally prefixed to a sharp following a double sharp,
1829 or a flat following a double flat.  The @code{modern} rule
1830 prints the same accidentals as @code{default}, with
1831 two additions that serve to avoid ambiguity: after temporary
1832 accidentals, cancellation marks are printed also in the following
1833 measure (for notes in the same octave) and, in the same measure,
1834 for notes in other octaves.  Hence the naturals before
1835 the@tie{}@code{b} and the@tie{}@code{c} in the second measure of
1836 the upper staff:
1837
1838 @lilypond[quote]
1839 musicA = {
1840   <<
1841     \relative {
1842       cis''8 fis, bes4 <a cis>8 f bis4 |
1843       cis2. <c, g'>4 |
1844     }
1845     \\
1846     \relative {
1847       ais'2 cis, |
1848       fis8 b a4 cis2 |
1849     }
1850   >>
1851 }
1852
1853 musicB = {
1854   \clef bass
1855   \new Voice {
1856     \voiceTwo \relative {
1857       <fis a cis>8[ <fis a cis>
1858       \change Staff = up
1859       cis' cis
1860       \change Staff = down
1861       <fis, a> <fis a>]
1862       \showStaffSwitch
1863       \change Staff = up
1864       dis'4 |
1865       \change Staff = down
1866       <fis, a cis>4 gis <f a d>2 |
1867     }
1868   }
1869 }
1870
1871 \new PianoStaff {
1872   <<
1873     \context Staff = "up" {
1874       \accidentalStyle modern
1875       \musicA
1876     }
1877     \context Staff = "down" {
1878       \accidentalStyle modern
1879       \musicB
1880     }
1881   >>
1882 }
1883 @end lilypond
1884
1885 @item modern-cautionary
1886
1887 @cindex accidentals, modern cautionary style
1888 @cindex modern accidental style
1889 @cindex modern cautionary accidental style
1890 @cindex modern style accidentals
1891 @cindex modern style cautionary accidentals
1892
1893 @funindex modern-cautionary
1894
1895 This rule is similar to @code{modern}, but the @q{extra} accidentals
1896 are printed as cautionary accidentals (with parentheses).  They can also
1897 be printed at a different size by overriding
1898 @code{AccidentalCautionary}'s @code{font-size} property.
1899
1900 @lilypond[quote]
1901 musicA = {
1902   <<
1903     \relative {
1904       cis''8 fis, bes4 <a cis>8 f bis4 |
1905       cis2. <c, g'>4 |
1906     }
1907     \\
1908     \relative {
1909       ais'2 cis, |
1910       fis8 b a4 cis2 |
1911     }
1912   >>
1913 }
1914
1915 musicB = {
1916   \clef bass
1917   \new Voice {
1918     \voiceTwo \relative {
1919       <fis a cis>8[ <fis a cis>
1920       \change Staff = up
1921       cis' cis
1922       \change Staff = down
1923       <fis, a> <fis a>]
1924       \showStaffSwitch
1925       \change Staff = up
1926       dis'4 |
1927       \change Staff = down
1928       <fis, a cis>4 gis <f a d>2 |
1929     }
1930   }
1931 }
1932
1933 \new PianoStaff {
1934   <<
1935     \context Staff = "up" {
1936       \accidentalStyle modern-cautionary
1937       \musicA
1938     }
1939     \context Staff = "down" {
1940       \accidentalStyle modern-cautionary
1941       \musicB
1942     }
1943   >>
1944 }
1945 @end lilypond
1946
1947 @item modern-voice
1948
1949 @cindex accidental style, modern
1950 @cindex accidentals, modern
1951 @cindex accidentals, multivoice
1952 @cindex modern accidental style
1953 @cindex modern accidentals
1954 @cindex multivoice accidentals
1955
1956 @funindex modern-voice
1957
1958 This rule is used for multivoice accidentals to be read both by
1959 musicians playing one voice and musicians playing all voices.
1960 Accidentals are typeset for each voice, but they @emph{are}
1961 canceled across voices in the same @code{Staff}.  Hence,
1962 the@tie{}@code{a} in the last measure is canceled because the
1963 previous cancellation was in a different voice, and
1964 the@tie{}@code{d} in the lower staff is canceled because of the
1965 accidental in a different voice in the previous measure:
1966
1967 @lilypond[quote]
1968 musicA = {
1969   <<
1970     \relative {
1971       cis''8 fis, bes4 <a cis>8 f bis4 |
1972       cis2. <c, g'>4 |
1973     }
1974     \\
1975     \relative {
1976       ais'2 cis, |
1977       fis8 b a4 cis2 |
1978     }
1979   >>
1980 }
1981
1982 musicB = {
1983   \clef bass
1984   \new Voice {
1985     \voiceTwo \relative {
1986       <fis a cis>8[ <fis a cis>
1987       \change Staff = up
1988       cis' cis
1989       \change Staff = down
1990       <fis, a> <fis a>]
1991       \showStaffSwitch
1992       \change Staff = up
1993       dis'4 |
1994       \change Staff = down
1995       <fis, a cis>4 gis <f a d>2 |
1996     }
1997   }
1998 }
1999
2000 \new PianoStaff {
2001   <<
2002     \context Staff = "up" {
2003       \accidentalStyle modern-voice
2004       \musicA
2005     }
2006     \context Staff = "down" {
2007       \accidentalStyle modern-voice
2008       \musicB
2009     }
2010   >>
2011 }
2012 @end lilypond
2013
2014 @cindex accidental style, cautionary, modern voice
2015 @cindex accidental style, modern voice cautionary
2016 @cindex accidental style, voice, modern cautionary
2017
2018 @funindex modern-voice-cautionary
2019
2020 @item modern-voice-cautionary
2021
2022 This rule is the same as @code{modern-voice}, but with the extra
2023 accidentals (the ones not typeset by @code{voice}) typeset as
2024 cautionaries.  Even though all accidentals typeset by
2025 @code{default} @emph{are} typeset with this rule, some of them are
2026 typeset as cautionaries.
2027
2028 @lilypond[quote]
2029 musicA = {
2030   <<
2031     \relative {
2032       cis''8 fis, bes4 <a cis>8 f bis4 |
2033       cis2. <c, g'>4 |
2034     }
2035     \\
2036     \relative {
2037       ais'2 cis, |
2038       fis8 b a4 cis2 |
2039     }
2040   >>
2041 }
2042
2043 musicB = {
2044   \clef bass
2045   \new Voice {
2046     \voiceTwo \relative {
2047       <fis a cis>8[ <fis a cis>
2048       \change Staff = up
2049       cis' cis
2050       \change Staff = down
2051       <fis, a> <fis a>]
2052       \showStaffSwitch
2053       \change Staff = up
2054       dis'4 |
2055       \change Staff = down
2056       <fis, a cis>4 gis <f a d>2 |
2057     }
2058   }
2059 }
2060
2061 \new PianoStaff {
2062   <<
2063     \context Staff = "up" {
2064       \accidentalStyle modern-voice-cautionary
2065       \musicA
2066     }
2067     \context Staff = "down" {
2068       \accidentalStyle modern-voice-cautionary
2069       \musicB
2070     }
2071   >>
2072 }
2073 @end lilypond
2074
2075 @item piano
2076
2077 @cindex accidental style, piano
2078 @cindex accidentals, piano
2079 @cindex piano accidental style
2080 @cindex piano accidentals
2081
2082 @funindex piano
2083
2084 This rule reflects twentieth-century practice for piano notation.
2085 Its behavior is very similar to @code{modern} style, but here
2086 accidentals also get canceled across the staves in the same
2087 @code{GrandStaff} or @code{PianoStaff}, hence all the
2088 cancellations of the final notes.
2089
2090 This accidental style applies to the current @code{GrandStaff} or
2091 @code{PianoStaff} by default.
2092
2093 @lilypond[quote]
2094 musicA = {
2095   <<
2096     \relative {
2097       cis''8 fis, bes4 <a cis>8 f bis4 |
2098       cis2. <c, g'>4 |
2099     }
2100     \\
2101     \relative {
2102       ais'2 cis, |
2103       fis8 b a4 cis2 |
2104     }
2105   >>
2106 }
2107
2108 musicB = {
2109   \clef bass
2110   \new Voice {
2111     \voiceTwo \relative {
2112       <fis a cis>8[ <fis a cis>
2113       \change Staff = up
2114       cis' cis
2115       \change Staff = down
2116       <fis, a> <fis a>]
2117       \showStaffSwitch
2118       \change Staff = up
2119       dis'4 |
2120       \change Staff = down
2121       <fis, a cis>4 gis <f a d>2 |
2122     }
2123   }
2124 }
2125
2126 \new PianoStaff {
2127   <<
2128     \context Staff = "up" {
2129       \accidentalStyle piano
2130       \musicA
2131     }
2132     \context Staff = "down" {
2133       \musicB
2134     }
2135   >>
2136 }
2137 @end lilypond
2138
2139 @item piano-cautionary
2140
2141 @cindex accidentals, piano cautionary
2142 @cindex cautionary accidentals, piano
2143 @cindex piano cautionary accidentals
2144 @cindex accidental style, piano cautionary
2145 @cindex cautionary accidental style, piano
2146 @cindex piano cautionary accidental style
2147
2148 @funindex piano-cautionary
2149
2150 This is the same as @code{piano} but with the extra accidentals
2151 typeset as cautionaries.
2152
2153 @lilypond[quote]
2154 musicA = {
2155   <<
2156     \relative {
2157       cis''8 fis, bes4 <a cis>8 f bis4 |
2158       cis2. <c, g'>4 |
2159     }
2160     \\
2161     \relative {
2162       ais'2 cis, |
2163       fis8 b a4 cis2 |
2164     }
2165   >>
2166 }
2167
2168 musicB = {
2169   \clef bass
2170   \new Voice {
2171     \voiceTwo \relative {
2172       <fis a cis>8[ <fis a cis>
2173       \change Staff = up
2174       cis' cis
2175       \change Staff = down
2176       <fis, a> <fis a>]
2177       \showStaffSwitch
2178       \change Staff = up
2179       dis'4 |
2180       \change Staff = down
2181       <fis, a cis>4 gis <f a d>2 |
2182     }
2183   }
2184 }
2185
2186 \new PianoStaff {
2187   <<
2188     \context Staff = "up" {
2189       \accidentalStyle piano-cautionary
2190       \musicA
2191     }
2192     \context Staff = "down" {
2193       \musicB
2194     }
2195   >>
2196 }
2197 @end lilypond
2198
2199
2200 @item choral
2201
2202 @cindex accidental style, choral
2203 @cindex accidentals, choral
2204 @cindex choral accidental style
2205 @cindex choral accidentals
2206
2207 @funindex choral
2208
2209 This rule is a combination of the @code{modern-voice} and the @code{piano}
2210 style. It is intended for editions that are used both by singers that only
2211 follow their own voice, as well as others that read an entire
2212 @code{ChoirStaff} simultaneously.
2213
2214 This accidental style applies to the current @code{ChoirStaff} by default.
2215
2216 @lilypond[quote]
2217 musicA = {
2218   <<
2219     \relative {
2220       cis''8 fis, bes4 <a cis>8 f bis4 |
2221       cis2. <c, g'>4 |
2222     }
2223     \\
2224     \relative {
2225       ais'2 cis, |
2226       fis8 b a4 cis2 |
2227     }
2228   >>
2229 }
2230
2231 musicB = {
2232   \clef bass
2233   \new Voice {
2234     \voiceTwo \relative {
2235       <fis a cis>8[ <fis a cis>
2236       \change Staff = up
2237       cis' cis
2238       \change Staff = down
2239       <fis, a> <fis a>]
2240       \showStaffSwitch
2241       \change Staff = up
2242       dis'4 |
2243       \change Staff = down
2244       <fis, a cis>4 gis <f a d>2 |
2245     }
2246   }
2247 }
2248
2249 \new ChoirStaff {
2250   <<
2251     \context Staff = "up" {
2252       \accidentalStyle choral
2253       \musicA
2254     }
2255     \context Staff = "down" {
2256       \musicB
2257     }
2258   >>
2259 }
2260 @end lilypond
2261
2262 @item choral-cautionary
2263
2264 @cindex accidentals, choral cautionary
2265 @cindex cautionary accidentals, choral
2266 @cindex choral cautionary accidentals
2267 @cindex accidental style, choral cautionary
2268 @cindex cautionary accidental style, choral
2269 @cindex choral cautionary accidental style
2270
2271 @funindex choral-cautionary
2272
2273 This is the same as @code{choral} but with the extra accidentals
2274 typeset as cautionaries.
2275
2276 @lilypond[quote]
2277 musicA = {
2278   <<
2279     \relative {
2280       cis''8 fis, bes4 <a cis>8 f bis4 |
2281       cis2. <c, g'>4 |
2282     }
2283     \\
2284     \relative {
2285       ais'2 cis, |
2286       fis8 b a4 cis2 |
2287     }
2288   >>
2289 }
2290
2291 musicB = {
2292   \clef bass
2293   \new Voice {
2294     \voiceTwo \relative {
2295       <fis a cis>8[ <fis a cis>
2296       \change Staff = up
2297       cis' cis
2298       \change Staff = down
2299       <fis, a> <fis a>]
2300       \showStaffSwitch
2301       \change Staff = up
2302       dis'4 |
2303       \change Staff = down
2304       <fis, a cis>4 gis <f a d>2 |
2305     }
2306   }
2307 }
2308
2309 \new ChoirStaff {
2310   <<
2311     \context Staff = "up" {
2312       \accidentalStyle choral-cautionary
2313       \musicA
2314     }
2315     \context Staff = "down" {
2316       \musicB
2317     }
2318   >>
2319 }
2320 @end lilypond
2321
2322
2323 @item neo-modern
2324
2325 @cindex neo-modern accidental style
2326 @cindex accidental style, neo-modern
2327
2328 @funindex neo-modern
2329
2330 This rule reproduces a common practice in contemporary music:
2331 accidentals are printed like with @code{modern}, but they are printed
2332 again if the same note appears later in the same measure -- except
2333 if the note is immediately repeated.
2334
2335 @lilypond[quote]
2336 musicA = {
2337   <<
2338     \relative {
2339       cis''8 fis, bes4 <a cis>8 f bis4 |
2340       cis2. <c, g'>4 |
2341     }
2342     \\
2343     \relative {
2344       ais'2 cis, |
2345       fis8 b a4 cis2 |
2346     }
2347   >>
2348 }
2349
2350 musicB = {
2351   \clef bass
2352   \new Voice {
2353     \voiceTwo \relative {
2354       <fis a cis>8[ <fis a cis>
2355       \change Staff = up
2356       cis' cis
2357       \change Staff = down
2358       <fis, a> <fis a>]
2359       \showStaffSwitch
2360       \change Staff = up
2361       dis'4 |
2362       \change Staff = down
2363       <fis, a cis>4 gis <f a d>2 |
2364     }
2365   }
2366 }
2367
2368 \new PianoStaff {
2369   <<
2370     \context Staff = "up" {
2371       \accidentalStyle neo-modern
2372       \musicA
2373     }
2374     \context Staff = "down" {
2375       \accidentalStyle neo-modern
2376       \musicB
2377     }
2378   >>
2379 }
2380 @end lilypond
2381
2382 @item neo-modern-cautionary
2383
2384 @cindex neo-modern-cautionary accidental style
2385 @cindex accidental style, neo-modern-cautionary
2386
2387 @funindex neo-modern-cautionary
2388
2389 This rule is similar to @code{neo-modern}, but the @q{extra} accidentals
2390 are printed as cautionary accidentals (with parentheses).  They can also
2391 be printed at a different size by overriding
2392 @code{AccidentalCautionary}'s @code{font-size} property.
2393
2394 @lilypond[quote]
2395 musicA = {
2396   <<
2397     \relative {
2398       cis''8 fis, bes4 <a cis>8 f bis4 |
2399       cis2. <c, g'>4 |
2400     }
2401     \\
2402     \relative {
2403       ais'2 cis, |
2404       fis8 b a4 cis2 |
2405     }
2406   >>
2407 }
2408
2409 musicB = {
2410   \clef bass
2411   \new Voice {
2412     \voiceTwo \relative {
2413       <fis a cis>8[ <fis a cis>
2414       \change Staff = up
2415       cis' cis
2416       \change Staff = down
2417       <fis, a> <fis a>]
2418       \showStaffSwitch
2419       \change Staff = up
2420       dis'4 |
2421       \change Staff = down
2422       <fis, a cis>4 gis <f a d>2 |
2423     }
2424   }
2425 }
2426
2427 \new PianoStaff {
2428   <<
2429     \context Staff = "up" {
2430       \accidentalStyle neo-modern-cautionary
2431       \musicA
2432     }
2433     \context Staff = "down" {
2434       \accidentalStyle neo-modern-cautionary
2435       \musicB
2436     }
2437   >>
2438 }
2439 @end lilypond
2440
2441
2442 @item neo-modern-voice
2443
2444 @cindex neo-modern-voice accidental style
2445 @cindex accidental style, neo-modern-voice
2446
2447 @funindex neo-modern-voice
2448
2449 This rule is used for multivoice accidentals to be read both by
2450 musicians playing one voice and musicians playing all voices.
2451 Accidentals are typeset for each voice as with @code{neo-modern},
2452 but they are canceled across voices in the same @code{Staff}.
2453
2454 @lilypond[quote]
2455 musicA = {
2456   <<
2457     \relative {
2458       cis''8 fis, bes4 <a cis>8 f bis4 |
2459       cis2. <c, g'>4 |
2460     }
2461     \\
2462     \relative {
2463       ais'2 cis, |
2464       fis8 b a4 cis2 |
2465     }
2466   >>
2467 }
2468
2469 musicB = {
2470   \clef bass
2471   \new Voice {
2472     \voiceTwo \relative {
2473       <fis a cis>8[ <fis a cis>
2474       \change Staff = up
2475       cis' cis
2476       \change Staff = down
2477       <fis, a> <fis a>]
2478       \showStaffSwitch
2479       \change Staff = up
2480       dis'4 |
2481       \change Staff = down
2482       <fis, a cis>4 gis <f a d>2 |
2483     }
2484   }
2485 }
2486
2487 \new PianoStaff {
2488   <<
2489     \context Staff = "up" {
2490       \accidentalStyle neo-modern-voice
2491       \musicA
2492     }
2493     \context Staff = "down" {
2494       \accidentalStyle neo-modern-voice
2495       \musicB
2496     }
2497   >>
2498 }
2499 @end lilypond
2500
2501 @item neo-modern-voice-cautionary
2502
2503 @cindex neo-modern-voice-cautionary accidental style
2504 @cindex accidental style, neo-modern-voice-cautionary
2505
2506 @funindex neo-modern-voice-cautionary
2507
2508 This rule is similar to @code{neo-modern-voice}, but the extra
2509 accidentals are printed as cautionary accidentals.
2510
2511 @lilypond[quote]
2512 musicA = {
2513   <<
2514     \relative {
2515       cis''8 fis, bes4 <a cis>8 f bis4 |
2516       cis2. <c, g'>4 |
2517     }
2518     \\
2519     \relative {
2520       ais'2 cis, |
2521       fis8 b a4 cis2 |
2522     }
2523   >>
2524 }
2525
2526 musicB = {
2527   \clef bass
2528   \new Voice {
2529     \voiceTwo \relative {
2530       <fis a cis>8[ <fis a cis>
2531       \change Staff = up
2532       cis' cis
2533       \change Staff = down
2534       <fis, a> <fis a>]
2535       \showStaffSwitch
2536       \change Staff = up
2537       dis'4 |
2538       \change Staff = down
2539       <fis, a cis>4 gis <f a d>2 |
2540     }
2541   }
2542 }
2543
2544 \new PianoStaff {
2545   <<
2546     \context Staff = "up" {
2547       \accidentalStyle neo-modern-voice-cautionary
2548       \musicA
2549     }
2550     \context Staff = "down" {
2551       \accidentalStyle neo-modern-voice-cautionary
2552       \musicB
2553     }
2554   >>
2555 }
2556 @end lilypond
2557
2558 @item dodecaphonic
2559
2560 @cindex dodecaphonic accidental style
2561 @cindex dodecaphonic style, neo-modern
2562
2563 @funindex dodecaphonic
2564
2565 This rule reflects a practice introduced by composers at
2566 the beginning of the 20th century, in an attempt to
2567 abolish the hierarchy between natural and non-natural notes.
2568 With this style, @emph{every} note gets an accidental sign,
2569 including natural signs.
2570
2571 @lilypond[quote]
2572 musicA = {
2573   <<
2574     \relative {
2575       cis''8 fis, bes4 <a cis>8 f bis4 |
2576       cis2. <c, g'>4 |
2577     }
2578     \\
2579     \relative {
2580       ais'2 cis, |
2581       fis8 b a4 cis2 |
2582     }
2583   >>
2584 }
2585
2586 musicB = {
2587   \clef bass
2588   \new Voice {
2589     \voiceTwo \relative {
2590       <fis a cis>8[ <fis a cis>
2591       \change Staff = up
2592       cis' cis
2593       \change Staff = down
2594       <fis, a> <fis a>]
2595       \showStaffSwitch
2596       \change Staff = up
2597       dis'4 |
2598       \change Staff = down
2599       <fis, a cis>4 gis <f a d>2 |
2600     }
2601   }
2602 }
2603
2604 \new PianoStaff {
2605   <<
2606     \context Staff = "up" {
2607       \accidentalStyle dodecaphonic
2608       \musicA
2609     }
2610     \context Staff = "down" {
2611       \accidentalStyle dodecaphonic
2612       \musicB
2613     }
2614   >>
2615 }
2616 @end lilypond
2617
2618 @item dodecaphonic-no-repeat
2619
2620 @cindex dodecaphonic accidental style
2621 @cindex dodecaphonic style, neo-modern
2622
2623 @funindex dodecaphonic-no-repeat
2624
2625 Like with the dodecaphonic accidental style @emph{every} note
2626 gets an accidental sign by default, but accidentals are
2627 suppressed for pitches immediately repeated within the same staff.
2628
2629 @lilypond[quote]
2630 musicA = {
2631   <<
2632     \relative {
2633       cis''8 fis, bes4 <a cis>8 f bis4 |
2634       cis2. <c, g'>4 |
2635     }
2636     \\
2637     \relative {
2638       ais'2 cis, |
2639       fis8 b a4 cis2 |
2640     }
2641   >>
2642 }
2643
2644 musicB = {
2645   \clef bass
2646   \new Voice {
2647     \voiceTwo \relative {
2648       <fis a cis>8[ <fis a cis>
2649       \change Staff = up
2650       cis' cis
2651       \change Staff = down
2652       <fis, a> <fis a>]
2653       \showStaffSwitch
2654       \change Staff = up
2655       dis'4 |
2656       \change Staff = down
2657       <fis, a cis>4 gis <f a d>2 |
2658     }
2659   }
2660 }
2661
2662 \new PianoStaff {
2663   <<
2664     \context Staff = "up" {
2665       \accidentalStyle dodecaphonic-no-repeat
2666       \musicA
2667     }
2668     \context Staff = "down" {
2669       \accidentalStyle dodecaphonic-no-repeat
2670       \musicB
2671     }
2672   >>
2673 }
2674 @end lilypond
2675
2676
2677 @item dodecaphonic-first
2678
2679 @cindex dodecaphonic accidental style
2680 @cindex dodecaphonic style, neo-modern
2681
2682 @funindex dodecaphonic-first
2683
2684 Similar to the dodecaphonic accidental style @emph{every} pitch
2685 gets an accidental sign, but only the first time it is encountered
2686 in a measure.  Accidentals are only remembered for the actual octave
2687 but throughout voices.
2688
2689 @lilypond[quote]
2690 musicA = {
2691   <<
2692     \relative {
2693       cis''8 fis, bes4 <a cis>8 f bis4 |
2694       cis2. <c, g'>4 |
2695     }
2696     \\
2697     \relative {
2698       ais'2 cis, |
2699       fis8 b a4 cis2 |
2700     }
2701   >>
2702 }
2703
2704 musicB = {
2705   \clef bass
2706   \new Voice {
2707     \voiceTwo \relative {
2708       <fis a cis>8[ <fis a cis>
2709       \change Staff = up
2710       cis' cis
2711       \change Staff = down
2712       <fis, a> <fis a>]
2713       \showStaffSwitch
2714       \change Staff = up
2715       dis'4 |
2716       \change Staff = down
2717       <fis, a cis>4 gis <f a d>2 |
2718     }
2719   }
2720 }
2721
2722 \new PianoStaff {
2723   <<
2724     \context Staff = "up" {
2725       \accidentalStyle dodecaphonic-first
2726       \musicA
2727     }
2728     \context Staff = "down" {
2729       \accidentalStyle dodecaphonic-first
2730       \musicB
2731     }
2732   >>
2733 }
2734 @end lilypond
2735
2736
2737 @item teaching
2738
2739 @cindex teaching accidental style
2740 @cindex accidental style, teaching
2741
2742 @funindex teaching
2743
2744 This rule is intended for students, and makes it easy to create
2745 scale sheets with automatically created cautionary accidentals.
2746 Accidentals are printed like with @code{modern}, but cautionary
2747 accidentals are added for all sharp or flat tones specified by the
2748 key signature, except if the note is immediately repeated.
2749
2750 @lilypond[quote,staffsize=18]
2751 musicA = {
2752   <<
2753     \relative {
2754       cis''8 fis, bes4 <a cis>8 f bis4 |
2755       cis2. <c, g'>4 |
2756     }
2757     \\
2758     \relative {
2759       ais'2 cis, |
2760       fis8 b a4 cis2 |
2761     }
2762   >>
2763 }
2764
2765 musicB = {
2766   \clef bass
2767   \new Voice {
2768     \voiceTwo \relative {
2769       <fis a cis>8[ <fis a cis>
2770       \change Staff = up
2771       cis' cis
2772       \change Staff = down
2773       <fis, a> <fis a>]
2774       \showStaffSwitch
2775       \change Staff = up
2776       dis'4 |
2777       \change Staff = down
2778       <fis, a cis>4 gis <f a d>2 |
2779     }
2780   }
2781 }
2782
2783 \new PianoStaff {
2784   <<
2785     \context Staff = "up" {
2786       \key fis \minor
2787       \accidentalStyle teaching
2788       \musicA
2789     }
2790     \context Staff = "down" {
2791       \key fis \minor
2792       \accidentalStyle teaching
2793       \musicB
2794     }
2795   >>
2796 }
2797 @end lilypond
2798
2799
2800
2801 @item no-reset
2802
2803 @cindex accidental style, no reset
2804 @cindex no reset accidental style
2805
2806 @funindex no-reset
2807
2808 This is the same as @code{default} but with accidentals lasting
2809 @q{forever} and not only within the same measure:
2810
2811 @lilypond[quote]
2812 musicA = {
2813   <<
2814     \relative {
2815       cis''8 fis, bes4 <a cis>8 f bis4 |
2816       cis2. <c, g'>4 |
2817     }
2818     \\
2819     \relative {
2820       ais'2 cis, |
2821       fis8 b a4 cis2 |
2822     }
2823   >>
2824 }
2825
2826 musicB = {
2827   \clef bass
2828   \new Voice {
2829     \voiceTwo \relative {
2830       <fis a cis>8[ <fis a cis>
2831       \change Staff = up
2832       cis' cis
2833       \change Staff = down
2834       <fis, a> <fis a>]
2835       \showStaffSwitch
2836       \change Staff = up
2837       dis'4 |
2838       \change Staff = down
2839       <fis, a cis>4 gis <f a d>2 |
2840     }
2841   }
2842 }
2843
2844 \new PianoStaff {
2845   <<
2846     \context Staff = "up" {
2847       \accidentalStyle no-reset
2848       \musicA
2849     }
2850     \context Staff = "down" {
2851       \accidentalStyle no-reset
2852       \musicB
2853     }
2854   >>
2855 }
2856 @end lilypond
2857
2858 @item forget
2859
2860 @cindex forget accidental style
2861 @cindex accidental style, forget
2862
2863 @funindex forget
2864
2865 This is the opposite of @code{no-reset}: Accidentals are not
2866 remembered at all -- and hence all accidentals are typeset
2867 relative to the key signature, regardless of what came before in
2868 the music.
2869
2870 @lilypond[quote]
2871 musicA = {
2872   <<
2873     \relative {
2874       cis''8 fis, bes4 <a cis>8 f bis4 |
2875       cis2. <c, g'>4 |
2876     }
2877     \\
2878     \relative {
2879       ais'2 cis, |
2880       fis8 b a4 cis2 |
2881     }
2882   >>
2883 }
2884
2885 musicB = {
2886   \clef bass
2887   \new Voice {
2888     \voiceTwo \relative {
2889       <fis a cis>8[ <fis a cis>
2890       \change Staff = up
2891       cis' cis
2892       \change Staff = down
2893       <fis, a> <fis a>]
2894       \showStaffSwitch
2895       \change Staff = up
2896       dis'4 |
2897       \change Staff = down
2898       <fis, a cis>4 gis <f a d>2 |
2899     }
2900   }
2901 }
2902
2903 \new PianoStaff {
2904   <<
2905     \context Staff = "up" {
2906       \accidentalStyle forget
2907       \musicA
2908     }
2909     \context Staff = "down" {
2910       \accidentalStyle forget
2911       \musicB
2912     }
2913   >>
2914 }
2915 @end lilypond
2916 @end table
2917
2918 @seealso
2919 Snippets:
2920 @rlsr{Pitches}.
2921
2922 Internals Reference:
2923 @rinternals{Accidental},
2924 @rinternals{Accidental_engraver},
2925 @rinternals{GrandStaff},
2926 @rinternals{PianoStaff},
2927 @rinternals{Staff},
2928 @rinternals{AccidentalSuggestion},
2929 @rinternals{AccidentalPlacement},
2930 @rinternals{accidental-suggestion-interface}.
2931
2932 @cindex accidentals and simultaneous notes
2933 @cindex simultaneous notes and accidentals
2934 @cindex accidentals in chords
2935 @cindex chords, accidentals in
2936
2937 @knownissues
2938 Simultaneous notes are not considered in the automatic
2939 determination of accidentals; only previous notes and the key
2940 signature are considered.  Forcing accidentals with@tie{}@code{!}
2941 or@tie{}@code{?} may be required when the same note name occurs
2942 simultaneously with different alterations, as in @samp{<f! fis!>}.
2943
2944 Cautionary cancellation of accidentals is done by looking at previous measure.
2945 However, in the @code{\alternative} block following a @code{\repeat volta N}
2946 section, one would expect the cancellation being calculated using the previous
2947 @emph{played} measure, not previous @emph{printed} measure.
2948 In the following example, the natural @code{c} in the second alternative does
2949 not need a natural sign:
2950
2951 @lilypond[quote]
2952 {
2953   \accidentalStyle modern
2954   \time 2/4
2955   \repeat volta 2 {
2956     c'2
2957   }
2958   \alternative {
2959      cis'
2960      c'
2961   }
2962 }
2963 @end lilypond
2964
2965 The following work-around can be used: define a function that locally changes
2966 the accidental style to @code{forget}:
2967
2968 @lilypond[verbatim,quote]
2969 forget = #(define-music-function (music) (ly:music?) #{
2970   \accidentalStyle forget
2971   #music
2972   \accidentalStyle modern
2973 #})
2974 {
2975   \accidentalStyle modern
2976   \time 2/4
2977   \repeat volta 2 {
2978     c'2
2979   }
2980   \alternative {
2981      cis'
2982      \forget c'
2983   }
2984 }
2985 @end lilypond
2986
2987
2988 @node Ambitus
2989 @unnumberedsubsubsec Ambitus
2990
2991 @cindex ambitus
2992 @cindex range of pitches
2993 @cindex pitch range
2994
2995 The term @notation{ambitus} (pl. ambitus) denotes a range of
2996 pitches for a given voice in a part of music.  It may also denote
2997 the pitch range that a musical instrument is capable of playing.
2998 Ambitus are printed on vocal parts so that performers can easily
2999 determine if it matches their capabilities.
3000
3001 Ambitus are denoted at the beginning of a piece near the initial
3002 clef.  The range is graphically specified by two note heads that
3003 represent the lowest and highest pitches.  Accidentals are only
3004 printed if they are not part of the key signature.
3005
3006 @lilypond[verbatim,quote]
3007 \layout {
3008   \context {
3009     \Voice
3010     \consists "Ambitus_engraver"
3011   }
3012 }
3013
3014 \relative {
3015   aes' c e2
3016   cis,1
3017 }
3018 @end lilypond
3019
3020
3021 @snippets
3022
3023 @lilypondfile[verbatim,quote,texidoc,doctitle]
3024 {adding-ambitus-per-voice.ly}
3025
3026 @lilypondfile[verbatim,quote,texidoc,doctitle]
3027 {ambitus-with-multiple-voices.ly}
3028
3029 @lilypondfile[verbatim,quote,texidoc,doctitle]
3030 {changing-the-ambitus-gap.ly}
3031
3032 @seealso
3033 Music Glossary:
3034 @rglos{ambitus}.
3035
3036 Snippets:
3037 @rlsr{Pitches}.
3038
3039 Internals Reference:
3040 @rinternals{Ambitus_engraver},
3041 @rinternals{Voice},
3042 @rinternals{Staff},
3043 @rinternals{Ambitus},
3044 @rinternals{AmbitusAccidental},
3045 @rinternals{AmbitusLine},
3046 @rinternals{AmbitusNoteHead},
3047 @rinternals{ambitus-interface}.
3048
3049 @knownissues
3050 There is no collision handling in the case of multiple per-voice
3051 ambitus.
3052
3053
3054 @node Note heads
3055 @subsection Note heads
3056
3057 This section suggests ways of altering note heads.
3058
3059 @menu
3060 * Special note heads::
3061 * Easy notation note heads::
3062 * Shape note heads::
3063 * Improvisation::
3064 @end menu
3065
3066 @node Special note heads
3067 @unnumberedsubsubsec Special note heads
3068
3069 @cindex note heads, special
3070 @cindex note heads, cross
3071 @cindex note heads, diamond
3072 @cindex note heads, parlato
3073 @cindex note heads, harmonic
3074 @cindex note heads, guitar
3075 @cindex special note heads
3076 @cindex cross note heads
3077 @cindex diamond note heads
3078 @cindex parlato note heads
3079 @cindex harmonic note heads
3080 @cindex guitar note heads
3081 @cindex note head styles
3082 @cindex styles, note heads
3083
3084 @funindex cross
3085
3086 The appearance of note heads may be altered:
3087
3088 @lilypond[verbatim,quote]
3089 \relative c'' {
3090   c4 b
3091   \override NoteHead.style = #'cross
3092   c4 b
3093   \revert NoteHead.style
3094   a b
3095   \override NoteHead.style = #'harmonic
3096   a b
3097   \revert NoteHead.style
3098   c4 d e f
3099 }
3100 @end lilypond
3101
3102 To see all note head styles, see @ref{Note head styles}.
3103
3104 The @code{cross} style is used to represent a variety of musical
3105 intentions.  The following generic predefined commands modify the
3106 note head in both staff and tablature contexts and can be used to
3107 represent any musical meaning:
3108
3109 @lilypond[verbatim,quote]
3110 \relative {
3111   c''4 b
3112   \xNotesOn
3113    a b c4 b
3114   \xNotesOff
3115   c4 d
3116 }
3117 @end lilypond
3118
3119 The music function form of this predefined command may be used
3120 inside and outside chords to generate crossed note heads in both
3121 staff and tablature contexts:
3122
3123 @lilypond[verbatim,quote]
3124 \relative {
3125   c''4 b
3126   \xNote { e f }
3127   c b < g \xNote c f > b
3128 }
3129 @end lilypond
3130
3131 As synonyms for @code{\xNote}, @code{\xNotesOn} and @code{\xNotesOff},
3132 @code{\deadNote}, @code{\deadNotesOn} and @code{\deadNotesOff} can
3133 be used.  The term @notation{dead note} is commonly used by guitarists.
3134
3135 There is also a similar shorthand for diamond shapes:
3136
3137 @lilypond[verbatim,quote]
3138 \relative c'' {
3139   <c f\harmonic>2 <d a'\harmonic>4 <c g'\harmonic> f\harmonic
3140 }
3141 @end lilypond
3142
3143 @predefined
3144 @code{\harmonic},
3145 @code{\xNotesOn},
3146 @code{\xNotesOff},
3147 @code{\xNote}.
3148 @endpredefined
3149
3150 @seealso
3151 Snippets:
3152 @rlsr{Pitches}.
3153
3154 Notation Reference:
3155 @ref{Note head styles},
3156 @ref{Chorded notes},
3157 @ref{Indicating harmonics and dampened notes}.
3158
3159 Internals Reference:
3160 @rinternals{note-event},
3161 @rinternals{Note_heads_engraver},
3162 @rinternals{Ledger_line_engraver},
3163 @rinternals{NoteHead},
3164 @rinternals{LedgerLineSpanner},
3165 @rinternals{note-head-interface},
3166 @rinternals{ledger-line-spanner-interface}.
3167
3168
3169 @node Easy notation note heads
3170 @unnumberedsubsubsec Easy notation note heads
3171
3172 @cindex note heads, practice
3173 @cindex practice note heads
3174 @cindex note heads, easy notation
3175 @cindex easy notation
3176 @cindex beginners' music
3177 @cindex music, beginners'
3178 @cindex easy play note heads
3179 @cindex note heads, easy play
3180
3181 @funindex \easyHeadsOn
3182 @funindex \easyHeadsOff
3183
3184 The @q{easy play} note head includes a note name inside the head.
3185 It is used in music for beginners.  To make the letters readable,
3186 it should be printed in a large font size.  To print with a larger
3187 font, see @ref{Setting the staff size}.
3188
3189 @lilypond[verbatim,quote]
3190 #(set-global-staff-size 26)
3191 \relative c' {
3192   \easyHeadsOn
3193   c2 e4 f
3194   g1
3195   \easyHeadsOff
3196   c,1
3197 }
3198 @end lilypond
3199
3200
3201 @predefined
3202 @code{\easyHeadsOn},
3203 @code{\easyHeadsOff}.
3204 @endpredefined
3205
3206
3207 @snippets
3208
3209 @lilypondfile[verbatim,quote,texidoc,doctitle]
3210 {numbers-as-easy-note-heads.ly}
3211
3212 @seealso
3213 Notation Reference:
3214 @ref{Setting the staff size}.
3215
3216 Snippets:
3217 @rlsr{Pitches}.
3218
3219 Internals Reference:
3220 @rinternals{note-event},
3221 @rinternals{Note_heads_engraver},
3222 @rinternals{NoteHead},
3223 @rinternals{note-head-interface}.
3224
3225
3226 @node Shape note heads
3227 @unnumberedsubsubsec Shape note heads
3228
3229 @cindex note heads, shape
3230 @cindex note heads, Aiken
3231 @cindex note heads, sacred harp
3232 @cindex shape notes
3233 @cindex Aiken shape note heads
3234 @cindex sacred harp note heads
3235 @cindex note heads, Southern Harmony
3236 @cindex Southern Harmony note heads
3237 @cindex Funk shape note heads
3238 @cindex note heads, Funk
3239 @cindex note heads, Harmonica Sacra
3240 @cindex Harmonica Sacra note heads
3241 @cindex Christian Harmony note heads
3242 @cindex note heads, Christian Harmony
3243 @cindex Walker shape note heads
3244 @cindex note heads, Walker
3245
3246 @funindex \aikenHeads
3247 @funindex \sacredHarpHeads
3248 @funindex \southernHarmonyHeads
3249 @funindex \funkHeads
3250 @funindex \walkerHeads
3251
3252 In shape note head notation, the shape of the note head
3253 corresponds to the harmonic function of a note in the scale.  This
3254 notation was popular in nineteenth-century American song books.
3255 Shape note heads can be produced in Sacred Harp, Southern Harmony,
3256 Funk (Harmonica Sacra), Walker, and Aiken (Christian Harmony) styles:
3257
3258 @lilypond[verbatim,quote]
3259 \relative c'' {
3260   \aikenHeads
3261   c, d e f g2 a b1 c \break
3262   \sacredHarpHeads
3263   c,4 d e f g2 a b1 c \break
3264   \southernHarmonyHeads
3265   c,4 d e f g2 a b1 c \break
3266   \funkHeads
3267   c,4 d e f g2 a b1 c \break
3268   \walkerHeads
3269   c,4 d e f g2 a b1 c \break
3270 }
3271 @end lilypond
3272
3273 @funindex \key
3274 @funindex \aikenHeadsMinor
3275 @funindex \sacredHarpHeadsMinor
3276 @funindex \southernHarmonyHeadsMinor
3277 @funindex \funkHeadsMinor
3278 @funindex \walkerHeadsMinor
3279
3280 Shapes are typeset according to the step in the scale, where the base
3281 of the scale is determined by the @code{\key} command.  When writing
3282 in a minor key, the scale step can be determined from the relative
3283 major:
3284
3285 @lilypond[verbatim,quote]
3286 \relative c'' {
3287   \key a \minor
3288   \aikenHeads
3289   a b c d e2 f g1 a \break
3290   \aikenHeadsMinor
3291   a,4 b c d e2 f g1 a \break
3292   \sacredHarpHeadsMinor
3293   a,2 b c d \break
3294   \southernHarmonyHeadsMinor
3295   a2 b c d \break
3296   \funkHeadsMinor
3297   a2 b c d \break
3298   \walkerHeadsMinor
3299   a2 b c d \break
3300 }
3301 @end lilypond
3302
3303
3304 @predefined
3305 @code{\aikenHeads},
3306 @code{\aikenHeadsMinor},
3307 @code{\funkHeads},
3308 @code{\funkHeadsMinor},
3309 @code{\sacredHarpHeads},
3310 @code{\sacredHarpHeadsMinor},
3311 @code{\southernHarmonyHeads},
3312 @code{\southernHarmonyHeadsMinor},
3313 @code{\walkerHeads},
3314 @code{\walkerHeadsMinor}.
3315 @endpredefined
3316
3317
3318 @snippets
3319
3320 @lilypondfile[verbatim,quote,texidoc,doctitle]
3321 {applying-note-head-styles-depending-on-the-step-of-the-scale.ly}
3322
3323 To see all note head styles, see @ref{Note head styles}.
3324
3325 @seealso
3326 Snippets:
3327 @rlsr{Pitches}.
3328
3329 Notation Reference:
3330 @ref{Note head styles}.
3331
3332 Internals Reference:
3333 @rinternals{note-event},
3334 @rinternals{Note_heads_engraver},
3335 @rinternals{NoteHead},
3336 @rinternals{note-head-interface}.
3337
3338
3339 @node Improvisation
3340 @unnumberedsubsubsec Improvisation
3341
3342 @cindex improvisation
3343 @cindex slashed note heads
3344 @cindex note heads, improvisation
3345 @cindex note heads, slashed
3346
3347 @funindex \improvisationOn
3348 @funindex \improvisationOff
3349
3350 Improvisation is sometimes denoted with slashed note heads, where
3351 the performer may choose any pitch but should play the specified
3352 rhythm.  Such note heads can be created:
3353
3354 @lilypond[verbatim,quote]
3355 \new Voice \with {
3356   \consists "Pitch_squash_engraver"
3357 } \relative {
3358   e''8 e g a a16( bes) a8 g
3359   \improvisationOn
3360   e8 ~
3361   2 ~ 8 f4 f8 ~
3362   2
3363   \improvisationOff
3364   a16( bes) a8 g e
3365 }
3366 @end lilypond
3367
3368 @predefined
3369 @code{\improvisationOn},
3370 @code{\improvisationOff}.
3371 @endpredefined
3372
3373 @seealso
3374 Snippets:
3375 @rlsr{Pitches}.
3376
3377 Internals Reference:
3378 @rinternals{Pitch_squash_engraver},
3379 @rinternals{Voice},
3380 @rinternals{RhythmicStaff}.