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.38"
  10
  11 @node Expressive marks
  12 @section Expressive marks
  13
  14 @lilypondfile[quote]{expressive-headword.ly}
  15
  16 @menu
  17 * Attached to notes::
  18 * Curves::
  19 * Lines::
  20 @end menu
  21
  22
  23 @node Attached to notes
  24 @subsection Attached to notes
  25
  26 @menu
  27 * Articulations and ornamentations::
  28 * Dynamics::
  29 * New dynamic marks::
  30 @end menu
  31
  32 @node Articulations and ornamentations
  33 @subsubsection Articulations and ornamentations
  34
  35 @cindex articulations
  36 @cindex scripts
  37 @cindex ornaments
  38 @cindex espressivo
  39 @cindex fermata
  40 @cindex upbow
  41 @cindex downbow
  42 @cindex foot marks
  43 @cindex organ pedal marks
  44 @cindex turn
  45 @cindex open
  46 @cindex stopped
  47 @cindex flageolet
  48 @cindex reverseturn
  49 @cindex trill
  50 @cindex prall
  51 @cindex mordent
  52 @cindex prallprall
  53 @cindex prallmordent
  54 @cindex prall, up
  55 @cindex prall, down
  56 @cindex thumb marking
  57 @cindex segno
  58 @cindex coda
  59 @cindex varcoda
  60
  61 A variety of symbols that denote articulations, ornamentations,
  62 and other performance indications can be attached to a note using
  63 this syntax:
  64
  65 @example
  66 @var{note}\@var{name}
  67 @end example
  68
  69 The possible values for @var{name} are listed in @ref{List of
  70 articulations}.  For example:
  71
  72 @lilypond[verbatim,quote,relative=2]
  73 c4\staccato c\mordent b2\turn
  74 c1\fermata
  75 @end lilypond
  76
  77 @cindex marcato
  78 @cindex stopped
  79 @cindex tenuto
  80 @cindex staccatissimo
  81 @cindex accent
  82 @cindex staccato
  83 @cindex portato
  84
  85 Some of these articulations have shorthands for easier entry.
  86 Shorthands are appended to the note name, and their syntax
  87 consists of a dash (@tie{}@code{-}) followed by a symbol
  88 signifying the articulation.  Predefined shorthands exist for
  89 @notation{marcato}, @notation{stopped}, @notation{tenuto},
  90 @notation{staccatissimo}, @notation{accent}, @notation{staccato},
  91 and @notation{portato}.  Their corresponding output appears as
  92 follows:
  93
  94 @lilypond[verbatim,quote,relative=2]
  95 c4-^  c-+  c--  c-|
  96 c->   c-.  c-_
  97 @end lilypond
  98
  99 The rules for the default placement of articulations are defined
 100 in @file{scm/@/script@/.scm}.  Articulations and ornamentations
 101 may be manually placed above or below the staff, see
 102 @ref{Controlling direction and placement}.
 103
 104
 105 @snippets
 106
 107 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 108 {modifying-default-values-for-articulation-shorthand-notation.ly}
 109
 110 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 111 {controlling-the-vertical-ordering-of-scripts.ly}
 112
 113
 114 @seealso
 115
 116 Music Glossary:
 117 @rglos{tenuto},
 118 @rglos{accent},
 119 @rglos{staccato},
 120 @rglos{portato}.
 121
 122 Notation Reference:
 123 @ref{Controlling direction and placement}.
 124
 125 Installed Files:
 126 @file{scm/@/script@/.scm}.
 127
 128 Snippets:
 129 @rlsr{Expressive marks}.
 130
 131 Internals Reference:
 132 @rinternals{Script},
 133 @rinternals{TextScript}.
 134
 135
 136 @knownissues
 137
 138 These signs appear in the printed output but have no effect on the
 139 MIDI rendering of the music.
 140
 141
 142 @node Dynamics
 143 @subsubsection Dynamics
 144
 145 @cindex absolute dynamics
 146 @cindex dynamics
 147 @cindex dynamics, absolute
 148 @funindex \ppppp
 149 @funindex \pppp
 150 @funindex \ppp
 151 @funindex \pp
 152 @funindex \p
 153 @funindex \mp
 154 @funindex \mf
 155 @funindex \f
 156 @funindex \ff
 157 @funindex \fff
 158 @funindex \ffff
 159 @funindex \fp
 160 @funindex \sf
 161 @funindex \sff
 162 @funindex \sp
 163 @funindex \spp
 164 @funindex \sfz
 165 @funindex \rfz
 166
 167 Absolute dynamic marks are specified using a command after a note,
 168 such as @code{c4\ff}.  The available dynamic marks are
 169 @code{\ppppp}, @code{\pppp}, @code{\ppp}, @code{\pp}, @code{\p},
 170 @code{\mp}, @code{\mf}, @code{\f}, @code{\ff}, @code{\fff},
 171 @code{\ffff}, @code{\fp}, @code{\sf}, @code{\sff}, @code{\sp},
 172 @code{\spp}, @code{\sfz}, and @code{\rfz}.  The dynamic marks may
 173 be manually placed above or below the staff, see @ref{Controlling
 174 direction and placement}.
 175
 176 @lilypond[verbatim,quote,relative=2]
 177 c2\ppp c\mp
 178 c\rfz c^\mf
 179 c_\spp c^\ff
 180 @end lilypond
 181
 182 @cindex hairpin
 183 @funindex \<
 184 @funindex \>
 185 @funindex \!
 186 @funindex \cr
 187 @funindex \decr
 188
 189 A @notation{crescendo} mark is started with @code{\<} and
 190 terminated with @code{\!}, an absolute dynamic, or an additional
 191 @notation{crescendo} or @notation{decrescendo} mark.  A
 192 @notation{decrescendo} mark is started with @code{\>} and is also
 193 terminated with @code{\!}, an absolute dynamic, or another
 194 @notation{crescendo} or @notation{decrescendo} mark.  @code{\cr}
 195 and @code{\decr} may be used instead of @code{\<} and @code{\>}.
 196 @notation{Hairpins} are engraved by default using this notation.
 197
 198 @lilypond[verbatim,quote,relative=2]
 199 c2\< c\!
 200 d2\< d\f
 201 e2\< e\>
 202 f2\> f\!
 203 e2\> e\mp
 204 d2\> d\>
 205 c1\!
 206 @end lilypond
 207
 208 Spacer notes are needed to engrave multiple marks on one note.
 209
 210 @lilypond[verbatim,quote,relative=2]
 211 c4\< c\! d\> e\!
 212 << f1 { s4 s4\< s4\> s4\! } >>
 213 @end lilypond
 214
 215 @cindex espressivo articulation
 216
 217 In some situations the @code{\espressivo} articulation mark may be
 218 the appropriate choice to indicate a @notation{crescendo} and
 219 @notation{decrescendo} on one note:
 220
 221 @lilypond[verbatim,quote,relative=2]
 222 c2 b4 a
 223 g1\espressivo
 224 @end lilypond
 225
 226 @cindex crescendo
 227 @cindex decrescendo
 228 @cindex diminuendo
 229 @funindex \setTextCresc
 230 @funindex \setTextDim
 231 @funindex \setTextDecr
 232 @funindex \setTextDecresc
 233 @funindex \setHairpinCresc
 234 @funindex \setHairpinDim
 235 @funindex \setHairpinDecresc
 236
 237 @notation{Crescendos} and @notation{decrescendos} can be engraved
 238 as textual markings instead of hairpins.  The built-in commands
 239 that enable these text modes are @code{\setTextCresc},
 240 @code{\setTextDecresc}, @code{\setTextDecr}, and
 241 @code{\setTextDim}.  The corresponding @code{\setHairpinCresc},
 242 @code{\setHairpinDim}, and @code{\setHairpinDecresc} commands will
 243 revert to hairpins again:
 244
 245 @lilypond[verbatim,quote,relative=2]
 246 c\< d e f\!
 247 e\> d c b\!
 248 \setTextCresc
 249 c\< d e f\!
 250 \setTextDecresc
 251 e\> d c b\!
 252 \setHairpinCresc
 253 c\< 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
 272
 273 @snippets
 274
 275 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 276 {setting-hairpin-behavior-at-bar-lines.ly}
 277
 278 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 279 {setting-the-minimum-length-of-hairpins.ly}
 280
 281 @cindex al niente
 282 @cindex niente, al
 283
 284 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 285 {printing-hairpins-using-al-niente-notation.ly}
 286
 287 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 288 {vertically-aligning-dynamics-across-multiple-notes.ly}
 289
 290 @c I can't figure this one out.  Consider removing this.  -pm
 291
 292 @notation{Crescendi} and @notation{decrescendi} that cross a line
 293 break will be continued on the second line.  If they end on the
 294 first note of a new line, nothing will be printed on that line.
 295 To change this behavior, use
 296
 297 @example
 298 \override Score.Hairpin #'after-line-breaking = ##t
 299 @end example
 300
 301 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 302 {hiding-the-extender-line-for-text-dynamics.ly}
 303
 304 @c The following snippet goes in input/new/
 305 @c @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 306 @c {changing-text-and-spanner-styles-for-text-dynamics.ly}
 307
 308 The text used for @notation{crescendos} and
 309 @notation{decrescendos} can be changed by modifying the context
 310 properties @code{crescendoText} and @code{decrescendoText}.  The
 311 style of the spanner line can be changed by modifying the
 312 @code{'style} property of @code{DynamicTextSpanner}.  The default
 313 value is @code{'hairpin}, and other possible values include
 314 @code{'line}, @code{'dashed-line}, and @code{'dotted-line}:
 315
 316 @lilypond[verbatim,quote,relative=2]
 317 \set crescendoText = \markup { \italic "cresc. poco" }
 318 \set crescendoSpanner = #'text
 319 \override DynamicTextSpanner #'style = #'dotted-line
 320 a2\< a
 321 a2 a
 322 a2 a
 323 a2 a\mf
 324 @end lilypond
 325
 326
 327 @seealso
 328
 329 @c TODO: Add hairpin to glossary.
 330
 331 Music Glossary:
 332 @rglos{crescendo},
 333 @rglos{decrescendo}.
 334
 335 Learning Manual:
 336 @rlearning{Articulation and dynamics}.
 337
 338 Notation Reference:
 339 @ref{Controlling direction and placement}.
 340
 341 Snippets:
 342 @rlsr{Expressive marks}.
 343
 344 Internals Reference:
 345 @rinternals{DynamicText},
 346 @rinternals{Hairpin},
 347 @rinternals{DynamicLineSpanner}.
 348
 349
 350 @node New dynamic marks
 351 @subsubsection New dynamic marks
 352
 353 @cindex new dynamic marks
 354 @cindex dynamic marks, new
 355
 356 It is possible to print new dynamic marks or text that should be
 357 aligned with dynamics.  Use @code{make-dynamic-script} to create
 358 these marks.  Note that the dynamic font only contains the
 359 characters @code{f,m,p,r,s} and @code{z}.
 360
 361 Some situations (such as dynamic marks) have preset font-related
 362 properties.  If you are creating text in such situations, it is
 363 advisable to cancel those properties with @code{normal-text}.  See
 364 @ref{Text markup commands} for more details.
 365
 366 @cindex make-dynamic-script
 367
 368 @lilypond[verbatim,quote]
 369 sfzp = #(make-dynamic-script "sfzp")
 370 \relative c' {
 371   c4 c c\sfzp c
 372 }
 373 @end lilypond
 374
 375 @cindex dynamics, editorial
 376 @cindex dynamics, parenthesis
 377
 378 It is also possible to print dynamics in round parenthesis or
 379 square brackets.  These are often used for adding editorial
 380 dynamics.
 381
 382 @lilypond[verbatim,quote]
 383 rndf = \markup { \center-align { \line { \bold { \italic ( }
 384          \dynamic f \bold { \italic ) } } } }
 385 boxf = \markup { \bracket { \dynamic f } }
 386 \relative c' {
 387   c1_\rndf
 388   c1_\boxf
 389 }
 390 @end lilypond
 391
 392
 393 @seealso
 394
 395 Snippets:
 396 @rlsr{Expressive marks}.
 397
 398
 399 @node Curves
 400 @subsection Curves
 401
 402 @menu
 403 * Slurs::
 404 * Phrasing slurs::
 405 * Breath marks::
 406 * Falls and doits::
 407 @end menu
 408
 409 @node Slurs
 410 @subsubsection Slurs
 411
 412 @cindex slurs
 413
 414 A @notation{slur} indicates that notes are to be played bound or
 415 @emph{legato}.  They are entered using parentheses:
 416
 417 @lilypond[verbatim,quote,relative=2]
 418 f( g a) a8 b( a4 g2 f4)
 419 <c e>2( <b d>2)
 420 @end lilypond
 421
 422 Just as with ties, the direction of a slur can be specified with
 423 @code{\slur@emph{DIR}}, where @code{@emph{DIR}} is either
 424 @code{Up}, @code{Down}, or @code{Neutral} (@code{Neutral} is the
 425 default).  Slurs may be manually placed above or below the staff,
 426 see @ref{Controlling direction and placement}.
 427
 428 @lilypond[verbatim,quote,relative=2]
 429 c4_( c) c^( c)
 430 @end lilypond
 431
 432 Using this method, only one slur can be printed at once.  To print
 433 a long slur over a few small slurs, see @ref{Phrasing slurs}.
 434
 435
 436 @predefined
 437
 438 @funindex \slurUp
 439 @code{\slurUp},
 440 @funindex \slurDown
 441 @code{\slurDown},
 442 @funindex \slurNeutral
 443 @code{\slurNeutral},
 444 @funindex \slurDashed
 445 @code{\slurDashed},
 446 @funindex \slurDotted
 447 @code{\slurDotted},
 448 @funindex \slurSolid
 449 @code{\slurSolid}.
 450
 451
 452 @snippets
 453
 454 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 455 {using-double-slurs-for-legato-chords.ly}
 456
 457
 458 @seealso
 459
 460 Music Glossary:
 461 @rglos{slur}.
 462
 463 Notation Reference:
 464 @ref{Controlling direction and placement}.
 465
 466 Snippets:
 467 @rlsr{Expressive marks}.
 468
 469 Internals Reference:
 470 @rinternals{Slur}.
 471
 472
 473 @node Phrasing slurs
 474 @subsubsection Phrasing slurs
 475
 476 @cindex phrasing slurs
 477 @cindex phrasing marks
 478 @funindex \(
 479 @funindex \)
 480
 481 A phrasing slur (or phrasing mark) connects notes and is used to
 482 indicate a musical sentence.  It is written using @code{\(} and
 483 @code{\)} respectively:
 484
 485 @lilypond[verbatim,quote,relative=2]
 486 \time 6/4 c\( d( e) f( e) d\)
 487 @end lilypond
 488
 489 Typographically, the phrasing slur behaves almost exactly like a
 490 normal slur.  However, they are treated as different objects.  A
 491 @code{\slurUp} will have no effect on a phrasing slur; instead,
 492 use @code{\phrasingSlurUp}, @code{\phrasingSlurDown}, and
 493 @code{\phrasingSlurNeutral}.  Phrasing slurs may be manually
 494 placed above or below the staff, see @ref{Controlling direction
 495 and placement}.
 496
 497 You cannot have simultaneous phrasing slurs.
 498
 499
 500 @predefined
 501
 502 @funindex \phrasingSlurUp
 503 @code{\phrasingSlurUp},
 504 @funindex \phrasingSlurDown
 505 @code{\phrasingSlurDown},
 506 @funindex \phrasingSlurNeutral
 507 @code{\phrasingSlurNeutral}.
 508
 509
 510 @seealso
 511
 512 Notation Reference:
 513 @ref{Controlling direction and placement}.
 514
 515 Snippets:
 516 @rlsr{Expressive marks}.
 517
 518 Internals Reference:
 519 @rinternals{PhrasingSlur}.
 520
 521
 522 @node Breath marks
 523 @subsubsection Breath marks
 524
 525 @cindex breath marks
 526 @funindex \breathe
 527
 528 Breath marks are entered using @code{\breathe}:
 529
 530 @lilypond[verbatim,quote,relative=2]
 531 c4 \breathe d4
 532 @end lilypond
 533
 534
 535 @snippets
 536
 537 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 538 {changing-the-breath-mark-symbol.ly}
 539
 540
 541 @seealso
 542
 543 Snippets:
 544 @rlsr{Expressive marks}.
 545 @c @lsr{expressive,breathing-sign.ly}.
 546
 547 Internals Reference:
 548 @rinternals{BreathingSign}.
 549
 550
 551 @node Falls and doits
 552 @subsubsection Falls and doits
 553
 554 @cindex falls
 555 @cindex doits
 556 @funindex \bendAfter
 557
 558 @notation{Falls} and @notation{doits} can be added to notes using
 559 the @code{\bendAfter} command:
 560
 561 @lilypond[verbatim,quote,relative=2]
 562 c2-\bendAfter #+4
 563 c-\bendAfter #-4
 564 c-\bendAfter #+8
 565 c-\bendAfter #-8
 566 @end lilypond
 567
 568 The dash (@tie{-}) following the note name is @emph{required} when
 569 writing @notation{falls} and @notation{doits}.
 570
 571
 572 @snippets
 573
 574 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 575 {adjusting-the-shape-of-falls-and-doits.ly}
 576
 577
 578 @seealso
 579
 580 @c TODO: add falls and doits to glossary.
 581 @c Music Glossary:
 582 @c @rglos{falls},
 583 @c @rglos{doits}.
 584
 585 Snippets:
 586 @rlsr{Expressive marks}.
 587
 588
 589 @node Lines
 590 @subsection Lines
 591
 592 @menu
 593 * Glissando::
 594 * Arpeggio::
 595 * Trills::
 596 @end menu
 597
 598 @node Glissando
 599 @subsubsection Glissando
 600
 601 @cindex glissando
 602 @funindex \glissando
 603
 604 A @notation{glissando} is a smooth change in pitch.  It is denoted
 605 by a line or a wavy line between two notes.  A
 606 @notation{glissando} is created by attaching @code{\glissando} to
 607 a note:
 608
 609 @lilypond[verbatim,quote,relative=2]
 610 c2\glissando c'
 611 \override Glissando #'style = #'zigzag
 612 c2\glissando c,
 613 @end lilypond
 614
 615
 616 @snippets
 617
 618 @c Modify, add description, and put in input/new/
 619 @c @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 620 @c {suppressing-warnings-for-clashing-note-columns.ly}
 621
 622 @lilypond[verbatim,quote]
 623 I = \once \override NoteColumn #'ignore-collision = ##t
 624
 625 \relative c' <<
 626   { \oneVoice \stemDown f2 \glissando \stemNeutral a } \\
 627   { \oneVoice \I c2 \glissando \I d, }
 628 >>
 629 @end lilypond
 630
 631
 632 @seealso
 633
 634 Music Glossary:
 635 @rglos{glissando}.
 636
 637 Snippets:
 638 @rlsr{Expressive marks}.
 639
 640 @c FIXME: I need to figure out what's up with these.  -gp
 641 @c @lsr{expressive,glissando.ly},
 642 @c @lsr{expressive,line-styles.ly}
 643
 644 Internals Reference:
 645 @rinternals{Glissando}.
 646
 647
 648 @knownissues
 649
 650 Printing text over the line (such as @emph{gliss.}) is not
 651 supported.
 652
 653
 654 @node Arpeggio
 655 @subsubsection Arpeggio
 656
 657 @cindex arpeggio
 658 @cindex broken chord
 659 @cindex chord, broken
 660
 661 @c Add documentation for new 'parenthesis' style arpeggio.  Maybe
 662 @c create a new \arpeggioParen command, or something similar. -pm
 663
 664 You can specify an @notation{arpeggio} (also known as a
 665 @notation{broken chord}) on a chord by attaching an
 666 @code{\arpeggio} to the chord:
 667
 668 @lilypond[verbatim,quote,relative=1]
 669 <c e g c>\arpeggio
 670 @end lilypond
 671
 672 A square bracket on the left, denoted by @code{\arpeggioBracket},
 673 is used to indicate that the chord should @emph{not} be
 674 arpeggiated:
 675
 676 @lilypond[verbatim,quote,relative=1]
 677 \arpeggioBracket
 678 <c e g c>\arpeggio
 679 @end lilypond
 680
 681 The direction of the arpeggio can be denoted by adding an
 682 arrowhead to the wiggly line.  This is done with the commands
 683 @code{arpeggioUp} and @code{arpeggioDown}.  @code{arpeggioNeutral}
 684 reverts to the arrow-less version:
 685
 686 @lilypond[verbatim,quote,relative=1]
 687 \new Voice {
 688   \arpeggioUp
 689   <c e g c>\arpeggio
 690   \arpeggioDown
 691   <c e g c>\arpeggio
 692   \arpeggioNeutral
 693   <c e g c>\arpeggio
 694 }
 695 @end lilypond
 696
 697 @notation{Arpeggios} can be explicitly written out using
 698 @notation{ties}.  For more information, see @ref{Ties}.
 699
 700 @predefined
 701
 702 @funindex \arpeggio
 703 @code{\arpeggio},
 704 @funindex \arpeggioUp
 705 @code{\arpeggioUp},
 706 @funindex \arpeggioDown
 707 @code{\arpeggioDown},
 708 @funindex \arpeggioNeutral
 709 @code{\arpeggioNeutral},
 710 @funindex \arpeggioBracket
 711 @code{\arpeggioBracket}.
 712
 713
 714 @snippets
 715
 716 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 717 {creating-cross-staff-arpeggios-in-a-piano-staff.ly}
 718
 719 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 720 {creating-cross-staff-arpeggios-in-other-contexts.ly}
 721
 722 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 723 {creating-arpeggios-across-notes-in-different-voices.ly}
 724
 725
 726 @seealso
 727
 728 @c TODO: Add 'broken chord' to glossary.
 729
 730 Music Glossary:
 731 @rglos{arpeggio}.
 732
 733 Notation Reference:
 734 @ref{Ties}.
 735
 736 Snippets:
 737 @rlsr{Expressive marks}.
 738
 739 Internals Reference:
 740 @rinternals{Arpeggio},
 741 @rinternals{PianoStaff}.
 742
 743
 744 @knownissues
 745
 746 It is not possible to mix connected arpeggios and unconnected
 747 arpeggios in one @code{PianoStaff} at the same point in
 748 time.
 749
 750
 751 @node Trills
 752 @subsubsection Trills
 753
 754 @cindex trills
 755 @funindex \trill
 756
 757 Short @notation{trills} are printed with @code{\trill} like normal
 758 articulation; see @ref{Articulations and ornamentations}.
 759
 760 Long running @notation{trills} are made with
 761 @code{\startTrillSpan} and @code{\stopTrillSpan}.  In the
 762 following example, a long running @notation{trill} is shown
 763 combined with grace notes.  To achieve precise control of the
 764 placement of the grace notes, see @ref{Grace notes}.
 765
 766 @lilypond[verbatim,quote,relative=2]
 767 c1 \afterGrace
 768 d1\startTrillSpan { c16[\stopTrillSpan d] }
 769 c4
 770 @end lilypond
 771
 772 @cindex pitched trills
 773 @cindex trills, pitched
 774
 775 @notation{Trills} that should be executed on an explicitly
 776 specified pitch can be typeset with the command
 777 @code{\pitchedTrill} using the following syntax:
 778
 779 @example
 780 @code{\pitchedTrill} @var{mainnote} @code{\startTrillSpan}
 781 @var{trillnote} @var{endnote} @code{\stopTrillSpan}
 782 @end example
 783
 784 @lilypond[verbatim,quote,relative=1]
 785 \pitchedTrill e2 \startTrillSpan fis
 786 d\stopTrillSpan
 787 @end lilypond
 788
 789 @noindent
 790 The first argument is the main note.  The pitch of the second is
 791 printed as a stemless note head in parentheses.
 792
 793
 794 @predefined
 795
 796 @code{\startTrillSpan},
 797 @funindex \startTrillSpan
 798 @code{\stopTrillSpan}.
 799 @funindex \stopTrillSpan
 800
 801
 802 @seealso
 803
 804 Music Glossary:
 805 @rglos{trill}.
 806
 807 Snippets:
 808 @rlsr{Expressive marks}.
 809
 810 Internals Reference:
 811 @rinternals{TrillSpanner}.