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