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