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