]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/user/expressive.itely
Docs: NR 1.3 Expressive: Review
[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
634 Typographically, a phrasing slur behaves almost exactly like a
635 normal slur.  However, they are treated as different objects; a
636 @code{\slurUp} will have no effect on a phrasing slur.  Phrasing
637 slurs may be manually placed above or below the notes, see
638 @ref{Direction and placement}.
639
640 @lilypond[verbatim,quote,relative=1]
641 c4\( g' c,( b) | c1\)
642 \phrasingSlurUp
643 c4\( g' c,( b) | c1\)
644 @end lilypond
645
646 @cindex simultaneous phrasing slurs
647 @cindex multiple phrasing slurs
648 @cindex slurs, simultaneous phrasing
649 @cindex slurs, multiple phrasing
650 @cindex phrasing slurs, simultaneous
651 @cindex phrasing slurs, multiple
652
653 Simultaneous or overlapping phrasing slurs are not permitted.
654
655
656 @predefined
657
658 @code{\phrasingSlurUp},
659 @code{\phrasingSlurDown},
660 @code{\phrasingSlurNeutral}.
661
662
663 @seealso
664
665 Learning Manual:
666 @rlearning{On the un-nestedness of brackets and ties}.
667
668 Notation Reference:
669 @ref{Direction and placement}.
670
671 Snippets:
672 @rlsr{Expressive marks}.
673
674 Internals Reference:
675 @rinternals{PhrasingSlur}.
676
677
678 @node Breath marks
679 @unnumberedsubsubsec Breath marks
680
681 @cindex breath marks
682 @cindex pause mark
683 @funindex \breathe
684 @funindex breathe
685
686 Breath marks are entered using @code{\breathe}:
687
688 @lilypond[verbatim,quote,relative=2]
689 c2. \breathe d4
690 @end lilypond
691
692 Musical indicators for breath marks in ancient notation,
693 divisiones, are supported.  For details, see @ref{Divisiones}.
694
695
696 @snippets
697
698 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
699 {changing-the-breath-mark-symbol.ly}
700
701 @cindex caesura
702 @cindex railroad tracks
703
704 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
705 {inserting-a-caesura.ly}
706
707
708 @seealso
709
710 @c TODO When available add Glossary: @r glos{caesura}.
711
712 Notation Reference:
713 @ref{Divisiones}.
714
715 Snippets:
716 @rlsr{Expressive marks}.
717
718 Internals Reference:
719 @rinternals{BreathingSign}.
720
721
722 @node Falls and doits
723 @unnumberedsubsubsec Falls and doits
724
725 @cindex falls
726 @cindex doits
727 @funindex \bendAfter
728 @funindex bendAfter
729
730 @notation{Falls} and @notation{doits} can be added to notes using
731 the @code{\bendAfter} command.  The direction of the fall or doit
732 is indicated with a plus or minus (up or down).  The number
733 indicates the pitch interval that the fall or doit will extend
734 @emph{beyond} the main note.
735
736 @lilypond[verbatim,quote,relative=2]
737 c2-\bendAfter #+4
738 c2-\bendAfter #-4
739 c2-\bendAfter #+8
740 c2-\bendAfter #-8
741 @end lilypond
742
743 The dash @code{-} immediately preceding the @code{\bendAfter}
744 command is @emph{required} when writing falls and doits.
745
746
747 @snippets
748
749 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
750 {adjusting-the-shape-of-falls-and-doits.ly}
751
752
753 @seealso
754
755 Music Glossary:
756 @rglos{fall},
757 @rglos{doit}.
758
759 Snippets:
760 @rlsr{Expressive marks}.
761
762
763 @node Lines
764 @subsection Lines
765
766 This section explains how to create various expressive marks that
767 follow a linear path: glissandos, arpeggios, and trills.
768
769 @menu
770 * Glissando::
771 * Arpeggio::
772 * Trills::
773 @end menu
774
775 @node Glissando
776 @unnumberedsubsubsec Glissando
777
778 @cindex glissando
779 @funindex \glissando
780 @funindex glissando
781
782 A @notation{glissando} is created by attaching @code{\glissando}
783 to a note:
784
785 @lilypond[verbatim,quote,relative=2]
786 g2\glissando g'
787 c2\glissando c,
788 @end lilypond
789
790 Different styles of glissandi can be created.  For details, see
791 @ref{Line styles}.
792
793 @snippets
794
795 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
796 {contemporary-glissando.ly}
797
798
799 @seealso
800
801 Music Glossary:
802 @rglos{glissando}.
803
804 Notation Reference:
805 @ref{Line styles}.
806
807 Snippets:
808 @rlsr{Expressive marks}.
809
810 Internals Reference:
811 @rinternals{Glissando}.
812
813
814 @knownissues
815
816 Printing text over the line (such as @notation{gliss.}) is not
817 supported.
818
819
820 @node Arpeggio
821 @unnumberedsubsubsec Arpeggio
822
823 @cindex arpeggio
824 @cindex broken chord
825 @cindex chord, broken
826
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
859 @funindex \arpeggioBracket
860 @funindex arpeggioBracket
861 @funindex \arpeggioParenthesis
862 @funindex arpeggioParenthesis
863
864 Special @emph{bracketed} arpeggio symbols can be created:
865
866 @lilypond[verbatim,quote,relative=1]
867 <c e g c>2
868 \arpeggioBracket
869 <c e g c>2\arpeggio
870 \arpeggioParenthesis
871 <c e g c>2\arpeggio
872 \arpeggioNormal
873 <c e g c>2\arpeggio
874 @end lilypond
875
876 Arpeggios can be explicitly written out with ties.  For more
877 information, see @ref{Ties}.
878
879 @predefined
880
881 @code{\arpeggio},
882 @code{\arpeggioArrowUp},
883 @code{\arpeggioArrowDown},
884 @code{\arpeggioNormal},
885 @code{\arpeggioBracket},
886 @code{\arpeggioParenthesis}.
887
888
889 @snippets
890
891 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
892 {creating-cross-staff-arpeggios-in-a-piano-staff.ly}
893
894 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
895 {creating-cross-staff-arpeggios-in-other-contexts.ly}
896
897 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
898 {creating-arpeggios-across-notes-in-different-voices.ly}
899
900
901 @seealso
902
903 Music Glossary:
904 @rglos{arpeggio}.
905
906 Notation Reference:
907 @ref{Ties}.
908
909 Snippets:
910 @rlsr{Expressive marks}.
911
912 Internals Reference:
913 @rinternals{Arpeggio},
914 @rinternals{PianoStaff}.
915
916
917 @knownissues
918
919 @cindex cross-staff parenthesis-style arpeggio
920 @cindex arpeggio, parenthesis-style, cross-staff
921 @cindex arpeggio, cross-staff parenthesis-style
922
923 It is not possible to mix connected arpeggios and unconnected
924 arpeggios in one @code{PianoStaff} at the same point in
925 time.
926
927 The parenthesis-style arpeggio brackets do not work for
928 cross-staff arpeggios.
929
930
931 @node Trills
932 @unnumberedsubsubsec Trills
933
934 @cindex trills
935
936 @funindex \trill
937 @funindex trill
938 @funindex \startTrillSpan
939 @funindex startTrillSpan
940 @funindex \stopTrillSpan
941 @funindex stopTrillSpan
942
943 Short @notation{trills} without an extender line are printed with
944 @code{\trill}; see @ref{Articulations and ornamentations}.
945
946 Longer trills with an extender line are made with
947 @code{\startTrillSpan} and @code{\stopTrillSpan}:
948
949 @lilypond[verbatim,quote,relative=2]
950 d1~\startTrillSpan
951 d1
952 c2\stopTrillSpan r2
953 @end lilypond
954
955 In the following example, a trill is combined with grace notes.
956 The syntax of this construct and the method to precisely position
957 the grace notes are described in @ref{Grace notes}.
958
959 @lilypond[verbatim,quote,relative=2]
960 c1 \afterGrace
961 d1\startTrillSpan { c32[ d]\stopTrillSpan }
962 e2 r2
963 @end lilypond
964
965 @cindex pitched trills
966 @cindex trills, pitched
967 @funindex \pitchedTrill
968 @funindex pitchedTrill
969
970 Trills that require an auxiliary note with an explicit pitch can
971 be typeset with the @code{\pitchedTrill} command.  The first
972 argument is the main note, and the second is the @emph{trilled}
973 note, printed as a stemless note head in parentheses.
974
975 @lilypond[verbatim,quote,relative=1]
976 \pitchedTrill e2\startTrillSpan fis
977 d\stopTrillSpan
978 @end lilypond
979
980 @cindex pitched trill with forced accidental
981 @cindex trill, pitched with forced accidental
982 @cindex accidental, forced for pitched trill
983
984 In the following example, the second pitched trill is ambiguous;
985 the accidental of the trilled note is not printed.  As a
986 workaround, the accidentals of the trilled notes can be forced.
987 The second measure illustrates this method:
988
989 @lilypond[verbatim,quote,relative=2]
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 \pitchedTrill eis4\startTrillSpan fis!
997 g\stopTrillSpan
998 @end lilypond
999
1000
1001 @predefined
1002
1003 @code{\startTrillSpan},
1004 @code{\stopTrillSpan}.
1005
1006
1007 @seealso
1008
1009 Music Glossary:
1010 @rglos{trill}.
1011
1012 Notation Reference:
1013 @ref{Articulations and ornamentations},
1014 @ref{Grace notes}.
1015
1016 Snippets:
1017 @rlsr{Expressive marks}.
1018
1019 Internals Reference:
1020 @rinternals{TrillSpanner}.
1021