version that you are working on. See TRANSLATION for details.
@end ignore
+@c \version "2.11.51"
+
@node Editorial annotations
@section Editorial annotations
@node Selecting notation font size
@unnumberedsubsubsec Selecting notation font size
-@cindex font size
-@cindex font size, selecting
-@cindex selecting font size
+@cindex font size (notation)
+@cindex selecting font size (notation)
The font size of notation elements may be altered. It does not
change the size of variable symbols, such as beams or slurs.
-@lilypond[quote,fragment,relative=2,verbatim,ragged-right]
+@warning{For font sizes of text, see
+@ref{Common markup commands}.}
+
+@lilypond[verbatim,quote,relative=2]
\huge
c4.-> d8---3
\large
c4.-> d8---3
\tiny
c4.-> d8---3
-\normalsize
-c2
+\teeny
+c4.-> d8---3
@end lilypond
-@cindex font size scaling
+@cindex font size (notation) scaling
-Internally, this sets the @code{fontSize} property. This in turns
+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
size relative to the standard size for the current staff height.
Each step up is an increase of approximately 12% of the font size.
-Six steps is exactly a factor two. The Scheme function
+Six steps is exactly a factor of two. The Scheme function
@code{magstep} converts a @code{font-size} number to a scaling
factor. The @code{font-size} property can also be set directly,
so that only certain layout objects are affected.
-@lilypond[quote,fragment,relative=2,verbatim,ragged-right]
+@lilypond[verbatim,quote,relative=2]
\set fontSize = #3
c4.-> d8---3
\override NoteHead #'font-size = #-4
c4.-> d8---3
@end lilypond
-@cindex standard font size
-@cindex font size, standard
+@cindex standard font size (notation)
+@cindex font size (notation), standard
Font size changes are achieved by scaling the design size that is
closest to the desired size. The standard font size (for
-@code{font-size} equals 0), depends on the standard staff height.
+@w{@code{font-size = #0}}) depends on the standard staff height.
For a 20pt staff, a 10pt font is selected.
The @code{font-size} property can only be set on layout objects
@predefined
+@funindex \teeny
+@code{\teeny},
@funindex \tiny
@code{\tiny},
@funindex \small
@seealso
Snippets:
-@lsrdir{Editorial,Editorial-annotations}.
+@rlsr{Editorial annotations}.
Internals Reference:
-@internalsref{font-interface}.
+@rinternals{fontSize},
+@rinternals{font-size},
+@rinternals{font-interface}.
@node Fingering instructions
Fingering instructions can be entered using
@var{note}-@var{digit}:
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
c4-1 d-2 f-4 e-3
@end lilypond
Markup texts may be used for finger changes.
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
c4-1 d-2 f-4 c^\markup { \finger "2 - 3" }
@end lilypond
@cindex thumb-script
-You can use the thumb-script (e.g., in cello music)to indicate that a
-note should be played with the thumb.
+A thumb-script can be added (e.g., in cello music) to indicate
+that a note should be played with the thumb.
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
<a_\thumb a'-3>2 <b_\thumb b'-3>
@end lilypond
Fingerings for chords can also be added to individual notes of the
chord by adding them after the pitches.
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-< c-1 e-2 g-3 b-5 >2 < d-1 f-2 a-3 c-5 >
+@lilypond[verbatim,quote,relative=2]
+<c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
@end lilypond
Fingering instructions may be manually placed above or below the
-staff, see @ref{Controlling direction and placement}.
+staff, see @ref{Direction and placement}.
@snippets
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
{controlling-the-placement-of-chord-fingerings.ly}
@seealso
Notation Reference:
-@ref{Controlling direction and placement}
+@ref{Direction and placement}
Snippets:
-@lsrdir{Editorial,Editorial-annotations}.
+@rlsr{Editorial annotations}.
Internals Reference:
-@internalsref{Fingering}.
+@rinternals{FingeringEvent},
+@rinternals{fingering-event},
+@rinternals{Fingering_engraver},
+@rinternals{New_fingering_engraver},
+@rinternals{Fingering}.
@node Hidden notes
@unnumberedsubsubsec Hidden notes
-@cindex Hidden notes
-@cindex Invisible notes
-@cindex Transparent notes
+@cindex hidden notes
+@cindex invisible notes
+@cindex transparent notes
@funindex \hideNotes
@funindex \unHideNotes
Hidden (or invisible or transparent) notes can be useful in
preparing theory or composition exercises.
-@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
+@lilypond[verbatim,quote,relative=2]
c4 d
\hideNotes
e4 f
c
@end lilypond
+Notation objects which are attached to invisible notes are still
+visible.
+
+@lilypond[verbatim,quote,relative=2]
+c4( d)
+\hideNotes
+e4(\p f)--
+@end lilypond
+
+
@predefined
+@funindex \hideNotes
+@funindex \unHideNotes
@code{\hideNotes}, @code{\unHideNotes}
@seealso
Snippets:
-@lsrdir{Editorial,Editorial-annotations}.
+@rlsr{Editorial annotations}.
+
+Internals Reference:
+@rinternals{Note_spacing_engraver},
+@rinternals{NoteSpacing}.
@node Coloring objects
@cindex coloring notes
@cindex notes, colored
-Individual objects may be assigned colors. You may use the color
-names listed in the @ref{List of colors}.
+Individual objects may be assigned colors. Valid color names
+are listed in the @ref{List of colors}.
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
\override NoteHead #'color = #red
c4 c
\override NoteHead #'color = #(x11-color 'LimeGreen)
If @code{x11-color} cannot make sense of the parameter then the
color returned defaults to black.
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
\override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
\set Staff.instrumentName = \markup {
\with-color #(x11-color 'navy) "Clarinet"
b2 cis
@end lilypond
-You can get exact RGB colors by specifying the rgb-color number.
+Exact RGB colors can be specified using the Scheme function
+@code{rgb-color}.
-@lilypond[quote,ragged-right,verbatim,fragment,relative=2]
+@lilypond[verbatim,quote,relative=2]
\override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
\set Staff.instrumentName = \markup {
\with-color #(x11-color 'navy) "Clarinet"
}
-%black
\override Stem #'color = #(rgb-color 0 0 0)
gis8 a
-% white
\override Stem #'color = #(rgb-color 1 1 1)
gis8 a
-% dark blue
\override Stem #'color = #(rgb-color 0 0 0.5)
gis4 a
@end lilypond
the input}.
Snippets:
-@lsrdir{Editorial,Editorial-annotations}.
+@rlsr{Editorial annotations}.
@knownissues
-An x11 color is not necessarily exactly the same shade as a
+An X11 color is not necessarily exactly the same shade as a
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 'LimeGreen and 'ForestGreen. For
-web use normal colors are recommended (i.e. #blue, #green, #red).
+Not all X11 colors are distinguishable in a web browser, i.e.,
+a web browser might not display a difference between @code{'LimeGreen}
+and @code{'ForestGreen}. For web use normal colors are recommended
+(i.e., @code{#blue}, @code{#green}, @code{#red}).
Notes in a chord cannot be colored with @code{\override}; use
@cindex parentheses
Objects may be parenthesized by prefixing @code{\parenthesize} to
-the music event. This only functions inside chords; to
-parenthesize a single note it must be enclosed with @code{<>} as
-if it is a chord.
-
-FIXME: after 2.11.44 is out,
-@c \parenthesize c4-. \parenthesize r4 \parenthesize <c e g>4->
+the music event. When prefixed to a chord, it parenthesizes every
+note. Individual notes inside a chord may also be parenthesized.
-@lilypond[quote,relative=2,fragment,verbatim,ragged-right]
-c2 < \parenthesize d>
+@lilypond[verbatim,quote,relative=2]
+c2 \parenthesize d
+c2 \parenthesize <c e g>
+c2 <c \parenthesize e g>
@end lilypond
Non-note objects may be parenthesized as well.
-@lilypond[quote,relative=2,fragment,verbatim,ragged-right]
-< c d g >2-\parenthesize -. d
+@lilypond[verbatim,quote,relative=2]
+c2-\parenthesize -. d
+c2 \parenthesize r
@end lilypond
@seealso
Snippets:
-@lsrdir{Editorial,Editorial-annotations}.
+@rlsr{Editorial annotations}.
+
+Internals Reference:
+@rinternals{Parenthesis_engraver},
+@rinternals{ParenthesesItem},
+@rinternals{parentheses-interface}.
@knownissues
-Rests cannot be parenthesized.
+Parenthesizing a chord prints parentheses around each individual
+note, instead of a single large parenthesis around the entire
+chord.
@node Stems
@cindex stem, down
@cindex stem, neutral
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
{default-direction-of-stems-on-the-center-line-of-the-staff.ly}
@seealso
Notation Reference:
-@ref{Controlling direction and placement}.
+@ref{Direction and placement}.
Snippets:
-@lsrdir{Editorial,Editorial-annotations}.
+@rlsr{Editorial annotations}.
+
+Internals Reference:
+@rinternals{Stem_engraver},
+@rinternals{Stem},
+@rinternals{stem-interface}.
@node Outside the staff
square balloon. The primary purpose of this feature is to explain
notation.
-@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
+@lilypond[verbatim,quote,relative=2]
\new Voice \with { \consists "Balloon_engraver" }
{
\balloonGrobText #'Stem #'(3 . 4) \markup { "I'm a Stem" }
a8
- \balloonGrobText #'Rest #' (-4 . -4) \markup { "I'm a rest" }
+ \balloonGrobText #'Rest #'(-4 . -4) \markup { "I'm a rest" }
r
<c, g'-\balloonText #'(-2 . -2) \markup { "I'm a note head" } c>2.
}
@end lilypond
-There are two music functions, @code{balloonGrobText} and
-@code{balloonText}; The former is used like @code{\once \override} to
-attach text to any grob, and the latter is used like @code{ \tweak},
-typically within chords, to attach text to an individual note.
-
@cindex balloon
@cindex notation, explaining
+There are two music functions, @code{balloonGrobText} and
+@code{balloonText}; the former is used like
+@w{@code{\once \override}} to attach text to any grob, and the
+latter is used like @code{\tweak}, typically within chords, to
+attach text to an individual note.
+
+Balloon text normally influences note spacing, but this can be
+altered:
+
+@lilypond[verbatim,quote,relative=2]
+\new Voice \with { \consists "Balloon_engraver" }
+{
+ \balloonLengthOff
+ \balloonGrobText #'Stem #'(3 . 4) \markup { "I'm a Stem" }
+ a8
+ \balloonGrobText #'Rest #'(-4 . -4) \markup { "I'm a rest" }
+ r
+ \balloonLengthOn
+ <c, g'-\balloonText #'(-2 . -2) \markup { "I'm a note head" } c>2.
+}
+@end lilypond
+
+
+@predefined
+
+@funindex balloonLengthOn
+@funindex balloonLengthOff
+@code{\balloonLengthOn}, @code{\balloonLengthOff}
+
@seealso
Snippets:
-@lsrdir{Editorial,Editorial-annotations}.
+@rlsr{Editorial annotations}.
Internals Reference:
-@internalsref{text-balloon-interface}.
+@rinternals{Balloon_engraver},
+@rinternals{BalloonTextItem},
+@rinternals{balloon-interface}.
@node Grid lines
Vertical lines can be drawn between staves synchronized with the
notes.
-@lilypond[quote,verbatim,ragged-right]
+The @code{Grid_point_engraver} must be used to create the end
+points of the lines, while the @code{Grid_line_span_engraver} must
+be used to actually draw the lines. By default this centers grid
+lines horizontally below and to the left side of each note head.
+Grid lines extend from the middle lines of each staff. The
+@code{gridInterval} must specify the duration between the grid
+lines.
+
+@lilypond[verbatim,quote]
\layout {
\context {
\Staff
- % sets up grids
\consists "Grid_point_engraver"
- % this sets the grid interval to 1 quarternote (crotchet)
gridInterval = #(ly:make-moment 1 4)
- }
-}
-
-\new Score \with {
- % by default this centers grid lines horizontally below and to the
- % left side of the notehead, the grid lines extend from
- % the middle lines of each staff
- \consists "Grid_line_span_engraver"
}
+ \context {
+ \Score
+ \consists "Grid_line_span_engraver"
+ }
+}
-\new ChoirStaff <<
- \new Staff {
- \relative c'' {
+\score {
+ \new ChoirStaff <<
+ \new Staff \relative c'' {
\stemUp
c4. d8 e8 f g4
}
- }
- \new Staff {
- \clef bass
- \relative c {
+ \new Staff \relative c {
+ \clef bass
\stemDown
- c4 g' f e
+ c4 g' f e
}
- }
->>
+ >>
+}
@end lilypond
@snippets
-@lilypondfile[verbatim,lilyquote,ragged-right,texidoc]
-{grid-lines-changing-their-appearance.ly}
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{grid-lines--changing-their-appearance.ly}
@seealso
Snippets:
-@lsrdir{Editorial,Editorial-annotations}.
-
+@rlsr{Editorial annotations}.
+Internals Reference:
+@rinternals{Grid_line_span_engraver},
+@rinternals{Grid_point_engraver},
+@rinternals{GridLine},
+@rinternals{GridPoint},
+@rinternals{grid-line-interface},
+@rinternals{grid-point-interface}.
@node Analysis brackets
@cindex note grouping bracket
Brackets are used in musical analysis to indicate structure in musical
-pieces. LilyPond supports a simple form of horizontal brackets.
+pieces. Simple horizontal brackets are supported.
-@lilypond[quote,verbatim,ragged-right]
+@lilypond[verbatim,quote]
\layout {
\context {
- \Staff \consists "Horizontal_bracket_engraver"
+ \Voice
+ \consists "Horizontal_bracket_engraver"
}
}
\relative c'' {
Analysis brackets may be nested.
-@lilypond[quote,verbatim,ragged-right]
+@lilypond[verbatim,quote]
\layout {
\context {
- \Staff \consists "Horizontal_bracket_engraver"
+ \Voice
+ \consists "Horizontal_bracket_engraver"
}
}
\relative c'' {
@seealso
Snippets:
-@lsrdir{Editorial,Editorial-annotations}.
+@rlsr{Editorial annotations}.
Internals Reference:
-@internalsref{HorizontalBracket},
-@internalsref{Horizontal_bracket_engraver},
-@internalsref{Staff}.
+@rinternals{Horizontal_bracket_engraver},
+@rinternals{HorizontalBracket},
+@rinternals{horizontal-bracket-interface},
+@rinternals{Staff}.
projects / lilypond.git / blobdiff