Documentation/user/expressive.itely

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @ignore
   3     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
   4
   5     When revising a translation, copy the HEAD committish of the
   6     version that you are working on.  See TRANSLATION for details.
   7 @end ignore
   8
   9 @c \version "2.12.0"
  10
  11 @node Expressive marks
  12 @section Expressive marks
  13
  14 @lilypondfile[quote]{expressive-headword.ly}
  15
  16 This section lists various expressive marks that can be
  17 created in a score.
  18
  19 @menu
  20 * Attached to notes::
  21 * Curves::
  22 * Lines::
  23 @end menu
  24
  25
  26 @node Attached to notes
  27 @subsection Attached to notes
  28
  29 This section explains how to create expressive marks that are
  30 attached to notes: articulations, ornamentations, and dynamics.
  31 Methods to create new dynamic markings are also discussed.
  32
  33 @menu
  34 * Articulations and ornamentations::
  35 * Dynamics::
  36 * New dynamic marks::
  37 @end menu
  38
  39 @node Articulations and ornamentations
  40 @unnumberedsubsubsec Articulations and ornamentations
  41
  42 @cindex articulations
  43 @cindex ornamentation
  44 @cindex scripts
  45 @cindex ornaments
  46 @cindex espressivo
  47 @cindex fermata
  48 @cindex upbow
  49 @cindex downbow
  50 @cindex foot marks
  51 @cindex organ pedal marks
  52 @cindex pedal marks, organ
  53 @cindex turn
  54 @cindex open
  55 @cindex stopped
  56 @cindex flageolet
  57 @cindex reverseturn
  58 @cindex trill
  59 @cindex prall
  60 @cindex mordent
  61 @cindex prallprall
  62 @cindex prallmordent
  63 @cindex prall, up
  64 @cindex prall, down
  65 @cindex thumb marking
  66 @cindex segno
  67 @cindex coda
  68 @cindex varcoda
  69
  70 @funindex -
  71
  72 A variety of symbols that denote articulations, ornamentations,
  73 and other performance indications can be attached to a note using
  74 this syntax:
  75
  76 @example
  77 @var{note}\@var{name}
  78 @end example
  79
  80 The possible values for @var{name} are listed in @ref{List of
  81 articulations}.  For example:
  82
  83 @lilypond[verbatim,quote,relative=2]
  84 c4\staccato c\mordent b2\turn
  85 c1\fermata
  86 @end lilypond
  87
  88 @cindex marcato
  89 @cindex tenuto
  90 @cindex staccatissimo
  91 @cindex accent
  92 @cindex staccato
  93 @cindex portato
  94
  95 Some of these articulations have shorthands for easier entry.
  96 Shorthands are appended to the note name, and their syntax
  97 consists of a dash @code{-} followed by a symbol signifying the
  98 articulation.  Predefined shorthands exist for @notation{marcato},
  99 @notation{stopped}, @notation{tenuto}, @notation{staccatissimo},
 100 @notation{accent}, @notation{staccato}, and @notation{portato}.
 101 Their corresponding output appears as follows:
 102
 103 @lilypond[verbatim,quote,relative=2]
 104 c4-^  c-+  c--  c-|
 105 c4->  c-.  c2-_
 106 @end lilypond
 107
 108 The rules for the default placement of articulations are defined
 109 in @file{scm/@/script@/.scm}.  Articulations and ornamentations
 110 may be manually placed above or below the staff, see
 111 @ref{Direction and placement}.
 112
 113
 114 @snippets
 115
 116 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 117 {modifying-default-values-for-articulation-shorthand-notation.ly}
 118
 119 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 120 {controlling-the-vertical-ordering-of-scripts.ly}
 121
 122 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 123 {creating-a-delayed-turn.ly}
 124
 125 @seealso
 126 Music Glossary:
 127 @rglos{tenuto},
 128 @rglos{accent},
 129 @rglos{staccato},
 130 @rglos{portato}.
 131
 132 Notation Reference:
 133 @ref{Direction and placement},
 134 @ref{List of articulations},
 135 @ref{Trills}.
 136
 137 Installed Files:
 138 @file{scm/@/script@/.scm}.
 139
 140 Snippets:
 141 @rlsr{Expressive marks}.
 142
 143 Internals Reference:
 144 @rinternals{Script},
 145 @rinternals{TextScript}.
 146
 147
 148 @node Dynamics
 149 @unnumberedsubsubsec Dynamics
 150
 151 @cindex absolute dynamics
 152 @cindex dynamics
 153 @cindex dynamics, absolute
 154
 155 @funindex \ppppp
 156 @funindex ppppp
 157 @funindex \pppp
 158 @funindex pppp
 159 @funindex \ppp
 160 @funindex ppp
 161 @funindex \pp
 162 @funindex pp
 163 @funindex \p
 164 @funindex p
 165 @funindex \mp
 166 @funindex mp
 167 @funindex \mf
 168 @funindex mf
 169 @funindex \f
 170 @funindex f
 171 @funindex \ff
 172 @funindex ff
 173 @funindex \fff
 174 @funindex fff
 175 @funindex \ffff
 176 @funindex ffff
 177 @funindex \fp
 178 @funindex fp
 179 @funindex \sf
 180 @funindex sf
 181 @funindex \sff
 182 @funindex sff
 183 @funindex \sp
 184 @funindex sp
 185 @funindex \spp
 186 @funindex spp
 187 @funindex \sfz
 188 @funindex sfz
 189 @funindex \rfz
 190 @funindex rfz
 191
 192 Absolute dynamic marks are specified using a command after a note,
 193 such as @code{c4\ff}.  The available dynamic marks are
 194 @code{\ppppp}, @code{\pppp}, @code{\ppp}, @code{\pp}, @code{\p},
 195 @code{\mp}, @code{\mf}, @code{\f}, @code{\ff}, @code{\fff},
 196 @code{\ffff}, @code{\fp}, @code{\sf}, @code{\sff}, @code{\sp},
 197 @code{\spp}, @code{\sfz}, and @code{\rfz}.  The dynamic marks may
 198 be manually placed above or below the staff, see
 199 @ref{Direction and placement}.
 200
 201 @lilypond[verbatim,quote,relative=2]
 202 c2\ppp c\mp
 203 c2\rfz c^\mf
 204 c2_\spp c^\ff
 205 @end lilypond
 206
 207 @cindex hairpin
 208 @cindex crescendo
 209 @cindex decrescendo
 210 @cindex diminuendo
 211
 212 @funindex \<
 213 @funindex \>
 214 @funindex \!
 215 @funindex \cr
 216 @funindex cr
 217 @funindex \decr
 218 @funindex decr
 219
 220 A @notation{crescendo} mark is started with @code{\<} and
 221 terminated with @code{\!}, an absolute dynamic, or an additional
 222 crescendo or decrescendo mark.  A @notation{decrescendo} mark is
 223 started with @code{\>} and is also terminated with @code{\!}, an
 224 absolute dynamic, or another crescendo or decrescendo mark.
 225 @code{\cr} and @code{\decr} may be used instead of @code{\<} and
 226 @code{\>}.  @notation{Hairpins} are engraved by default using this
 227 notation.
 228
 229 @lilypond[verbatim,quote,relative=2]
 230 c2\< c\!
 231 d2\< d\f
 232 e2\< e\>
 233 f2\> f\!
 234 e2\> e\mp
 235 d2\> d\>
 236 c1\!
 237 @end lilypond
 238
 239 Spacer rests are needed to engrave multiple marks on one note.
 240
 241 @cindex multiple dynamic marks on one note
 242 @cindex dynamic marks, multiple on one note
 243
 244 @lilypond[verbatim,quote,relative=2]
 245 c4\< c\! d\> e\!
 246 << f1 { s4 s4\< s4\> s4\! } >>
 247 @end lilypond
 248
 249 @cindex espressivo articulation
 250
 251 @funindex \espressivo
 252 @funindex espressivo
 253
 254 In some situations the @code{\espressivo} articulation mark may be
 255 the appropriate choice to indicate a crescendo and decrescendo on
 256 one note:
 257
 258 @lilypond[verbatim,quote,relative=2]
 259 c2 b4 a
 260 g1\espressivo
 261 @end lilypond
 262
 263
 264 @funindex \crescTextCresc
 265 @funindex crescTextCresc
 266 @funindex \dimTextDecresc
 267 @funindex dimTextDecresc
 268 @funindex \dimTextDecr
 269 @funindex dimTextDecr
 270 @funindex \dimTextDim
 271 @funindex dimTextDim
 272 @funindex \crescHairpin
 273 @funindex crescHairpin
 274 @funindex \dimHairpin
 275 @funindex dimHairpin
 276
 277 Crescendos and decrescendos can be engraved as textual markings
 278 instead of hairpins.  Dashed lines are printed to indicate their
 279 extent.  The built-in commands that enable these text modes are
 280 @code{\crescTextCresc}, @code{\dimTextDecresc},
 281 @code{\dimTextDecr}, and @code{\dimTextDim}.  The corresponding
 282 @code{\crescHairpin} and @code{\dimHairpin} commands will revert
 283 to hairpins again:
 284
 285 @lilypond[verbatim,quote,relative=2]
 286 \crescTextCresc
 287 c2\< d | e f\!
 288 \dimTextDecresc
 289 e2\> d | c b\!
 290 \crescHairpin
 291 c2\< d | e f\!
 292 \dimHairpin
 293 e2\> d\!
 294 @end lilypond
 295
 296
 297 To create new absolute dynamic marks or text that should be
 298 aligned with dynamics, see @ref{New dynamic marks}.
 299
 300 @cindex dynamics, vertical positioning
 301 @cindex vertical positioning of dynamics
 302
 303 @funindex DynamicLineSpanner
 304
 305
 306 Vertical positioning of dynamics is handled by
 307 @rinternals{DynamicLineSpanner}.
 308 @funindex \dynamicUp
 309 @funindex dynamicUp
 310 @funindex \dynamicDown
 311 @funindex dynamicDown
 312 @funindex \dynamicNeutral
 313 @funindex dynamicNeutral
 314
 315
 316 @predefined
 317 @code{\dynamicUp},
 318 @code{\dynamicDown},
 319 @code{\dynamicNeutral},
 320 @code{\crescTextCresc},
 321 @code{\dimTextDim},
 322 @code{\dimTextDecr},
 323 @code{\dimTextDecresc},
 324 @code{\crescHairpin},
 325 @code{\dimHairpin}.
 326 @endpredefined
 327
 328
 329 @snippets
 330
 331 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 332 {setting-hairpin-behavior-at-bar-lines.ly}
 333
 334 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 335 {setting-the-minimum-length-of-hairpins.ly}
 336
 337 @cindex al niente
 338 @cindex niente, al
 339
 340 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 341 {printing-hairpins-using-al-niente-notation.ly}
 342
 343 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 344 {vertically-aligned-dynamics-and-textscripts.ly}
 345
 346 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 347 {hiding-the-extender-line-for-text-dynamics.ly}
 348
 349 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 350 {changing-text-and-spanner-styles-for-text-dynamics.ly}
 351
 352
 353 @seealso
 354 Music Glossary:
 355 @rglos{al niente},
 356 @rglos{crescendo},
 357 @rglos{decrescendo},
 358 @rglos{hairpin}.
 359
 360 Learning Manual:
 361 @rlearning{Articulation and dynamics}.
 362
 363 Notation Reference:
 364 @ref{Direction and placement},
 365 @ref{New dynamic marks},
 366 @ref{What goes into the MIDI output?},
 367 @ref{Controlling MIDI dynamics}.
 368
 369 Snippets:
 370 @rlsr{Expressive marks}.
 371
 372 Internals Reference:
 373 @rinternals{DynamicText},
 374 @rinternals{Hairpin},
 375 @rinternals{DynamicLineSpanner}.
 376
 377
 378 @node New dynamic marks
 379 @unnumberedsubsubsec New dynamic marks
 380
 381 @cindex new dynamic marks
 382 @cindex dynamic marks, new
 383
 384 The easiest way to create dynamic indications is to use
 385 @code{\markup} objects.
 386
 387 @lilypond[verbatim,quote]
 388 moltoF = \markup { molto \dynamic f }
 389
 390 \relative c' {
 391   <d e>16_\moltoF <d e>
 392   <d e>2..
 393 }
 394 @end lilypond
 395
 396 @cindex dynamics, editorial
 397 @cindex dynamics, parenthesis
 398 @cindex editorial dynamics
 399 @funindex \bracket
 400 @funindex bracket
 401 @funindex \dynamic
 402 @funindex dynamic
 403
 404 In markup mode, editorial dynamics (within parentheses or square
 405 brackets) can be created.  The syntax for markup mode is described
 406 in @ref{Formatting text}.
 407
 408 @lilypond[verbatim,quote]
 409 roundF = \markup { \center-align \concat { \bold { \italic ( }
 410            \dynamic f \bold { \italic ) } } }
 411 boxF = \markup { \bracket { \dynamic f } }
 412 \relative c' {
 413   c1_\roundF
 414   c1_\boxF
 415 }
 416 @end lilypond
 417
 418 @cindex make-dynamic-script
 419 @funindex make-dynamic-script
 420
 421 Simple, centered dynamic marks are easily created with the
 422 @code{make-dynamic-script} function.
 423
 424 @lilypond[verbatim,quote]
 425 sfzp = #(make-dynamic-script "sfzp")
 426 \relative c' {
 427   c4 c c\sfzp c
 428 }
 429 @end lilypond
 430
 431 In general, @code{make-dynamic-script} takes any markup object as its
 432 argument.  The dynamic font only contains the characters
 433 @code{f,m,p,r,s} and @code{z}, so if a dynamic mark that includes
 434 plain text or punctuation symbols is desired, markup commands that
 435 reverts font family and font encoding to normal text should be used,
 436 for example @code{\normal-text}.  The interest of using
 437 @code{make-dynamic-script} instead of an ordinary markup is ensuring
 438 the vertical alignment of markup objects and hairpins that are
 439 attached to the same note head.
 440
 441 @lilypond[verbatim,quote]
 442 roundF = \markup { \center-align \concat {
 443            \normal-text { \bold { \italic ( } }
 444            \dynamic f
 445            \normal-text { \bold { \italic ) } } } }
 446 boxF = \markup { \bracket { \dynamic f } }
 447 mfEspress = \markup { \center-align \line {
 448               \hspace #3.7 mf \normal-text \italic espress. } }
 449 roundFdynamic = #(make-dynamic-script roundF)
 450 boxFdynamic = #(make-dynamic-script boxF)
 451 mfEspressDynamic = #(make-dynamic-script mfEspress)
 452 \relative c' {
 453   c4_\roundFdynamic\< d e f
 454   g,1~_\boxFdynamic\>
 455   g
 456   g'~\mfEspressDynamic
 457   g
 458 }
 459 @end lilypond
 460
 461 The Scheme form of markup mode may be used instead.  Its syntax is
 462 explained in @ref{Markup construction in Scheme}.
 463
 464 @lilypond[verbatim,quote]
 465 moltoF = #(make-dynamic-script
 466             (markup #:normal-text "molto"
 467                     #:dynamic "f"))
 468 \relative c' {
 469   <d e>16 <d e>
 470   <d e>2..\moltoF
 471 }
 472 @end lilypond
 473
 474 Font settings in markup mode are described in
 475 @ref{Selecting font and font size}.
 476
 477
 478 @seealso
 479 Notation Reference:
 480 @ref{Formatting text},
 481 @ref{Selecting font and font size},
 482 @ref{Markup construction in Scheme},
 483 @ref{What goes into the MIDI output?},
 484 @ref{Controlling MIDI dynamics}.
 485
 486 Snippets:
 487 @rlsr{Expressive marks}.
 488
 489
 490 @node Curves
 491 @subsection Curves
 492
 493 This section explains how to create various expressive marks that
 494 are curved: normal slurs, phrasing slurs, breath marks, falls, and
 495 doits.
 496
 497 @menu
 498 * Slurs::
 499 * Phrasing slurs::
 500 * Breath marks::
 501 * Falls and doits::
 502 @end menu
 503
 504 @node Slurs
 505 @unnumberedsubsubsec Slurs
 506
 507 @cindex slurs
 508
 509 @notation{Slurs} are entered using parentheses:
 510
 511 @lilypond[verbatim,quote,relative=2]
 512 f4( g a) a8 b(
 513 a4 g2 f4)
 514 <c e>2( <b d>2)
 515 @end lilypond
 516
 517 @cindex slurs, manual placement
 518 @cindex slurs, below notes
 519 @cindex slurs, above notes
 520 @funindex \slurDown
 521 @funindex slurDown
 522 @funindex \slurNeutral
 523 @funindex slurNeutral
 524
 525 Slurs may be manually placed above or below the notes, see
 526 @ref{Direction and placement}.
 527
 528 @lilypond[verbatim,quote,relative=2]
 529 c2( d)
 530 \slurDown
 531 c2( d)
 532 \slurNeutral
 533 c2( d)
 534 @end lilypond
 535
 536 @cindex phrasing slur
 537 @cindex multiple slurs
 538 @cindex simultaneous slurs
 539 @cindex slur, phrasing
 540 @cindex slurs, multiple
 541 @cindex slurs, simultaneous
 542
 543 Simultaneous or overlapping slurs are not permitted, but a phrasing
 544 slur can overlap a slur.  This permits two slurs to be printed at
 545 once.  For details, see @ref{Phrasing slurs}.
 546
 547 @cindex slur style
 548 @cindex solid slur
 549 @cindex dotted slur
 550 @cindex dashed slur
 551 @cindex slur, solid
 552 @cindex slur, dotted
 553 @cindex slur, dashed
 554 @cindex solid slur
 555 @cindex dotted slur
 556 @cindex dashed slur
 557 @cindex sytle, slur
 558 @funindex \slurDashed
 559 @funindex slurDashed
 560 @funindex \slurDotted
 561 @funindex slurDotted
 562 @funindex \slurSolid
 563 @funindex slurSolid
 564
 565 Slurs can be solid, dotted, or dashed.  Solid is the default slur
 566 style:
 567
 568 @lilypond[verbatim,quote,relative=1]
 569 c4( e g2)
 570 \slurDashed
 571 g4( e c2)
 572 \slurDotted
 573 c4( e g2)
 574 \slurSolid
 575 g4( e c2)
 576 @end lilypond
 577
 578 @funindex \slurUp
 579 @funindex slurUp
 580
 581
 582 @predefined
 583 @code{\slurUp},
 584 @code{\slurDown},
 585 @code{\slurNeutral},
 586 @code{\slurDashed},
 587 @code{\slurDotted},
 588 @code{\slurSolid}.
 589 @endpredefined
 590
 591
 592 @snippets
 593
 594 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 595 {using-double-slurs-for-legato-chords.ly}
 596
 597 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 598 {positioning-text-markups-inside-slurs.ly}
 599
 600 @seealso
 601 Music Glossary:
 602 @rglos{slur}.
 603
 604 Learning Manual:
 605 @rlearning{On the un-nestedness of brackets and ties}.
 606
 607 Notation Reference:
 608 @ref{Direction and placement},
 609 @ref{Phrasing slurs}.
 610
 611 Snippets:
 612 @rlsr{Expressive marks}.
 613
 614 Internals Reference:
 615 @rinternals{Slur}.
 616
 617
 618 @node Phrasing slurs
 619 @unnumberedsubsubsec Phrasing slurs
 620
 621 @cindex phrasing slurs
 622 @cindex phrasing marks
 623 @cindex slur, phrasing
 624 @cindex mark, phrasing
 625 @funindex \(
 626 @funindex \)
 627
 628 @notation{Phrasing slurs} (or phrasing marks) that indicate a
 629 musical sentence are written using the commands @code{\(} and
 630 @code{\)} respectively:
 631
 632 @lilypond[verbatim,quote,relative=2]
 633 c4\( d( e) f(
 634 e2) d\)
 635 @end lilypond
 636
 637 @funindex \phrasingSlurUp
 638 @funindex phrasingSlurUp
 639 @funindex \phrasingSlurDown
 640 @funindex phrasingSlurDown
 641 @funindex \phrasingSlurNeutral
 642 @funindex phrasingSlurNeutral
 643 @funindex phrasingSlurDashed
 644 @funindex \phrasingSlurDashed
 645 @funindex \phrasingSlurDotted
 646 @funindex phrasingSlurDotted
 647 @funindex \phrasingSlurSolid
 648 @funindex phrasingSlurSolid
 649
 650 Typographically, a phrasing slur behaves almost exactly like a
 651 normal slur.  However, they are treated as different objects; a
 652 @code{\slurUp} will have no effect on a phrasing slur.  Phrasing
 653 slurs may be manually placed above or below the notes, see
 654 @ref{Direction and placement}.
 655
 656 @lilypond[verbatim,quote,relative=1]
 657 c4\( g' c,( b) | c1\)
 658 \phrasingSlurUp
 659 c4\( g' c,( b) | c1\)
 660 @end lilypond
 661
 662 @cindex simultaneous phrasing slurs
 663 @cindex multiple phrasing slurs
 664 @cindex slurs, simultaneous phrasing
 665 @cindex slurs, multiple phrasing
 666 @cindex phrasing slurs, simultaneous
 667 @cindex phrasing slurs, multiple
 668
 669 Simultaneous or overlapping phrasing slurs are not permitted.
 670
 671 Phrasing slurs can be solid, dotted, or dashed.  Solid is the default
 672 style for phrasing slurs:
 673
 674 @lilypond[verbatim,quote,relative=1]
 675 c4\( e g2\)
 676 \phrasingSlurDashed
 677 g4\( e c2\)
 678 \phrasingSlurDotted
 679 c4\( e g2\)
 680 \phrasingSlurSolid
 681 g4\( e c2\)
 682 @end lilypond
 683
 684
 685 @predefined
 686 @code{\phrasingSlurUp},
 687 @code{\phrasingSlurDown},
 688 @code{\phrasingSlurNeutral},
 689 @code{\phrasingSlurDashed},
 690 @code{\phrasingSlurDotted},
 691 @code{\phrasingSlurSolid}.
 692 @endpredefined
 693
 694
 695 @seealso
 696 Learning Manual:
 697 @rlearning{On the un-nestedness of brackets and ties}.
 698
 699 Notation Reference:
 700 @ref{Direction and placement}.
 701
 702 Snippets:
 703 @rlsr{Expressive marks}.
 704
 705 Internals Reference:
 706 @rinternals{PhrasingSlur}.
 707
 708
 709 @node Breath marks
 710 @unnumberedsubsubsec Breath marks
 711
 712 @cindex breath marks
 713 @cindex pause mark
 714 @funindex \breathe
 715 @funindex breathe
 716
 717 Breath marks are entered using @code{\breathe}:
 718
 719 @lilypond[verbatim,quote,relative=2]
 720 c2. \breathe d4
 721 @end lilypond
 722
 723 Musical indicators for breath marks in ancient notation,
 724 divisiones, are supported.  For details, see @ref{Divisiones}.
 725
 726
 727 @snippets
 728
 729 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 730 {changing-the-breath-mark-symbol.ly}
 731
 732 @cindex caesura
 733 @cindex railroad tracks
 734
 735 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 736 {inserting-a-caesura.ly}
 737
 738
 739 @seealso
 740 Music Glossary:
 741 @rglos{caesura}.
 742
 743 Notation Reference:
 744 @ref{Divisiones}.
 745
 746 Snippets:
 747 @rlsr{Expressive marks}.
 748
 749 Internals Reference:
 750 @rinternals{BreathingSign}.
 751
 752
 753 @node Falls and doits
 754 @unnumberedsubsubsec Falls and doits
 755
 756 @cindex falls
 757 @cindex doits
 758 @funindex \bendAfter
 759 @funindex bendAfter
 760
 761 @notation{Falls} and @notation{doits} can be added to notes using
 762 the @code{\bendAfter} command.  The direction of the fall or doit
 763 is indicated with a plus or minus (up or down).  The number
 764 indicates the pitch interval that the fall or doit will extend
 765 @emph{beyond} the main note.
 766
 767 @lilypond[verbatim,quote,relative=2]
 768 c2-\bendAfter #+4
 769 c2-\bendAfter #-4
 770 c2-\bendAfter #+8
 771 c2-\bendAfter #-8
 772 @end lilypond
 773
 774 The dash @code{-} immediately preceding the @code{\bendAfter}
 775 command is @emph{required} when writing falls and doits.
 776
 777
 778 @snippets
 779
 780 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 781 {adjusting-the-shape-of-falls-and-doits.ly}
 782
 783
 784 @seealso
 785 Music Glossary:
 786 @rglos{fall},
 787 @rglos{doit}.
 788
 789 Snippets:
 790 @rlsr{Expressive marks}.
 791
 792
 793 @node Lines
 794 @subsection Lines
 795
 796 This section explains how to create various expressive marks that
 797 follow a linear path: glissandos, arpeggios, and trills.
 798
 799 @menu
 800 * Glissando::
 801 * Arpeggio::
 802 * Trills::
 803 @end menu
 804
 805 @node Glissando
 806 @unnumberedsubsubsec Glissando
 807
 808 @cindex glissando
 809 @funindex \glissando
 810 @funindex glissando
 811
 812 A @notation{glissando} is created by attaching @code{\glissando}
 813 to a note:
 814
 815 @lilypond[verbatim,quote,relative=2]
 816 g2\glissando g'
 817 c2\glissando c,
 818 @end lilypond
 819
 820 Different styles of glissandi can be created.  For details, see
 821 @ref{Line styles}.
 822
 823 @snippets
 824
 825 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 826 {contemporary-glissando.ly}
 827
 828
 829 @seealso
 830 Music Glossary:
 831 @rglos{glissando}.
 832
 833 Notation Reference:
 834 @ref{Line styles}.
 835
 836 Snippets:
 837 @rlsr{Expressive marks}.
 838
 839 Internals Reference:
 840 @rinternals{Glissando}.
 841
 842
 843 @knownissues
 844
 845 Printing text over the line (such as @notation{gliss.}) is not
 846 supported.
 847
 848
 849 @node Arpeggio
 850 @unnumberedsubsubsec Arpeggio
 851
 852 @cindex arpeggio
 853 @cindex broken chord
 854 @cindex chord, broken
 855
 856 @funindex \arpeggio
 857 @funindex arpeggio
 858 @funindex \arpeggioArrowUp
 859 @funindex arpeggioArrowUp
 860 @funindex \arpeggioArrowDown
 861 @funindex arpeggioArrowDown
 862 @funindex \arpeggioNormal
 863 @funindex arpeggioNormal
 864
 865 An @notation{arpeggio} on a chord (also known as a broken chord)
 866 is denoted by appending @code{\arpeggio} to the chord construct:
 867
 868 @lilypond[verbatim,quote,relative=1]
 869 <c e g c>1\arpeggio
 870 @end lilypond
 871
 872 Different types of arpeggios may be written.
 873 @code{\arpeggioNormal} reverts to a normal arpeggio:
 874
 875 @lilypond[verbatim,quote,relative=1]
 876 <c e g c>2\arpeggio
 877 \arpeggioArrowUp
 878 <c e g c>2\arpeggio
 879 \arpeggioArrowDown
 880 <c e g c>2\arpeggio
 881 \arpeggioNormal
 882 <c e g c>2\arpeggio
 883 @end lilypond
 884
 885 @cindex arpeggio symbols, special
 886 @cindex special arpeggio symbols
 887
 888 @funindex \arpeggioBracket
 889 @funindex arpeggioBracket
 890 @funindex \arpeggioParenthesis
 891 @funindex arpeggioParenthesis
 892
 893 Special @emph{bracketed} arpeggio symbols can be created:
 894
 895 @lilypond[verbatim,quote,relative=1]
 896 <c e g c>2
 897 \arpeggioBracket
 898 <c e g c>2\arpeggio
 899 \arpeggioParenthesis
 900 <c e g c>2\arpeggio
 901 \arpeggioNormal
 902 <c e g c>2\arpeggio
 903 @end lilypond
 904
 905 Arpeggios can be explicitly written out with ties.  For more
 906 information, see @ref{Ties}.
 907
 908
 909 @predefined
 910 @code{\arpeggio},
 911 @code{\arpeggioArrowUp},
 912 @code{\arpeggioArrowDown},
 913 @code{\arpeggioNormal},
 914 @code{\arpeggioBracket},
 915 @code{\arpeggioParenthesis}.
 916 @endpredefined
 917
 918
 919 @snippets
 920
 921 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 922 {creating-cross-staff-arpeggios-in-a-piano-staff.ly}
 923
 924 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 925 {creating-cross-staff-arpeggios-in-other-contexts.ly}
 926
 927 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 928 {creating-arpeggios-across-notes-in-different-voices.ly}
 929
 930
 931 @seealso
 932 Music Glossary:
 933 @rglos{arpeggio}.
 934
 935 Notation Reference:
 936 @ref{Ties}.
 937
 938 Snippets:
 939 @rlsr{Expressive marks}.
 940
 941 Internals Reference:
 942 @rinternals{Arpeggio},
 943 @rinternals{PianoStaff}.
 944
 945
 946 @knownissues
 947
 948 @cindex cross-staff parenthesis-style arpeggio
 949 @cindex arpeggio, parenthesis-style, cross-staff
 950 @cindex arpeggio, cross-staff parenthesis-style
 951
 952 It is not possible to mix connected arpeggios and unconnected
 953 arpeggios in one @code{PianoStaff} at the same point in
 954 time.
 955
 956 The parenthesis-style arpeggio brackets do not work for
 957 cross-staff arpeggios.
 958
 959
 960 @node Trills
 961 @unnumberedsubsubsec Trills
 962
 963 @cindex trills
 964
 965 @funindex \trill
 966 @funindex trill
 967 @funindex \startTrillSpan
 968 @funindex startTrillSpan
 969 @funindex \stopTrillSpan
 970 @funindex stopTrillSpan
 971
 972 Short @notation{trills} without an extender line are printed with
 973 @code{\trill}; see @ref{Articulations and ornamentations}.
 974
 975 Longer trills with an extender line are made with
 976 @code{\startTrillSpan} and @code{\stopTrillSpan}:
 977
 978 @lilypond[verbatim,quote,relative=2]
 979 d1~\startTrillSpan
 980 d1
 981 c2\stopTrillSpan r2
 982 @end lilypond
 983
 984 In the following example, a trill is combined with grace notes.
 985 The syntax of this construct and the method to precisely position
 986 the grace notes are described in @ref{Grace notes}.
 987
 988 @lilypond[verbatim,quote,relative=2]
 989 c1 \afterGrace
 990 d1\startTrillSpan { c32[ d]\stopTrillSpan }
 991 e2 r2
 992 @end lilypond
 993
 994 @cindex pitched trills
 995 @cindex trills, pitched
 996 @funindex \pitchedTrill
 997 @funindex pitchedTrill
 998
 999 Trills that require an auxiliary note with an explicit pitch can
1000 be typeset with the @code{\pitchedTrill} command.  The first
1001 argument is the main note, and the second is the @emph{trilled}
1002 note, printed as a stemless note head in parentheses.
1003
1004 @lilypond[verbatim,quote,relative=1]
1005 \pitchedTrill e2\startTrillSpan fis
1006 d\stopTrillSpan
1007 @end lilypond
1008
1009 @cindex pitched trill with forced accidental
1010 @cindex trill, pitched with forced accidental
1011 @cindex accidental, forced for pitched trill
1012
1013 In the following example, the second pitched trill is ambiguous;
1014 the accidental of the trilled note is not printed.  As a
1015 workaround, the accidentals of the trilled notes can be forced.
1016 The second measure illustrates this method:
1017
1018 @lilypond[verbatim,quote,relative=2]
1019 \pitchedTrill eis4\startTrillSpan fis
1020 g\stopTrillSpan
1021 \pitchedTrill eis4\startTrillSpan fis
1022 g\stopTrillSpan
1023 \pitchedTrill eis4\startTrillSpan fis
1024 g\stopTrillSpan
1025 \pitchedTrill eis4\startTrillSpan fis!
1026 g\stopTrillSpan
1027 @end lilypond
1028
1029
1030 @predefined
1031 @code{\startTrillSpan},
1032 @code{\stopTrillSpan}.
1033 @endpredefined
1034
1035
1036 @seealso
1037 Music Glossary:
1038 @rglos{trill}.
1039
1040 Notation Reference:
1041 @ref{Articulations and ornamentations},
1042 @ref{Grace notes}.
1043
1044 Snippets:
1045 @rlsr{Expressive marks}.
1046
1047 Internals Reference:
1048 @rinternals{TrillSpanner}.
1049