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