From: Patrick McCarty Date: Thu, 26 Jun 2008 02:30:26 +0000 (-0700) Subject: Update for expressive.itely X-Git-Tag: release/2.11.50-1~20^2~3 X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=74611a3ca440ee749aadf238bab6edbbbbb4f6f8;p=lilypond.git Update for expressive.itely * miscellaneous updates, and suggestions from Carl and Graham * new snippet for input/new Signed-off-by: Patrick McCarty --- diff --git a/Documentation/user/expressive.itely b/Documentation/user/expressive.itely index 1074130f2f..5f4f3f0396 100644 --- a/Documentation/user/expressive.itely +++ b/Documentation/user/expressive.itely @@ -13,6 +13,9 @@ @lilypondfile[quote]{expressive-headword.ly} +This section lists various expressive marks that can be +created in a score. + @menu * Attached to notes:: * Curves:: @@ -23,6 +26,10 @@ @node Attached to notes @subsection Attached to notes +This section explains how to create expressive marks that are +attached to notes: articulations, ornamentations, and dynamics. +Methods to create new dynamic markings are also discussed. + @menu * Articulations and ornamentations:: * Dynamics:: @@ -30,7 +37,7 @@ @end menu @node Articulations and ornamentations -@subsubsection Articulations and ornamentations +@unnumberedsubsubsec Articulations and ornamentations @cindex articulations @cindex scripts @@ -141,7 +148,7 @@ MIDI rendering of the music. @node Dynamics -@subsubsection Dynamics +@unnumberedsubsubsec Dynamics @cindex absolute dynamics @cindex dynamics @@ -189,12 +196,12 @@ c2_\spp c^\ff A @notation{crescendo} mark is started with @code{\<} and terminated with @code{\!}, an absolute dynamic, or an additional -@notation{crescendo} or @notation{decrescendo} mark. A -@notation{decrescendo} mark is started with @code{\>} and is also -terminated with @code{\!}, an absolute dynamic, or another -@notation{crescendo} or @notation{decrescendo} mark. @code{\cr} -and @code{\decr} may be used instead of @code{\<} and @code{\>}. -@notation{Hairpins} are engraved by default using this notation. +crescendo or decrescendo mark. A @notation{decrescendo} mark is +started with @code{\>} and is also terminated with @code{\!}, an +absolute dynamic, or another crescendo or decrescendo mark. +@code{\cr} and @code{\decr} may be used instead of @code{\<} and +@code{\>}. @notation{Hairpins} are engraved by default using this +notation. @lilypond[verbatim,quote,relative=2] c2\< c\! @@ -206,7 +213,7 @@ d2\> d\> c1\! @end lilypond -Spacer notes are needed to engrave multiple marks on one note. +Spacer rests are needed to engrave multiple marks on one note. @lilypond[verbatim,quote,relative=2] c4\< c\! d\> e\! @@ -216,8 +223,8 @@ c4\< c\! d\> e\! @cindex espressivo articulation In some situations the @code{\espressivo} articulation mark may be -the appropriate choice to indicate a @notation{crescendo} and -@notation{decrescendo} on one note: +the appropriate choice to indicate a crescendo and decrescendo on +one note: @lilypond[verbatim,quote,relative=2] c2 b4 a @@ -227,21 +234,13 @@ g1\espressivo @cindex crescendo @cindex decrescendo @cindex diminuendo -@funindex \setTextCresc -@funindex \setTextDim -@funindex \setTextDecr -@funindex \setTextDecresc -@funindex \setHairpinCresc -@funindex \setHairpinDim -@funindex \setHairpinDecresc -@notation{Crescendos} and @notation{decrescendos} can be engraved -as textual markings instead of hairpins. The built-in commands -that enable these text modes are @code{\setTextCresc}, -@code{\setTextDecresc}, @code{\setTextDecr}, and -@code{\setTextDim}. The corresponding @code{\setHairpinCresc}, -@code{\setHairpinDim}, and @code{\setHairpinDecresc} commands will -revert to hairpins again: +Crescendos and decrescendos can be engraved as textual markings +instead of hairpins. The built-in commands that enable these text +modes are @code{\setTextCresc}, @code{\setTextDecresc}, +@code{\setTextDecr}, and @code{\setTextDim}. The corresponding +@code{\setHairpinCresc}, @code{\setHairpinDim}, and +@code{\setHairpinDecresc} commands will revert to hairpins again: @lilypond[verbatim,quote,relative=2] c4\< d e f\! @@ -268,7 +267,21 @@ Vertical positioning of dynamics is handled by @funindex \dynamicDown @code{\dynamicDown}, @funindex \dynamicNeutral -@code{\dynamicNeutral}. +@code{\dynamicNeutral}, +@funindex \setTextCresc +@code{\setTextCresc}, +@funindex \setTextDim +@code{\setTextDim}, +@funindex \setTextDecr +@code{\setTextDecr}, +@funindex \setTextDecresc +@code{\setTextDecresc}, +@funindex \setHairpinCresc +@code{\setHairpinCresc}, +@funindex \setHairpinDim +@code{\setHairpinDim}, +@funindex \setHairpinDecresc +@code{\setHairpinDecresc}. @snippets @@ -320,7 +333,7 @@ Internals Reference: @node New dynamic marks -@subsubsection New dynamic marks +@unnumberedsubsubsec New dynamic marks @cindex new dynamic marks @cindex dynamic marks, new @@ -402,6 +415,10 @@ Snippets: @node Curves @subsection Curves +This section explains how to create various expressive marks that +are curved: normal slurs, phrasing slurs, breath marks, falls, and +doits. + @menu * Slurs:: * Phrasing slurs:: @@ -410,7 +427,7 @@ Snippets: @end menu @node Slurs -@subsubsection Slurs +@unnumberedsubsubsec Slurs @cindex slurs @@ -422,8 +439,8 @@ a4 g2 f4) 2( 2) @end lilypond -@notation{Slurs} may be manually placed above or below the staff, -see @ref{Direction and placement}. +Slurs may be manually placed above or below the notes, see +@ref{Direction and placement}. @lilypond[verbatim,quote,relative=2] c2( d) @@ -433,9 +450,10 @@ c2( d) c2( d) @end lilypond -Different styles of @notation{slurs} may be created with the -commands @code{\slurDashed} and @code{slurDotted}; -@code{\slurSolid} reverts back to the default @notation{slur} +Phrasing slurs must be used to print more than one slur at once. +For details, see @ref{Phrasing slurs}. + +Slurs can be solid, dotted, or dashed. Solid is the default slur style: @lilypond[verbatim,quote,relative=1] @@ -448,10 +466,6 @@ c4( e g2) g4( e c2) @end lilypond -Using this method, only one slur can be printed at once. -@notation{Phrasing slurs} must be used to print a long slur over -one or more small slurs. For details, see @ref{Phrasing slurs}. - @predefined @@ -492,27 +506,27 @@ Internals Reference: @node Phrasing slurs -@subsubsection Phrasing slurs +@unnumberedsubsubsec Phrasing slurs @cindex phrasing slurs @cindex phrasing marks @funindex \( @funindex \) -@notation{Phrasing slurs} (or @notation{phrasing marks}) that -indicate a musical sentence are written using the commands -@code{\(} and @code{\)} respectively: +@notation{Phrasing slurs} (or phrasing marks) that indicate a +musical sentence are written using the commands @code{\(} and +@code{\)} respectively: @lilypond[verbatim,quote,relative=2] c4\( d( e) f( e2) d\) @end lilypond -Typographically, a @notation{phrasing slur} behaves almost exactly -like a normal @notation{slur}. However, they are treated as -different objects; a @code{\slurUp} will have no effect on a -@notation{phrasing slur}. Phrasing slurs may be manually placed -above or below the staff, see @ref{Direction and placement}. +Typographically, a phrasing slur behaves almost exactly like a +normal slur. However, they are treated as different objects; a +@code{\slurUp} will have no effect on a phrasing slur. Phrasing +slurs may be manually placed above or below the notes, see +@ref{Direction and placement}. @lilypond[verbatim,quote,relative=1] c4\( g' c,( b) | c1\) @@ -546,7 +560,7 @@ Internals Reference: @node Breath marks -@subsubsection Breath marks +@unnumberedsubsubsec Breath marks @cindex breath marks @funindex \breathe @@ -558,8 +572,7 @@ c2. \breathe d4 @end lilypond Musical indicators for breath marks in ancient notation, -@notation{divisiones}, are supported. For details, see -@ref{Divisiones}. +divisiones, are supported. For details, see @ref{Divisiones}. @snippets @@ -567,6 +580,27 @@ Musical indicators for breath marks in ancient notation, @lilypondfile[verbatim,lilyquote,texidoc,doctitle] {changing-the-breath-mark-symbol.ly} +@cindex caesura +@cindex railroad tracks + +@c input/new snippet +@c @lilypondfile[verbatim,lilyquote,texidoc,doctitle] +@c {inserting-a-caesura.ly} + +Caesura marks can be created by overriding the @code{'text} +property of the @code{BreathingSign} object. A curved caesura +mark is also available. + +@lilypond[verbatim,quote,relative=2] +\override BreathingSign #'text = + #(make-musicglyph-markup "scripts.caesura.straight") +c8 e4. \breathe g8. e16 c4 + +\override BreathingSign #'text = + #(make-musicglyph-markup "scripts.caesura.curved") +g8 e'4. \breathe g8. e16 c4 +@end lilypond + @seealso @@ -582,14 +616,17 @@ Internals Reference: @node Falls and doits -@subsubsection Falls and doits +@unnumberedsubsubsec Falls and doits @cindex falls @cindex doits @funindex \bendAfter @notation{Falls} and @notation{doits} can be added to notes using -the @code{\bendAfter} command: +the @code{\bendAfter} command. The direction of the fall or doit +is indicated with a plus or minus (up or down). The number +indicates the pitch interval that the fall or doit will extend +@emph{beyond} the main note. @lilypond[verbatim,quote,relative=2] c2-\bendAfter #+4 @@ -599,8 +636,7 @@ c2-\bendAfter #-8 @end lilypond The dash (@tie{-}) immediately preceding the @code{\bendAfter} -command is @emph{required} when writing @notation{falls} and -@notation{doits}. +command is @emph{required} when writing falls and doits. @snippets @@ -623,6 +659,9 @@ Snippets: @node Lines @subsection Lines +This section explains how to create various expressive marks that +follow a linear path: glissandos, arpeggios, and trills. + @menu * Glissando:: * Arpeggio:: @@ -630,7 +669,7 @@ Snippets: @end menu @node Glissando -@subsubsection Glissando +@unnumberedsubsubsec Glissando @cindex glissando @funindex \glissando @@ -643,8 +682,8 @@ g2\glissando g' c2\glissando c, @end lilypond -Different styles of @notation{glissandi} can be created. For -details, see @ref{Line styles}. +Different styles of glissandi can be created. For details, see +@ref{Line styles}. @snippets @@ -678,25 +717,23 @@ supported. @node Arpeggio -@subsubsection Arpeggio +@unnumberedsubsubsec Arpeggio @cindex arpeggio @cindex broken chord @cindex chord, broken -An @notation{arpeggio} on a chord (also known as a -@notation{broken chord}) is denoted by appending @code{\arpeggio} -to the chord construct: +An @notation{arpeggio} on a chord (also known as a broken chord) +is denoted by appending @code{\arpeggio} to the chord construct: @lilypond[verbatim,quote,relative=1] 1\arpeggio @end lilypond -The direction of an @notation{arpeggio} is indicated by adding an -arrowhead to the wiggly line. The commands @code{\arpeggioUp} and +The direction of an arpeggio is indicated by adding an arrowhead +to the wiggly line. The commands @code{\arpeggioUp} and @code{\arpeggioDown} are used for this task. -@code{\arpeggioNeutral} reverts back to an arrow-less -@notation{arpeggio}: +@code{\arpeggioNeutral} reverts back to an arrow-less arpeggio: @lilypond[verbatim,quote,relative=1] \arpeggioUp @@ -720,8 +757,8 @@ to a regular arpeggio: 1\arpeggio @end lilypond -A @emph{parenthesis} style bracket may be attached to an -@notation{arpeggio} instead of a square bracket. +A @emph{parenthesis} style bracket may be attached to a chord +construct instead of a square bracket. @c Maybe create a new \arpeggioParen command, or something @c like that. -pm @@ -735,8 +772,8 @@ A @emph{parenthesis} style bracket may be attached to an 1\arpeggio @end lilypond -@notation{Arpeggios} can be explicitly written out with -@notation{ties}. For more information, see @ref{Ties}. +Arpeggios can be explicitly written out with ties. For more +information, see @ref{Ties}. @predefined @@ -766,8 +803,6 @@ A @emph{parenthesis} style bracket may be attached to an @seealso -@c TODO: Add 'broken chord' to glossary. - Music Glossary: @rglos{arpeggio}. @@ -788,9 +823,12 @@ It is not possible to mix connected arpeggios and unconnected arpeggios in one @code{PianoStaff} at the same point in time. +The parenthesis-style arpeggio brackets do not work for +cross-staff arpeggios. + @node Trills -@subsubsection Trills +@unnumberedsubsubsec Trills @cindex trills @funindex \trill @@ -798,11 +836,11 @@ time. Short @notation{trills} without an extender line are printed with @code{\trill}; see @ref{Articulations and ornamentations}. -Long running @notation{trills} are made with -@code{\startTrillSpan} and @code{\stopTrillSpan}. In the -following example, a long running @notation{trill} is shown -combined with grace notes. To achieve precise control of the -placement of the grace notes, see @ref{Grace notes}. +Long running trills are made with @code{\startTrillSpan} and +@code{\stopTrillSpan}. In the following example, a long running +trill is shown combined with grace notes. To achieve precise +control of the placement of the grace notes, see @ref{Grace +notes}. @lilypond[verbatim,quote,relative=2] c1 \afterGrace @@ -813,9 +851,9 @@ c4 @cindex pitched trills @cindex trills, pitched -@notation{Trills} that should be executed on an explicitly -specified pitch can be typeset with the command -@code{\pitchedTrill} using the following syntax: +Trills that should be executed on an explicitly specified pitch +can be typeset with the command @code{\pitchedTrill} using the +following syntax: @example @code{\pitchedTrill} @var{mainnote} @code{\startTrillSpan} diff --git a/input/new/inserting-a-caesura.ly b/input/new/inserting-a-caesura.ly new file mode 100644 index 0000000000..df2ad1a115 --- /dev/null +++ b/input/new/inserting-a-caesura.ly @@ -0,0 +1,20 @@ +\version "2.11.49" +\header { + lsrtags = "expressive-marks,tweaks-and-overrides" + texidoc = " +Caesura marks can be created by overriding the @code{'text} +property of the @code{BreathingSign} object. A curved caesura +mark is also available. +" + doctitle = "Inserting a caesura" +} + +\relative c'' { + \override BreathingSign #'text = + #(make-musicglyph-markup "scripts.caesura.straight") + c8 e4. \breathe g8. e16 c4 + + \override BreathingSign #'text = + #(make-musicglyph-markup "scripts.caesura.curved") + g8 e'4. \breathe g8. e16 c4 +}