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 Musical indicators for breath marks in ancient notation,
 828 divisiones, are supported.  For details, see @ref{Divisiones}.
 829
 830
 831 @snippets
 832
 833 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 834 {changing-the-breath-mark-symbol.ly}
 835
 836 @cindex caesura
 837 @cindex railroad tracks
 838
 839 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 840 {inserting-a-caesura.ly}
 841
 842
 843 @seealso
 844 Music Glossary:
 845 @rglos{caesura}.
 846
 847 Notation Reference:
 848 @ref{Divisiones}.
 849
 850 Snippets:
 851 @rlsr{Expressive marks}.
 852
 853 Internals Reference:
 854 @rinternals{BreathingSign}.
 855
 856
 857 @node Falls and doits
 858 @unnumberedsubsubsec Falls and doits
 859
 860 @cindex falls
 861 @cindex doits
 862 @funindex \bendAfter
 863 @funindex bendAfter
 864
 865 @notation{Falls} and @notation{doits} can be added to notes using
 866 the @code{\bendAfter} command.  The direction of the fall or doit
 867 is indicated with a plus or minus (up or down).  The number
 868 indicates the pitch interval that the fall or doit will extend
 869 @emph{beyond} the main note.
 870
 871 @lilypond[verbatim,quote,relative=2]
 872 c2-\bendAfter #+4
 873 c2-\bendAfter #-4
 874 c2-\bendAfter #+8
 875 c2-\bendAfter #-8
 876 @end lilypond
 877
 878 The dash @code{-} immediately preceding the @code{\bendAfter}
 879 command is @emph{required} when writing falls and doits.
 880
 881
 882 @snippets
 883
 884 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 885 {adjusting-the-shape-of-falls-and-doits.ly}
 886
 887
 888 @seealso
 889 Music Glossary:
 890 @rglos{fall},
 891 @rglos{doit}.
 892
 893 Snippets:
 894 @rlsr{Expressive marks}.
 895
 896
 897 @node Lines
 898 @subsection Lines
 899
 900 This section explains how to create various expressive marks that
 901 follow a linear path: glissandos, arpeggios, and trills.
 902
 903 @menu
 904 * Glissando::
 905 * Arpeggio::
 906 * Trills::
 907 @end menu
 908
 909 @node Glissando
 910 @unnumberedsubsubsec Glissando
 911
 912 @cindex glissando
 913 @funindex \glissando
 914 @funindex glissando
 915
 916 A @notation{glissando} is created by attaching @code{\glissando}
 917 to a note:
 918
 919 @lilypond[verbatim,quote,relative=2]
 920 g2\glissando g'
 921 c2\glissando c,
 922 @end lilypond
 923
 924 Different styles of glissandi can be created.  For details, see
 925 @ref{Line styles}.
 926
 927 @snippets
 928
 929 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 930 {contemporary-glissando.ly}
 931
 932
 933 @seealso
 934 Music Glossary:
 935 @rglos{glissando}.
 936
 937 Notation Reference:
 938 @ref{Line styles}.
 939
 940 Snippets:
 941 @rlsr{Expressive marks}.
 942
 943 Internals Reference:
 944 @rinternals{Glissando}.
 945
 946
 947 @knownissues
 948
 949 Printing text over the line (such as @notation{gliss.}) is not
 950 supported.
 951
 952
 953 @node Arpeggio
 954 @unnumberedsubsubsec Arpeggio
 955
 956 @cindex arpeggio
 957 @cindex broken chord
 958 @cindex chord, broken
 959
 960 @funindex \arpeggio
 961 @funindex arpeggio
 962 @funindex \arpeggioArrowUp
 963 @funindex arpeggioArrowUp
 964 @funindex \arpeggioArrowDown
 965 @funindex arpeggioArrowDown
 966 @funindex \arpeggioNormal
 967 @funindex arpeggioNormal
 968
 969 An @notation{arpeggio} on a chord (also known as a broken chord)
 970 is denoted by appending @code{\arpeggio} to the chord construct:
 971
 972 @lilypond[verbatim,quote,relative=1]
 973 <c e g c>1\arpeggio
 974 @end lilypond
 975
 976 Different types of arpeggios may be written.
 977 @code{\arpeggioNormal} reverts to a normal arpeggio:
 978
 979 @lilypond[verbatim,quote,relative=1]
 980 <c e g c>2\arpeggio
 981
 982 \arpeggioArrowUp
 983 <c e g c>2\arpeggio
 984
 985 \arpeggioArrowDown
 986 <c e g c>2\arpeggio
 987
 988 \arpeggioNormal
 989 <c e g c>2\arpeggio
 990 @end lilypond
 991
 992 @cindex arpeggio symbols, special
 993 @cindex special arpeggio symbols
 994
 995 @funindex \arpeggioBracket
 996 @funindex arpeggioBracket
 997 @funindex \arpeggioParenthesis
 998 @funindex arpeggioParenthesis
 999 @funindex \arpeggioParenthesisDashed
1000 @funindex arpeggioParenthesisDashed
1001
1002 Special @emph{bracketed} arpeggio symbols can be created:
1003
1004 @lilypond[verbatim,quote,relative=1]
1005 <c e g c>2
1006
1007 \arpeggioBracket
1008 <c e g c>2\arpeggio
1009
1010 \arpeggioParenthesis
1011 <c e g c>2\arpeggio
1012
1013 \arpeggioParenthesisDashed
1014 <c e g c>2\arpeggio
1015
1016 \arpeggioNormal
1017 <c e g c>2\arpeggio
1018 @end lilypond
1019
1020 The dash properties of the parenthesis arpeggio are controlled
1021 with the @code{'dash-details} property, which is described at @ref{Slurs}.
1022
1023 Arpeggios can be explicitly written out with ties.  For more
1024 information, see @ref{Ties}.
1025
1026
1027 @predefined
1028 @code{\arpeggio},
1029 @code{\arpeggioArrowUp},
1030 @code{\arpeggioArrowDown},
1031 @code{\arpeggioNormal},
1032 @code{\arpeggioBracket},
1033 @code{\arpeggioParenthesis}
1034 @code{\arpeggioParenthesisDashed}.
1035 @endpredefined
1036
1037
1038 @snippets
1039
1040 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
1041 {creating-cross-staff-arpeggios-in-a-piano-staff.ly}
1042
1043 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
1044 {creating-cross-staff-arpeggios-in-other-contexts.ly}
1045
1046 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
1047 {creating-arpeggios-across-notes-in-different-voices.ly}
1048
1049
1050 @seealso
1051 Music Glossary:
1052 @rglos{arpeggio}.
1053
1054 Notation Reference:
1055 @ref{Slurs},
1056 @ref{Ties}.
1057
1058 Snippets:
1059 @rlsr{Expressive marks}.
1060
1061 Internals Reference:
1062 @rinternals{Arpeggio},
1063 @rinternals{Slur},
1064 @rinternals{PianoStaff}.
1065
1066
1067 @knownissues
1068
1069 @cindex cross-staff parenthesis-style arpeggio
1070 @cindex arpeggio, parenthesis-style, cross-staff
1071 @cindex arpeggio, cross-staff parenthesis-style
1072
1073 It is not possible to mix connected arpeggios and unconnected
1074 arpeggios in one @code{PianoStaff} at the same point in
1075 time.
1076
1077 The parenthesis-style arpeggio brackets do not work for
1078 cross-staff arpeggios.
1079
1080
1081 @node Trills
1082 @unnumberedsubsubsec Trills
1083
1084 @cindex trills
1085
1086 @funindex \trill
1087 @funindex trill
1088 @funindex \startTrillSpan
1089 @funindex startTrillSpan
1090 @funindex \stopTrillSpan
1091 @funindex stopTrillSpan
1092
1093 Short @notation{trills} without an extender line are printed with
1094 @code{\trill}; see @ref{Articulations and ornamentations}.
1095
1096 Longer trills with an extender line are made with
1097 @code{\startTrillSpan} and @code{\stopTrillSpan}:
1098
1099 @lilypond[verbatim,quote,relative=2]
1100 d1~\startTrillSpan
1101 d1
1102 c2\stopTrillSpan r2
1103 @end lilypond
1104
1105 In the following example, a trill is combined with grace notes.
1106 The syntax of this construct and the method to precisely position
1107 the grace notes are described in @ref{Grace notes}.
1108
1109 @lilypond[verbatim,quote,relative=2]
1110 c1 \afterGrace
1111 d1\startTrillSpan { c32[ d]\stopTrillSpan }
1112 e2 r2
1113 @end lilypond
1114
1115 @cindex pitched trills
1116 @cindex trills, pitched
1117 @funindex \pitchedTrill
1118 @funindex pitchedTrill
1119
1120 Trills that require an auxiliary note with an explicit pitch can
1121 be typeset with the @code{\pitchedTrill} command.  The first
1122 argument is the main note, and the second is the @emph{trilled}
1123 note, printed as a stemless note head in parentheses.
1124
1125 @lilypond[verbatim,quote,relative=1]
1126 \pitchedTrill e2\startTrillSpan fis
1127 d\stopTrillSpan
1128 @end lilypond
1129
1130 @cindex pitched trill with forced accidental
1131 @cindex trill, pitched with forced accidental
1132 @cindex accidental, forced for pitched trill
1133
1134 In the following example, the second pitched trill is ambiguous;
1135 the accidental of the trilled note is not printed.  As a
1136 workaround, the accidentals of the trilled notes can be forced.
1137 The second measure illustrates this method:
1138
1139 @lilypond[verbatim,quote,relative=2]
1140 \pitchedTrill eis4\startTrillSpan fis
1141 g\stopTrillSpan
1142 \pitchedTrill eis4\startTrillSpan fis
1143 g\stopTrillSpan
1144 \pitchedTrill eis4\startTrillSpan fis
1145 g\stopTrillSpan
1146 \pitchedTrill eis4\startTrillSpan fis!
1147 g\stopTrillSpan
1148 @end lilypond
1149
1150
1151 @predefined
1152 @code{\startTrillSpan},
1153 @code{\stopTrillSpan}.
1154 @endpredefined
1155
1156
1157 @seealso
1158 Music Glossary:
1159 @rglos{trill}.
1160
1161 Notation Reference:
1162 @ref{Articulations and ornamentations},
1163 @ref{Grace notes}.
1164
1165 Snippets:
1166 @rlsr{Expressive marks}.
1167
1168 Internals Reference:
1169 @rinternals{TrillSpanner}.
1170