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