X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Fexpressive.itely;h=129edfa528c9b29d7a97a0bedce09f423241cca8;hb=86256511ff93fa202110df55edaf8880ec699db0;hp=8e1fc4a30928160fcda4e3b15612cf8bd28ed588;hpb=52030cc0ba0f7b15c07e57b6e622030c1ea6c40d;p=lilypond.git diff --git a/Documentation/user/expressive.itely b/Documentation/user/expressive.itely index 8e1fc4a309..129edfa528 100644 --- a/Documentation/user/expressive.itely +++ b/Documentation/user/expressive.itely @@ -6,7 +6,7 @@ version that you are working on. See TRANSLATION for details. @end ignore -@c \version "2.11.61" +@c \version "2.12.0" @node Expressive marks @section Expressive marks @@ -119,9 +119,10 @@ may be manually placed above or below the staff, see @lilypondfile[verbatim,lilyquote,texidoc,doctitle] {controlling-the-vertical-ordering-of-scripts.ly} +@lilypondfile[verbatim,lilyquote,texidoc,doctitle] +{creating-a-delayed-turn.ly} @seealso - Music Glossary: @rglos{tenuto}, @rglos{accent}, @@ -313,7 +314,6 @@ Vertical positioning of dynamics is handled by @predefined - @code{\dynamicUp}, @code{\dynamicDown}, @code{\dynamicNeutral}, @@ -323,6 +323,7 @@ Vertical positioning of dynamics is handled by @code{\dimTextDecresc}, @code{\crescHairpin}, @code{\dimHairpin}. +@endpredefined @snippets @@ -350,7 +351,6 @@ Vertical positioning of dynamics is handled by @seealso - Music Glossary: @rglos{al niente}, @rglos{crescendo}, @@ -419,8 +419,7 @@ boxF = \markup { \bracket { \dynamic f } } @funindex make-dynamic-script Simple, centered dynamic marks are easily created with the -@code{make-dynamic-script} function. The dynamic font only -contains the characters @code{f,m,p,r,s} and @code{z}. +@code{make-dynamic-script} function. @lilypond[verbatim,quote] sfzp = #(make-dynamic-script "sfzp") @@ -429,11 +428,15 @@ sfzp = #(make-dynamic-script "sfzp") } @end lilypond -In general, @code{make-dynamic-script} takes any markup object as -its argument. In the following example, using -@code{make-dynamic-script} ensures the vertical alignment of -markup objects and hairpins that are attached to the same note -head. +In general, @code{make-dynamic-script} takes any markup object as its +argument. The dynamic font only contains the characters +@code{f,m,p,r,s} and @code{z}, so if a dynamic mark that includes +plain text or punctuation symbols is desired, markup commands that +reverts font family and font encoding to normal text should be used, +for example @code{\normal-text}. The interest of using +@code{make-dynamic-script} instead of an ordinary markup is ensuring +the vertical alignment of markup objects and hairpins that are +attached to the same note head. @lilypond[verbatim,quote] roundF = \markup { \center-align \concat { @@ -441,11 +444,17 @@ roundF = \markup { \center-align \concat { \dynamic f \normal-text { \bold { \italic ) } } } } boxF = \markup { \bracket { \dynamic f } } +mfEspress = \markup { \center-align \line { + \hspace #3.7 mf \normal-text \italic espress. } } roundFdynamic = #(make-dynamic-script roundF) boxFdynamic = #(make-dynamic-script boxF) +mfEspressDynamic = #(make-dynamic-script mfEspress) \relative c' { c4_\roundFdynamic\< d e f - g,1_\boxFdynamic + g,1~_\boxFdynamic\> + g + g'~\mfEspressDynamic + g } @end lilypond @@ -467,7 +476,6 @@ Font settings in markup mode are described in @seealso - Notation Reference: @ref{Formatting text}, @ref{Selecting font and font size}, @@ -487,10 +495,10 @@ are curved: normal slurs, phrasing slurs, breath marks, falls, and doits. @menu -* Slurs:: -* Phrasing slurs:: -* Breath marks:: -* Falls and doits:: +* Slurs:: +* Phrasing slurs:: +* Breath marks:: +* Falls and doits:: @end menu @node Slurs @@ -537,16 +545,13 @@ slur can overlap a slur. This permits two slurs to be printed at once. For details, see @ref{Phrasing slurs}. @cindex slur style -@cindex solid slur -@cindex dotted slur -@cindex dashed slur @cindex slur, solid @cindex slur, dotted @cindex slur, dashed @cindex solid slur @cindex dotted slur @cindex dashed slur -@cindex sytle, slur +@cindex style, slur @funindex \slurDashed @funindex slurDashed @funindex \slurDotted @@ -567,17 +572,59 @@ c4( e g2) g4( e c2) @end lilypond +@funindex \slurHalfDashed +@funindex slurHalfDashed +@funindex \slurHalfSolid +@funindex slurHalfSolid +@cindex slur, half dashed and half solid + +Slurs can also be made half-dashed (the first half dashed, the +second half solid) or half-solid (the first half solid, the second +half dashed): + +@lilypond[verbatim,quote,relative=1] +c4( e g2) +\slurHalfDashed +g4( e c2) +\slurHalfSolid +c4( e g2) +\slurSolid +g4( e c2) +@end lilypond + +@funindex \slurDashPattern +@funindex slurDashPattern +@cindex slur, defining dash patterns + +Custom dash patterns for slurs can be defined: + +@lilypond[verbatim,quote,relative=1] +c4( e g2) +\slurDashPattern #0.7 #0.75 +g4( e c2) +\slurDashPattern #0.5 #2.0 +c4( e g2) +\slurSolid +g4( e c2) +@end lilypond + + + @funindex \slurUp @funindex slurUp -@predefined +@predefined @code{\slurUp}, @code{\slurDown}, @code{\slurNeutral}, @code{\slurDashed}, @code{\slurDotted}, +@code{\slurHalfDashed}, +@code{\slurHalfSolid}, +@code{\slurDashPattern}, @code{\slurSolid}. +@endpredefined @snippets @@ -585,9 +632,13 @@ g4( e c2) @lilypondfile[verbatim,lilyquote,texidoc,doctitle] {using-double-slurs-for-legato-chords.ly} +@lilypondfile[verbatim,lilyquote,texidoc,doctitle] +{positioning-text-markups-inside-slurs.ly} -@seealso +@lilypondfile[verbatim,lilyquote,texidoc,doctitle] +{making-slurs-with-complex-dash-structure.ly} +@seealso Music Glossary: @rglos{slur}. @@ -645,28 +696,102 @@ c4\( g' c,( b) | c1\) @cindex simultaneous phrasing slurs @cindex multiple phrasing slurs -@cindex slurs, simultaneous phrasing -@cindex slurs, multiple phrasing -@cindex phrasing slurs, simultaneous -@cindex phrasing slurs, multiple +@cindex slur, simultaneous phrasing +@cindex slur, multiple phrasing +@cindex phrasing slur, simultaneous +@cindex phrasing slur, multiple Simultaneous or overlapping phrasing slurs are not permitted. +@funindex phrasingSlurDashed +@funindex \phrasingSlurDashed +@funindex \phrasingSlurDotted +@funindex phrasingSlurDotted +@funindex \phrasingSlurSolid +@funindex phrasingSlurSolid +@cindex phrasing slur, dashed +@cindex dashed phrasing slur +@cindex phrasing slur, dotted +@cindex dotted phrasing slurs +@cindex slur, dashed phrasing +@cindex slur, dotted phrasing + +Phrasing slurs can be solid, dotted, or dashed. Solid is the default +style for phrasing slurs: -@predefined +@lilypond[verbatim,quote,relative=1] +c4\( e g2\) +\phrasingSlurDashed +g4\( e c2\) +\phrasingSlurDotted +c4\( e g2\) +\phrasingSlurSolid +g4\( e c2\) +@end lilypond + +@funindex phrasingSlurHalfDashed +@funindex \phrasingSlurHalfDashed +@funindex \phrasingSlurHalfSolid +@funindex phrasingSlurHalfSolid +@cindex phrasing slur, half solid and half dashed +@cindex slur, half solid and half dashed phrasing + +Phrasing slurs can also be made half-dashed (the first half dashed, the +second half solid) or half-solid (the first half solid, the second +half dashed): + +@lilypond[verbatim,quote,relative=1] +c4\( e g2\) +\phrasingSlurHalfDashed +g4\( e c2\) +\phrasingSlurHalfSolid +c4\( e g2\) +\phrasingSlurSolid +g4\( e c2\) +@end lilypond + +@funindex \phrasingSlurDashPattern +@funindex phrasingSlurDashPattern +@cindex phrasing slur, defining dash patterns +@cindex slur, phrasing, defining dash patterns +@cindex slur, definind dash patterns for phrasing + +Custom dash patterns for phrasing slurs can be defined: + +@lilypond[verbatim,quote,relative=1] +c4\( e g2\) +\phrasingSlurDashPattern #0.7 #0.75 +g4\( e c2\) +\phrasingSlurDashPattern #0.5 #2.0 +c4\( e g2\) +\phrasingSlurSolid +g4\( e c2\) +@end lilypond +Dash pattern definitions for phrasing slurs have the same structure +as dash pattern definitions for slurs. For more information about +complex dash patterns, see the snippets under @ref{Slurs}. + +@predefined @code{\phrasingSlurUp}, @code{\phrasingSlurDown}, -@code{\phrasingSlurNeutral}. +@code{\phrasingSlurNeutral}, +@code{\phrasingSlurDashed}, +@code{\phrasingSlurDotted}, +@code{\phrasingSlurHalfDashed}, +@code{\phrasingSlurHalfSolid}, +@code{\phrasingSlurDashPattern}, +@code{\phrasingSlurSolid}. +@endpredefined @seealso - Learning Manual: @rlearning{On the un-nestedness of brackets and ties}. Notation Reference: -@ref{Direction and placement}. +@ref{Direction and placement}, +@ref{Slurs}. Snippets: @rlsr{Expressive marks}. @@ -706,8 +831,8 @@ divisiones, are supported. For details, see @ref{Divisiones}. @seealso - -@c TODO When available add Glossary: @r glos{caesura}. +Music Glossary: +@rglos{caesura}. Notation Reference: @ref{Divisiones}. @@ -751,7 +876,6 @@ command is @emph{required} when writing falls and doits. @seealso - Music Glossary: @rglos{fall}, @rglos{doit}. @@ -797,7 +921,6 @@ Different styles of glissandi can be created. For details, see @seealso - Music Glossary: @rglos{glissando}. @@ -860,6 +983,8 @@ Different types of arpeggios may be written. @funindex arpeggioBracket @funindex \arpeggioParenthesis @funindex arpeggioParenthesis +@funindex \arpeggioParenthesisDashed +@funindex arpeggioParenthesisDashed Special @emph{bracketed} arpeggio symbols can be created: @@ -869,21 +994,28 @@ Special @emph{bracketed} arpeggio symbols can be created: 2\arpeggio \arpeggioParenthesis 2\arpeggio +\arpeggioParenthesisDashed +2\arpeggio \arpeggioNormal 2\arpeggio @end lilypond +The dash properties of the parenthesis arpeggio are controlled +with the @code{'dash-details} property, which is described at @ref{Slurs}. + Arpeggios can be explicitly written out with ties. For more information, see @ref{Ties}. -@predefined +@predefined @code{\arpeggio}, @code{\arpeggioArrowUp}, @code{\arpeggioArrowDown}, @code{\arpeggioNormal}, @code{\arpeggioBracket}, -@code{\arpeggioParenthesis}. +@code{\arpeggioParenthesis} +@code{\arpeggioParenthesisDashed}. +@endpredefined @snippets @@ -899,11 +1031,11 @@ information, see @ref{Ties}. @seealso - Music Glossary: @rglos{arpeggio}. Notation Reference: +@ref{Slurs}, @ref{Ties}. Snippets: @@ -911,6 +1043,7 @@ Snippets: Internals Reference: @rinternals{Arpeggio}, +@rinternals{Slur}, @rinternals{PianoStaff}. @@ -999,13 +1132,12 @@ g\stopTrillSpan @predefined - @code{\startTrillSpan}, @code{\stopTrillSpan}. +@endpredefined @seealso - Music Glossary: @rglos{trill}.