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.11.51"
  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 scripts
  44 @cindex ornaments
  45 @cindex espressivo
  46 @cindex fermata
  47 @cindex upbow
  48 @cindex downbow
  49 @cindex foot marks
  50 @cindex organ pedal marks
  51 @cindex turn
  52 @cindex open
  53 @cindex stopped
  54 @cindex flageolet
  55 @cindex reverseturn
  56 @cindex trill
  57 @cindex prall
  58 @cindex mordent
  59 @cindex prallprall
  60 @cindex prallmordent
  61 @cindex prall, up
  62 @cindex prall, down
  63 @cindex thumb marking
  64 @cindex segno
  65 @cindex coda
  66 @cindex varcoda
  67
  68 A variety of symbols that denote articulations, ornamentations,
  69 and other performance indications can be attached to a note using
  70 this syntax:
  71
  72 @example
  73 @var{note}\@var{name}
  74 @end example
  75
  76 The possible values for @var{name} are listed in @ref{List of
  77 articulations}.  For example:
  78
  79 @lilypond[verbatim,quote,relative=2]
  80 c4\staccato c\mordent b2\turn
  81 c1\fermata
  82 @end lilypond
  83
  84 @cindex marcato
  85 @cindex stopped
  86 @cindex tenuto
  87 @cindex staccatissimo
  88 @cindex accent
  89 @cindex staccato
  90 @cindex portato
  91
  92 Some of these articulations have shorthands for easier entry.
  93 Shorthands are appended to the note name, and their syntax
  94 consists of a dash (@tie{}@code{-}) followed by a symbol
  95 signifying the articulation.  Predefined shorthands exist for
  96 @notation{marcato}, @notation{stopped}, @notation{tenuto},
  97 @notation{staccatissimo}, @notation{accent}, @notation{staccato},
  98 and @notation{portato}.  Their corresponding output appears as
  99 follows:
 100
 101 @lilypond[verbatim,quote,relative=2]
 102 c4-^  c-+  c--  c-|
 103 c4->  c-.  c-_
 104 @end lilypond
 105
 106 The rules for the default placement of articulations are defined
 107 in @file{scm/@/script@/.scm}.  Articulations and ornamentations
 108 may be manually placed above or below the staff, see
 109 @ref{Direction and placement}.
 110
 111
 112 @snippets
 113
 114 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 115 {modifying-default-values-for-articulation-shorthand-notation.ly}
 116
 117 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 118 {controlling-the-vertical-ordering-of-scripts.ly}
 119
 120
 121 @seealso
 122
 123 Music Glossary:
 124 @rglos{tenuto},
 125 @rglos{accent},
 126 @rglos{staccato},
 127 @rglos{portato}.
 128
 129 Notation Reference:
 130 @ref{Direction and placement},
 131 @ref{List of articulations}.
 132
 133 Installed Files:
 134 @file{scm/@/script@/.scm}.
 135
 136 Snippets:
 137 @rlsr{Expressive marks}.
 138
 139 Internals Reference:
 140 @rinternals{Script},
 141 @rinternals{TextScript}.
 142
 143
 144 @knownissues
 145
 146 These signs appear in the printed output but have no effect on the
 147 MIDI rendering of the music.
 148
 149
 150 @node Dynamics
 151 @unnumberedsubsubsec Dynamics
 152
 153 @cindex absolute dynamics
 154 @cindex dynamics
 155 @cindex dynamics, absolute
 156 @funindex \ppppp
 157 @funindex \pppp
 158 @funindex \ppp
 159 @funindex \pp
 160 @funindex \p
 161 @funindex \mp
 162 @funindex \mf
 163 @funindex \f
 164 @funindex \ff
 165 @funindex \fff
 166 @funindex \ffff
 167 @funindex \fp
 168 @funindex \sf
 169 @funindex \sff
 170 @funindex \sp
 171 @funindex \spp
 172 @funindex \sfz
 173 @funindex \rfz
 174
 175 Absolute dynamic marks are specified using a command after a note,
 176 such as @code{c4\ff}.  The available dynamic marks are
 177 @code{\ppppp}, @code{\pppp}, @code{\ppp}, @code{\pp}, @code{\p},
 178 @code{\mp}, @code{\mf}, @code{\f}, @code{\ff}, @code{\fff},
 179 @code{\ffff}, @code{\fp}, @code{\sf}, @code{\sff}, @code{\sp},
 180 @code{\spp}, @code{\sfz}, and @code{\rfz}.  The dynamic marks may
 181 be manually placed above or below the staff, see
 182 @ref{Direction and placement}.
 183
 184 @lilypond[verbatim,quote,relative=2]
 185 c2\ppp c\mp
 186 c2\rfz c^\mf
 187 c2_\spp c^\ff
 188 @end lilypond
 189
 190 @cindex hairpin
 191 @funindex \<
 192 @funindex \>
 193 @funindex \!
 194 @funindex \cr
 195 @funindex \decr
 196
 197 A @notation{crescendo} mark is started with @code{\<} and
 198 terminated with @code{\!}, an absolute dynamic, or an additional
 199 crescendo or decrescendo mark.  A @notation{decrescendo} mark is
 200 started with @code{\>} and is also terminated with @code{\!}, an
 201 absolute dynamic, or another crescendo or decrescendo mark.
 202 @code{\cr} and @code{\decr} may be used instead of @code{\<} and
 203 @code{\>}.  @notation{Hairpins} are engraved by default using this
 204 notation.
 205
 206 @lilypond[verbatim,quote,relative=2]
 207 c2\< c\!
 208 d2\< d\f
 209 e2\< e\>
 210 f2\> f\!
 211 e2\> e\mp
 212 d2\> d\>
 213 c1\!
 214 @end lilypond
 215
 216 Spacer rests are needed to engrave multiple marks on one note.
 217
 218 @lilypond[verbatim,quote,relative=2]
 219 c4\< c\! d\> e\!
 220 << f1 { s4 s4\< s4\> s4\! } >>
 221 @end lilypond
 222
 223 @cindex espressivo articulation
 224
 225 In some situations the @code{\espressivo} articulation mark may be
 226 the appropriate choice to indicate a crescendo and decrescendo on
 227 one note:
 228
 229 @lilypond[verbatim,quote,relative=2]
 230 c2 b4 a
 231 g1\espressivo
 232 @end lilypond
 233
 234 @cindex crescendo
 235 @cindex decrescendo
 236 @cindex diminuendo
 237
 238 Crescendos and decrescendos can be engraved as textual markings
 239 instead of hairpins.  The built-in commands that enable these text
 240 modes are @code{\crescTextCresc}, @code{\dimTextDecresc},
 241 @code{\dimTextDecr}, and @code{\dimTextDim}.  The corresponding
 242 @code{\crescHairpin} and @code{\dimHairpin} commands will revert to
 243 hairpins again:
 244
 245 @lilypond[verbatim,quote,relative=2]
 246 c4\< d e f\!
 247 e4\> d c b\!
 248 \crescTextCresc
 249 c4\< d e f\!
 250 \dimTextDecresc
 251 e4\> d c b\!
 252 \crescHairpin
 253 c4\< d e f\!
 254 @end lilypond
 255
 256 To create new absolute dynamic marks or text that should be
 257 aligned with dynamics, see @ref{New dynamic marks}.
 258
 259 Vertical positioning of dynamics is handled by
 260 @rinternals{DynamicLineSpanner}.
 261
 262
 263 @predefined
 264
 265 @funindex \dynamicUp
 266 @code{\dynamicUp},
 267 @funindex \dynamicDown
 268 @code{\dynamicDown},
 269 @funindex \dynamicNeutral
 270 @code{\dynamicNeutral},
 271 @funindex \crescTextCresc
 272 @code{\crescTextCresc},
 273 @funindex \dimTextDim
 274 @code{\dimTextDim},
 275 @funindex \dimTextDecr
 276 @code{\dimTextDecr},
 277 @funindex \dimTextDecresc
 278 @code{\dimTextDecresc},
 279 @funindex \crescHairpin
 280 @code{\crescHairpin},
 281 @funindex \dimHairpin
 282 @code{\dimHairpin}.
 283
 284
 285 @snippets
 286
 287 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 288 {setting-hairpin-behavior-at-bar-lines.ly}
 289
 290 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 291 {setting-the-minimum-length-of-hairpins.ly}
 292
 293 @cindex al niente
 294 @cindex niente, al
 295
 296 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 297 {printing-hairpins-using-al-niente-notation.ly}
 298
 299 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 300 {vertically-aligning-dynamics-across-multiple-notes.ly}
 301
 302 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 303 {hiding-the-extender-line-for-text-dynamics.ly}
 304
 305 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 306 {changing-text-and-spanner-styles-for-text-dynamics.ly}
 307
 308
 309 @seealso
 310
 311 @c TODO: Add hairpin to glossary.
 312
 313 Music Glossary:
 314 @rglos{crescendo},
 315 @rglos{decrescendo}.
 316
 317 Learning Manual:
 318 @rlearning{Articulation and dynamics}.
 319
 320 Notation Reference:
 321 @ref{Direction and placement},
 322 @ref{New dynamic marks}.
 323
 324 Snippets:
 325 @rlsr{Expressive marks}.
 326
 327 Internals Reference:
 328 @rinternals{DynamicText},
 329 @rinternals{Hairpin},
 330 @rinternals{DynamicLineSpanner}.
 331
 332
 333 @node New dynamic marks
 334 @unnumberedsubsubsec New dynamic marks
 335
 336 @cindex new dynamic marks
 337 @cindex dynamic marks, new
 338
 339 The easiest way to create dynamic indications is to use
 340 @code{\markup} objects.
 341
 342 @lilypond[verbatim,quote]
 343 moltoF = \markup { molto \dynamic f }
 344
 345 \relative c' {
 346   <d e>16 <d e>
 347   <d e>2.._\moltoF
 348 }
 349 @end lilypond
 350
 351 @cindex dynamics, editorial
 352 @cindex dynamics, parenthesis
 353
 354 In markup mode, editorial dynamics (within parentheses or square
 355 brackets) can be created.  The syntax for markup mode is described
 356 in @ref{Formatting text}.
 357
 358 @lilypond[verbatim,quote]
 359 roundf = \markup { \center-align { \line { \bold { \italic ( }
 360          \dynamic f \bold { \italic ) } } } }
 361 boxf = \markup { \bracket { \dynamic f } }
 362 \relative c' {
 363   c1_\roundf
 364   c1_\boxf
 365 }
 366 @end lilypond
 367
 368 By default, markup objects are aligned to the left side of a note
 369 head, but authentic dynamic marks are always centered on the note
 370 head.  New, centered dynamic marks can be created using the
 371 following function:
 372
 373 @cindex make-dynamic-script
 374
 375 @lilypond[verbatim,quote]
 376 sfzp = #(make-dynamic-script "sfzp")
 377 \relative c' {
 378   c4 c c\sfzp c
 379 }
 380 @end lilypond
 381
 382 @noindent
 383 The dynamic font only contains the characters @code{f,m,p,r,s} and
 384 @code{z}.  In order to use other font families, it is necessary to
 385 use markup mode in its Scheme form, as explained in
 386 @ref{Markup construction in Scheme}.
 387
 388 @lilypond[verbatim,quote]
 389 moltoF = #(make-dynamic-script (markup
 390                       #:normal-text "molto"
 391                       #:dynamic "f"))
 392 \relative c' {
 393   <d e>16 <d e>
 394   <d e>2..\moltoF
 395 }
 396 @end lilypond
 397
 398 @noindent
 399 Font settings in markup mode are described in
 400 @ref{Common markup commands}.
 401
 402
 403 @seealso
 404
 405 Notation Reference:
 406 @ref{Formatting text},
 407 @ref{Common markup commands},
 408 @ref{Markup construction in Scheme}.
 409
 410 Snippets:
 411 @rlsr{Expressive marks}.
 412
 413
 414 @node Curves
 415 @subsection Curves
 416
 417 This section explains how to create various expressive marks that
 418 are curved: normal slurs, phrasing slurs, breath marks, falls, and
 419 doits.
 420
 421 @menu
 422 * Slurs::
 423 * Phrasing slurs::
 424 * Breath marks::
 425 * Falls and doits::
 426 @end menu
 427
 428 @node Slurs
 429 @unnumberedsubsubsec Slurs
 430
 431 @cindex slurs
 432
 433 @notation{Slurs} are entered using parentheses:
 434
 435 @lilypond[verbatim,quote,relative=2]
 436 f4( g a) a8 b(
 437 a4 g2 f4)
 438 <c e>2( <b d>2)
 439 @end lilypond
 440
 441 Slurs may be manually placed above or below the notes, see
 442 @ref{Direction and placement}.
 443
 444 @lilypond[verbatim,quote,relative=2]
 445 c2( d)
 446 \slurDown
 447 c2( d)
 448 \slurNeutral
 449 c2( d)
 450 @end lilypond
 451
 452 Phrasing slurs must be used to print more than one slur at once.
 453 For details, see @ref{Phrasing slurs}.
 454
 455 Slurs can be solid, dotted, or dashed.  Solid is the default slur
 456 style:
 457
 458 @lilypond[verbatim,quote,relative=1]
 459 c4( e g2)
 460 \slurDashed
 461 g4( e c2)
 462 \slurDotted
 463 c4( e g2)
 464 \slurSolid
 465 g4( e c2)
 466 @end lilypond
 467
 468
 469 @predefined
 470
 471 @funindex \slurUp
 472 @code{\slurUp},
 473 @funindex \slurDown
 474 @code{\slurDown},
 475 @funindex \slurNeutral
 476 @code{\slurNeutral},
 477 @funindex \slurDashed
 478 @code{\slurDashed},
 479 @funindex \slurDotted
 480 @code{\slurDotted},
 481 @funindex \slurSolid
 482 @code{\slurSolid}.
 483
 484
 485 @snippets
 486
 487 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 488 {using-double-slurs-for-legato-chords.ly}
 489
 490
 491 @seealso
 492
 493 Music Glossary:
 494 @rglos{slur}.
 495
 496 Notation Reference:
 497 @ref{Direction and placement},
 498 @ref{Phrasing slurs}.
 499
 500 Snippets:
 501 @rlsr{Expressive marks}.
 502
 503 Internals Reference:
 504 @rinternals{Slur}.
 505
 506
 507 @node Phrasing slurs
 508 @unnumberedsubsubsec Phrasing slurs
 509
 510 @cindex phrasing slurs
 511 @cindex phrasing marks
 512 @funindex \(
 513 @funindex \)
 514
 515 @notation{Phrasing slurs} (or phrasing marks) that indicate a
 516 musical sentence are written using the commands @code{\(} and
 517 @code{\)} respectively:
 518
 519 @lilypond[verbatim,quote,relative=2]
 520 c4\( d( e) f(
 521 e2) d\)
 522 @end lilypond
 523
 524 Typographically, a phrasing slur behaves almost exactly like a
 525 normal slur.  However, they are treated as different objects; a
 526 @code{\slurUp} will have no effect on a phrasing slur.  Phrasing
 527 slurs may be manually placed above or below the notes, see
 528 @ref{Direction and placement}.
 529
 530 @lilypond[verbatim,quote,relative=1]
 531 c4\( g' c,( b) | c1\)
 532 \phrasingSlurUp
 533 c4\( g' c,( b) | c1\)
 534 @end lilypond
 535
 536 Simultaneous phrasing slurs are not permitted.
 537
 538
 539 @predefined
 540
 541 @funindex \phrasingSlurUp
 542 @code{\phrasingSlurUp},
 543 @funindex \phrasingSlurDown
 544 @code{\phrasingSlurDown},
 545 @funindex \phrasingSlurNeutral
 546 @code{\phrasingSlurNeutral}.
 547
 548
 549 @seealso
 550
 551 Notation Reference:
 552 @ref{Direction and placement}.
 553
 554 Snippets:
 555 @rlsr{Expressive marks}.
 556
 557 Internals Reference:
 558 @rinternals{PhrasingSlur}.
 559
 560
 561 @node Breath marks
 562 @unnumberedsubsubsec Breath marks
 563
 564 @cindex breath marks
 565 @funindex \breathe
 566
 567 Breath marks are entered using @code{\breathe}:
 568
 569 @lilypond[verbatim,quote,relative=2]
 570 c2. \breathe d4
 571 @end lilypond
 572
 573 Musical indicators for breath marks in ancient notation,
 574 divisiones, are supported.  For details, see @ref{Divisiones}.
 575
 576
 577 @snippets
 578
 579 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 580 {changing-the-breath-mark-symbol.ly}
 581
 582 @cindex caesura
 583 @cindex railroad tracks
 584
 585 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 586 {inserting-a-caesura.ly}
 587
 588
 589 @seealso
 590
 591 Notation Reference:
 592 @ref{Divisiones}.
 593
 594 Snippets:
 595 @rlsr{Expressive marks}.
 596 @c @lsr{expressive,breathing-sign.ly}.
 597
 598 Internals Reference:
 599 @rinternals{BreathingSign}.
 600
 601
 602 @node Falls and doits
 603 @unnumberedsubsubsec Falls and doits
 604
 605 @cindex falls
 606 @cindex doits
 607 @funindex \bendAfter
 608
 609 @notation{Falls} and @notation{doits} can be added to notes using
 610 the @code{\bendAfter} command.  The direction of the fall or doit
 611 is indicated with a plus or minus (up or down).  The number
 612 indicates the pitch interval that the fall or doit will extend
 613 @emph{beyond} the main note.
 614
 615 @lilypond[verbatim,quote,relative=2]
 616 c2-\bendAfter #+4
 617 c2-\bendAfter #-4
 618 c2-\bendAfter #+8
 619 c2-\bendAfter #-8
 620 @end lilypond
 621
 622 The dash (@tie{-}) immediately preceding the @code{\bendAfter}
 623 command is @emph{required} when writing falls and doits.
 624
 625
 626 @snippets
 627
 628 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 629 {adjusting-the-shape-of-falls-and-doits.ly}
 630
 631
 632 @seealso
 633
 634 @c TODO: add falls and doits to glossary.
 635 @c Music Glossary:
 636 @c @rglos{falls},
 637 @c @rglos{doits}.
 638
 639 Snippets:
 640 @rlsr{Expressive marks}.
 641
 642
 643 @node Lines
 644 @subsection Lines
 645
 646 This section explains how to create various expressive marks that
 647 follow a linear path: glissandos, arpeggios, and trills.
 648
 649 @menu
 650 * Glissando::
 651 * Arpeggio::
 652 * Trills::
 653 @end menu
 654
 655 @node Glissando
 656 @unnumberedsubsubsec Glissando
 657
 658 @cindex glissando
 659 @funindex \glissando
 660
 661 A @notation{glissando} is created by attaching @code{\glissando}
 662 to a note:
 663
 664 @lilypond[verbatim,quote,relative=2]
 665 g2\glissando g'
 666 c2\glissando c,
 667 @end lilypond
 668
 669 Different styles of glissandi can be created.  For details, see
 670 @ref{Line styles}.
 671
 672 @snippets
 673
 674 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 675 {contemporary-glissando.ly}
 676
 677
 678 @seealso
 679
 680 Music Glossary:
 681 @rglos{glissando}.
 682
 683 Notation Reference:
 684 @ref{Line styles}.
 685
 686 Snippets:
 687 @rlsr{Expressive marks}.
 688
 689 @c FIXME: I need to figure out what's up with these.  -gp
 690 @c @lsr{expressive,glissando.ly},
 691 @c @lsr{expressive,line-styles.ly}
 692
 693 Internals Reference:
 694 @rinternals{Glissando}.
 695
 696
 697 @knownissues
 698
 699 Printing text over the line (such as @emph{gliss.}) is not
 700 supported.
 701
 702
 703 @node Arpeggio
 704 @unnumberedsubsubsec Arpeggio
 705
 706 @cindex arpeggio
 707 @cindex broken chord
 708 @cindex chord, broken
 709
 710 An @notation{arpeggio} on a chord (also known as a broken chord)
 711 is denoted by appending @code{\arpeggio} to the chord construct:
 712
 713 @lilypond[verbatim,quote,relative=1]
 714 <c e g c>1\arpeggio
 715 @end lilypond
 716
 717 The direction of an arpeggio is indicated by adding an arrowhead
 718 to the wiggly line.  The commands @code{\arpeggioArrowUp} and
 719 @code{\arpeggioArrowDown} are used for this task.
 720 @code{\arpeggioNormal} reverts back to an arrow-less arpeggio:
 721
 722 @lilypond[verbatim,quote,relative=1]
 723 \arpeggioArrowUp
 724 <c e g c>2\arpeggio
 725 \arpeggioArrowDown
 726 <c e g c>2\arpeggio
 727 \arpeggioNormal
 728 <c e g c>1\arpeggio
 729 @end lilypond
 730
 731 The command @code{\arpeggioBracket} can be used to create a square
 732 bracket on the left of a chord, indicating that the chord should
 733 @emph{not} be arpeggiated.  @code{\arpeggioNormal} reverts back
 734 to a regular arpeggio:
 735
 736 @lilypond[verbatim,quote,relative=1]
 737 <c e g c>2
 738 \arpeggioBracket
 739 <c e g c>2\arpeggio
 740 \arpeggioNormal
 741 <c e g c>1\arpeggio
 742 @end lilypond
 743
 744 A @emph{parenthesis} style bracket may be attached to a chord
 745 construct instead of a square bracket.
 746
 747 @lilypond[verbatim,quote,relative=1]
 748 <c e g c>2
 749 \arpeggioParenthesis
 750 <c e g c>2\arpeggio
 751 \arpeggioNormal
 752 <c e g c>1\arpeggio
 753 @end lilypond
 754
 755 Arpeggios can be explicitly written out with ties.  For more
 756 information, see @ref{Ties}.
 757
 758 @predefined
 759
 760 @funindex \arpeggio
 761 @code{\arpeggio},
 762 @funindex \arpeggioArrowUp
 763 @code{\arpeggioArrowUp},
 764 @funindex \arpeggioArrowDown
 765 @code{\arpeggioArrowDown},
 766 @funindex \arpeggioNormal
 767 @code{\arpeggioNormal},
 768 @funindex \arpeggioBracket
 769 @code{\arpeggioBracket},
 770 @funindex \arpeggioParenthesis
 771 @code{\arpeggioParenthesis}.
 772
 773
 774 @snippets
 775
 776 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 777 {creating-cross-staff-arpeggios-in-a-piano-staff.ly}
 778
 779 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 780 {creating-cross-staff-arpeggios-in-other-contexts.ly}
 781
 782 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 783 {creating-arpeggios-across-notes-in-different-voices.ly}
 784
 785
 786 @seealso
 787
 788 Music Glossary:
 789 @rglos{arpeggio}.
 790
 791 Notation Reference:
 792 @ref{Ties}.
 793
 794 Snippets:
 795 @rlsr{Expressive marks}.
 796
 797 Internals Reference:
 798 @rinternals{Arpeggio},
 799 @rinternals{PianoStaff}.
 800
 801
 802 @knownissues
 803
 804 It is not possible to mix connected arpeggios and unconnected
 805 arpeggios in one @code{PianoStaff} at the same point in
 806 time.
 807
 808 The parenthesis-style arpeggio brackets do not work for
 809 cross-staff arpeggios.
 810
 811
 812 @node Trills
 813 @unnumberedsubsubsec Trills
 814
 815 @cindex trills
 816 @funindex \trill
 817
 818 Short @notation{trills} without an extender line are printed with
 819 @code{\trill}; see @ref{Articulations and ornamentations}.
 820
 821 Longer trills with an extender line are made with
 822 @code{\startTrillSpan} and @code{\stopTrillSpan}.  In the
 823 following example, the trill is combined with grace notes.  To
 824 achieve precise control over the placement of the grace notes, see
 825 @ref{Grace notes}.
 826
 827 @lilypond[verbatim,quote,relative=2]
 828 c1 \afterGrace
 829 d1\startTrillSpan { c16[\stopTrillSpan d] }
 830 c4
 831 @end lilypond
 832
 833 @cindex pitched trills
 834 @cindex trills, pitched
 835
 836 Trills that require an auxiliary note with an explicit pitch can
 837 be typeset with the @code{\pitchedTrill} command.  The first
 838 argument is the main note, and the second is the @emph{trilled}
 839 note, printed as a stemless note head in parentheses.
 840
 841 @c This syntax example doesn't look nice. -pm
 842
 843 @c @example
 844 @c @code{\pitchedTrill} @var{mainnote} @code{\startTrillSpan}
 845 @c @var{trillnote} @var{endnote} @code{\stopTrillSpan}
 846 @c @end example
 847
 848 @lilypond[verbatim,quote,relative=1]
 849 \pitchedTrill e2\startTrillSpan fis
 850 d\stopTrillSpan
 851 @end lilypond
 852
 853 In the following example, the second pitched trill is ambiguous;
 854 the accidental of the trilled note is not printed.  As a
 855 workaround, the accidentals of the trilled notes can be forced.
 856 The second measure illustrates this method:
 857
 858 @lilypond[verbatim,quote,relative=2]
 859 \pitchedTrill eis4\startTrillSpan fis
 860 g\stopTrillSpan
 861 \pitchedTrill eis4\startTrillSpan fis
 862 g\stopTrillSpan
 863 \pitchedTrill eis4\startTrillSpan fis
 864 g\stopTrillSpan
 865 \pitchedTrill eis4\startTrillSpan fis!
 866 g\stopTrillSpan
 867 @end lilypond
 868
 869
 870 @predefined
 871
 872 @funindex \startTrillSpan
 873 @code{\startTrillSpan},
 874 @funindex \stopTrillSpan
 875 @code{\stopTrillSpan}.
 876
 877
 878 @seealso
 879
 880 Music Glossary:
 881 @rglos{trill}.
 882
 883 Notation Reference:
 884 @ref{Articulations and ornamentations},
 885 @ref{Grace notes}.
 886
 887 Snippets:
 888 @rlsr{Expressive marks}.
 889
 890 Internals Reference:
 891 @rinternals{TrillSpanner}.