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