X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;ds=sidebyside;f=Documentation%2Fuser%2Feditorial.itely;h=c8d021a84a545a7d2d0689ba838de5f982c9f80e;hb=8ddde8ef4b15f34e72a6817a231a0fa47841e42b;hp=3f04aff558f9347e5836345dc8efe680debd80d3;hpb=dafdaf6f564e4b658de316f629484cbeecf3c803;p=lilypond.git diff --git a/Documentation/user/editorial.itely b/Documentation/user/editorial.itely index 3f04aff558..c8d021a84a 100644 --- a/Documentation/user/editorial.itely +++ b/Documentation/user/editorial.itely @@ -6,48 +6,66 @@ version that you are working on. See TRANSLATION for details. @end ignore -@c \version "2.11.38" +@c \version "2.11.61" @node Editorial annotations @section Editorial annotations @lilypondfile[quote]{editorial-headword.ly} -This section discusses the various ways to change the appearance of +This section discusses the various ways to change the appearance of notes and add analysis or educational emphasis. @menu -* Inside the staff:: -* Outside the staff:: +* Inside the staff:: +* Outside the staff:: @end menu @node Inside the staff @subsection Inside the staff -This section discusses how to add emphasis to elements that are +This section discusses how to add emphasis to elements that are inside the staff. @menu -* Selecting notation font size:: -* Fingering instructions:: -* Hidden notes:: -* Coloring objects:: -* Parentheses:: -* Stems:: +* Selecting notation font size:: +* Fingering instructions:: +* Hidden notes:: +* Coloring objects:: +* Parentheses:: +* Stems:: @end menu @node Selecting notation font size @unnumberedsubsubsec Selecting notation font size +@cindex font size (notation) scaling @cindex font size (notation) @cindex selecting font size (notation) +@cindex notation font size +@cindex note heads +@funindex fontSize +@funindex font-size +@funindex magstep +@funindex \huge +@funindex \large +@funindex \normalsize +@funindex \small +@funindex \tiny +@funindex \teeny +@funindex huge +@funindex large +@funindex normalsize +@funindex small +@funindex tiny +@funindex teeny The font size of notation elements may be altered. It does not change the size of variable symbols, such as beams or slurs. @warning{For font sizes of text, see -@ref{Common markup commands}.} +@ref{Selecting font and font size}.} @lilypond[verbatim,quote,relative=2] \huge @@ -64,8 +82,6 @@ c4.-> d8---3 c4.-> d8---3 @end lilypond -@cindex font size (notation) scaling - Internally, this sets the @code{fontSize} property. This in turn causes the @code{font-size} property to be set in all layout objects. The value of @code{font-size} is a number indicating the @@ -89,6 +105,8 @@ c4.-> d8---3 @cindex standard font size (notation) @cindex font size (notation), standard +@funindex font-interface +@funindex font-size Font size changes are achieved by scaling the design size that is closest to the desired size. The standard font size (for @@ -99,8 +117,8 @@ The @code{font-size} property can only be set on layout objects that use fonts. These are the ones supporting the @code{font-interface} layout interface. -@predefined +@predefined @funindex \teeny @code{\teeny}, @funindex \tiny @@ -113,15 +131,14 @@ that use fonts. These are the ones supporting the @code{\large}, @funindex \huge @code{\huge}. +@endpredefined -@seealso +@seealso Snippets: @rlsr{Editorial annotations}. Internals Reference: -@rinternals{fontSize}, -@rinternals{font-size}, @rinternals{font-interface}. @@ -130,6 +147,8 @@ Internals Reference: @cindex fingering @cindex finger change +@funindex \finger +@funindex finger Fingering instructions can be entered using @var{note}-@var{digit}: @@ -138,22 +157,25 @@ Fingering instructions can be entered using c4-1 d-2 f-4 e-3 @end lilypond -Markup texts may be used for finger changes. +Markup texts may be used for finger changes. @lilypond[verbatim,quote,relative=2] c4-1 d-2 f-4 c^\markup { \finger "2 - 3" } @end lilypond @cindex thumb-script +@funindex \thumb +@funindex thumb A thumb-script can be added (e.g., in cello music) to indicate -that a note should be played with the thumb. +that a note should be played with the thumb. @lilypond[verbatim,quote,relative=2] 2 @end lilypond @cindex fingering chords +@cindex fingering instructions for chords @cindex chords, fingering Fingerings for chords can also be added to individual notes of the @@ -171,9 +193,14 @@ staff, see @ref{Direction and placement}. @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle] {controlling-the-placement-of-chord-fingerings.ly} +@lilypondfile[verbatim,lilyquote,texidoc,doctitle] +{allowing-fingerings-to-be-printed-inside-the-staff.ly} + +@lilypondfile[verbatim,lilyquote,texidoc,doctitle] +{avoiding-collisions-of-chord-fingering-with-beams.ly} -@seealso +@seealso Notation Reference: @ref{Direction and placement} @@ -194,8 +221,13 @@ Internals Reference: @cindex hidden notes @cindex invisible notes @cindex transparent notes +@cindex notes, hidden +@cindex notes, invisible +@cindex notes, transparent @funindex \hideNotes +@funindex hideNotes @funindex \unHideNotes +@funindex unHideNotes Hidden (or invisible or transparent) notes can be useful in preparing theory or composition exercises. @@ -206,7 +238,7 @@ c4 d e4 f \unHideNotes g a -\hideNotes +\hideNotes b \unHideNotes c @@ -223,13 +255,12 @@ e4(\p f)-- @predefined +@code{\hideNotes}, +@code{\unHideNotes}. +@endpredefined -@funindex \hideNotes -@funindex \unHideNotes -@code{\hideNotes}, @code{\unHideNotes} @seealso - Snippets: @rlsr{Editorial annotations}. @@ -247,6 +278,13 @@ Internals Reference: @cindex colored notes @cindex coloring notes @cindex notes, colored +@cindex x11 color +@cindex x11-color +@cindex with-color +@funindex color +@funindex \with-color +@funindex with-color +@funindex x11-color Individual objects may be assigned colors. Valid color names are listed in the @ref{List of colors}. @@ -260,7 +298,6 @@ d e @end lilypond -@cindex x11-color The full range of colors defined for X11 can be accessed by using the Scheme function @code{x11-color}. The function takes one @@ -270,7 +307,7 @@ write and is more efficient. However, using the second form it is possible to access X11 colors by the multi-word form of its name. If @code{x11-color} cannot make sense of the parameter then the -color returned defaults to black. +color returned defaults to black. @lilypond[verbatim,quote,relative=2] \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2) @@ -290,6 +327,11 @@ gis a b2 cis @end lilypond +@cindex rgb-color +@cindex color, rgb +@cindex rgb color +@funindex rgb-color + Exact RGB colors can be specified using the Scheme function @code{rgb-color}. @@ -298,27 +340,34 @@ Exact RGB colors can be specified using the Scheme function \set Staff.instrumentName = \markup { \with-color #(x11-color 'navy) "Clarinet" } - + \override Stem #'color = #(rgb-color 0 0 0) gis8 a \override Stem #'color = #(rgb-color 1 1 1) gis8 a -\override Stem #'color = #(rgb-color 0 0 0.5) +\override Stem #'color = #(rgb-color 0 0 0.5) gis4 a @end lilypond -@seealso +@seealso Notation Reference: -@ref{List of colors}, @ref{Objects connected to -the input}. +@ref{List of colors}, @ref{The +tweak command}. Snippets: @rlsr{Editorial annotations}. + +@cindex x11 color +@cindex colored notes in chords +@cindex notes, colored in chords +@cindex color in chords +@funindex x11-color + @knownissues An X11 color is not necessarily exactly the same shade as a -similarly named normal color. +similarly named normal color. Not all X11 colors are distinguishable in a web browser, i.e., a web browser might not display a difference between @code{'LimeGreen} @@ -327,7 +376,7 @@ and @code{'ForestGreen}. For web use normal colors are recommended Notes in a chord cannot be colored with @code{\override}; use -@code{\tweak} instead, see @ref{Objects connected to the input}. +@code{\tweak} instead, see @ref{The tweak command}. @node Parentheses @@ -337,6 +386,8 @@ Notes in a chord cannot be colored with @code{\override}; use @cindex notes, ghost @cindex notes, parenthesized @cindex parentheses +@funindex \parenthesize +@funindex parenthesize Objects may be parenthesized by prefixing @code{\parenthesize} to the music event. When prefixed to a chord, it parenthesizes every @@ -355,8 +406,8 @@ c2-\parenthesize -. d c2 \parenthesize r @end lilypond -@seealso +@seealso Snippets: @rlsr{Editorial annotations}. @@ -365,6 +416,7 @@ Internals Reference: @rinternals{ParenthesesItem}, @rinternals{parentheses-interface}. + @knownissues Parenthesizing a chord prints parentheses around each individual @@ -376,19 +428,22 @@ chord. @unnumberedsubsubsec Stems @cindex stem +@cindex stem, invisible +@cindex invisible stem Whenever a note is found, a @code{Stem} object is created automatically. For whole notes and rests, they are also created but made invisible. -@predefined +@predefined @funindex \stemUp @code{\stemUp}, @funindex \stemDown @code{\stemDown}, @funindex \stemNeutral @code{\stemNeutral}. +@endpredefined @snippets @@ -401,6 +456,7 @@ made invisible. @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle] {default-direction-of-stems-on-the-center-line-of-the-staff.ly} + @seealso Notation Reference: @ref{Direction and placement}. @@ -417,18 +473,28 @@ Internals Reference: @node Outside the staff @subsection Outside the staff -This section discusses how to add emphasis to elements in the staff -from outside of the staff. +This section discusses how to add emphasis to elements in the staff +from outside of the staff. @menu -* Balloon help:: -* Grid lines:: -* Analysis brackets:: +* Balloon help:: +* Grid lines:: +* Analysis brackets:: @end menu @node Balloon help @unnumberedsubsubsec Balloon help +@cindex balloon +@cindex notation, explaining +@cindex balloon help +@cindex help, balloon +@funindex \balloonGrobText +@funindex \balloonText +@funindex Balloon_engraver +@funindex balloonGrobText +@funindex balloonText + Elements of notation can be marked and named with the help of a square balloon. The primary purpose of this feature is to explain notation. @@ -437,15 +503,13 @@ notation. \new Voice \with { \consists "Balloon_engraver" } { \balloonGrobText #'Stem #'(3 . 4) \markup { "I'm a Stem" } - a8 + a8 \balloonGrobText #'Rest #'(-4 . -4) \markup { "I'm a rest" } r - 2. + 2. } @end lilypond -@cindex balloon -@cindex notation, explaining There are two music functions, @code{balloonGrobText} and @code{balloonText}; the former is used like @@ -461,23 +525,26 @@ altered: { \balloonLengthOff \balloonGrobText #'Stem #'(3 . 4) \markup { "I'm a Stem" } - a8 + a8 \balloonGrobText #'Rest #'(-4 . -4) \markup { "I'm a rest" } r \balloonLengthOn - 2. + 2. } @end lilypond @predefined - @funindex balloonLengthOn +@funindex \balloonLengthOn +@code{\balloonLengthOn}, +@funindex \balloonLengthOff @funindex balloonLengthOff -@code{\balloonLengthOn}, @code{\balloonLengthOff} +@code{\balloonLengthOff}. +@endpredefined -@seealso +@seealso Snippets: @rlsr{Editorial annotations}. @@ -490,6 +557,14 @@ Internals Reference: @node Grid lines @unnumberedsubsubsec Grid lines +@cindex grid lines +@cindex lines, grid +@cindex vertical lines between staves +@cindex lines, vertical between staves +@funindex Grid_point_engraver +@funindex Grid_line_span_engraver +@funindex gridInterval + Vertical lines can be drawn between staves synchronized with the notes. @@ -505,7 +580,7 @@ lines. \layout { \context { \Staff - \consists "Grid_point_engraver" + \consists "Grid_point_engraver" gridInterval = #(ly:make-moment 1 4) } \context { @@ -536,7 +611,6 @@ lines. @seealso - Snippets: @rlsr{Editorial annotations}. @@ -553,9 +627,17 @@ Internals Reference: @unnumberedsubsubsec Analysis brackets @cindex brackets -@cindex phrasing brackets +@cindex bracket, phrasing +@cindex phrasing bracket @cindex musicological analysis @cindex note grouping bracket +@cindex horizontal bracket +@cindex bracket, horizontal +@funindex Horizontal_bracket_engraver +@funindex \startGroup +@funindex startGroup +@funindex \stopGroup +@funindex stopGroup Brackets are used in musical analysis to indicate structure in musical pieces. Simple horizontal brackets are supported. @@ -590,8 +672,8 @@ Analysis brackets may be nested. } @end lilypond -@seealso +@seealso Snippets: @rlsr{Editorial annotations}.