@cindex font size, selecting
@cindex selecting font size
-The easiest method of setting the font size of any context is by
-setting the @code{fontSize} property.
+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]
-c4
-\set fontSize = #-4
-c f
-\set fontSize = #3
-g8 a
+\huge
+c4.-> d8---3
+\large
+c4.-> d8---3
+\normalsize
+c4.-> d8---3
+\small
+c4.-> d8---3
+\tiny
+c4.-> d8---3
+\normalsize
+c2
@end lilypond
-@noindent
-It does not change the size of variable symbols, such as beams or
-slurs.
-
@cindex font size scaling
-Internally, the @code{fontSize} context property will cause 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 @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.
+Internally, this sets the @code{fontSize} property. This in turns
+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
+@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]
-c4
+\set fontSize = #3
+c4.-> d8---3
\override NoteHead #'font-size = #-4
-c f
-\override NoteHead #'font-size = #3
-g8 a
+c4.-> d8---3
+\override Script #'font-size = #3
+c4.-> d8---3
@end lilypond
@cindex standard font size
@code{font-size} equals 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 that
-use fonts. These are the ones supporting the @code{font-interface}
-layout interface.
+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
-The following commands set @code{fontSize} for the current voice:
-
@funindex \tiny
@code{\tiny},
@funindex \small
@code{\small},
@funindex \normalsize
-@code{\normalsize}.
+@code{\normalsize},
+@funindex \large
+@code{\large},
+@funindex \huge
+@code{\huge}.
+
+@snippets
@seealso
Fingering instructions can be entered using
@var{note}-@var{digit}:
-Fingering instructions may be manually placed above or below the
-staff, see @ref{Controlling direction and placement}.
@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
c4-1 d-2 f-4 e-3
< 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}.
@snippets
@end lilypond
@seealso
+@ref{Controlling direction and placement}
Snippets: @lsrdir{Editorial,Editorial-annotations}.
@end lilypond
@seealso
+@ref{Controlling direction and placement}.
Snippets: @lsrdir{Editorial,Editorial-annotations}.
square balloon. The primary purpose of this feature is to explain
notation.
-The following example demonstrates its use.
-
@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
\new Voice \with { \consists "Balloon_engraver" }
{
- \time 2/4
\balloonGrobText #'Stem #'(3 . 4) \markup { "I'm a Stem" }
- a8
- <c, g'-\balloonText #'(-2 . -2) \markup { "I'm a note head" } c>4.
+ a4
+ <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 \once \override to
-attach text to any grob, and the latter is used like \tweak,
+@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
\new ChoirStaff <<
\new Staff {
- \stemUp
- \relative {
- c'4. d8 e8 f g4
+ \relative c'' {
+ \stemUp
+ c4. d8 e8 f g4
}
}
\new Staff {
- \stemDown
\clef bass
\relative c {
+ \stemDown
c4 g' f e
}
}
>>
@end lilypond
-To change the grid lines use \override.
+@snippets
+To change the grid lines use \override.
-@lilypond[quote,verbatim,ragged-right]
+@lilypond[quote,verbatim,ragged-right]
\layout {
\context {
\Staff
\consists "Grid_point_engraver"
% sets up grids
- gridInterval = #(ly:make-moment 1 4)
- % this sets the grid interval to 1 quarternote (crotchet)
+ gridInterval = #(ly:make-moment 1 4)
+ % this sets the grid interval to 1 quarternote (crotchet)
}
}
-
+
\new Score \with {
\consists "Grid_line_span_engraver"
\override NoteColumn #'X-offset = #-0.5
% this moves them to the right half a staff space
}
-
+
\new ChoirStaff <<
- \new Staff {
- \stemUp
- \relative {
- c'4. d8 e8 f g4
- }
+ \new Staff {
+ \relative c'' {
+ \stemUp
+ c'4. d8 e8 f g4
+ }
}
\new Staff {
- \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
- % this moves them up one staff space from the default position
- \stemDown
- \clef bass
\relative c {
- c4 g' f e
+ \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
+ % this moves them up one staff space from the default position
+ \stemDown
+ \clef bass
+ \once \override Score.GridLine #'thickness = #5.0
+ c4
+ \once \override Score.GridLine #'thickness = #1.0
+ g'
+ \once \override Score.GridLine #'thickness = #3.0
+ f
+ \once \override Score.GridLine #'thickness = #5.0
+ e
}
}
>>
@cindex note grouping bracket
Brackets are used in musical analysis to indicate structure in musical
-pieces. LilyPond supports a simple form of nested horizontal
-brackets. To use this, add the @code{Horizontal_bracket_engraver} to
-the @code{Staff} context. A bracket is started with
-@code{\startGroup} and closed with @code{\stopGroup}.
+pieces. LilyPond supports a simple form of horizontal brackets.
+
+@lilypond[quote,verbatim,ragged-right]
+\layout {
+ \context {
+ \Staff \consists "Horizontal_bracket_engraver"
+ }
+}
+\relative c'' {
+ c2\startGroup
+ d\stopGroup
+}
+@end lilypond
+
+Analysis brackets may be nested.
@lilypond[quote,verbatim,ragged-right]
\layout {
}
\relative c'' {
c4\startGroup\startGroup
- c4\stopGroup
- c4\startGroup
- c4\stopGroup\stopGroup
+ d4\stopGroup
+ e4\startGroup
+ d4\stopGroup\stopGroup
}
@end lilypond
entering repetitious music.
@item percent
-Make beat or measure repeats. These look like percent signs.
+Write beat or measure repeats. These look like percent signs.
Percent repeats must be declared within a @code{Voice} context.
@item tremolo
-Make tremolo beams.
+Write tremolo beams.
@end table
+@ignore
LilyPond has one syntactic construct for specifying different
types of repeats. The syntax is
@var{alternative} is a music expression. If you give fewer
alternatives than @var{repeatcount}, the first alternative is assumed
to be played more than once.
+@end ignore
@menu
@node Normal repeats
@subsubsection Normal repeats
-FIXME: this example needs to go by itself.
-@verbatim
+The syntax for a simple repeat is
+
+@example
+\repeat @var{variant} @var{repeatcount} @var{repeatbody}
+@end example
+
+where @var{repeabody} is a music expression.
+
+Normal repeats, without alternate endings:
+
+@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
\repeat volta 2 { c4 d e f }
-@end verbatim
+c1
+@end lilypond
-Normal repeats, with or without alternate repeats:
+Normal repeats, with alternate endings:
@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
\repeat volta 2 { g f e d }
}
c1
@end lilypond
+
+
Repeats with upbeats:
@lilypond[quote,ragged-right,fragment,verbatim,relative=2]
@end lilypond
By default, the volta brackets will be drawn over all of the
-alternative music, but it is possible to shorten them by
-setting @code{voltaSpannerDuration}. In the next example, the
-bracket only lasts one measure, which is a duration of 3/4.
+alternative music, but it is possible to shorten them by setting
+@code{voltaSpannerDuration}. In the next example, the bracket only
+lasts one measure, which is a duration of 3/4.
@lilypond[verbatim,ragged-right,quote]
\relative c''{
}
@end lilypond
-The @code{Volta_engraver} by default resides in the Score context,
-and brackets for the repeat are thus normally only printed over
-the topmost staff. This can be adjusted by adding
-@code{Volta_engraver} to the Staff context where you want the
-brackets to appear; see @ref{Modifying context plug-ins} and
+The @code{Volta_engraver} by default resides in the Score context, and
+brackets for the repeat are thus normally only printed over the
+topmost staff. This can be adjusted by adding @code{Volta_engraver}
+to the Staff context where you want the brackets to appear; see
+@ref{Modifying context plug-ins} and
@c @lsr{repeats,volta@/-multi@/-staff@/.ly}.
@lilypond[verbatim,ragged-right,quote]
@c Is there a way to have a final bar ("|.") at the end of the
@c previous line? Doesn't seem to be.
-If you want to start a repeat at the beginning of a line and have
-a double bar at the end of the previous line, use
+If you want to start a repeat at the beginning of a line and have a
+double bar at the end of the previous line, use
@example
@dots{} \bar "||:" \break
@seealso
+Music Glossary: @rglos{repeat};
+@c FIXME : add @rglos{volta} after glossary addition
+
+Notation Reference: @ref{Bar lines}; @ref{Modifying context plug-ins}.
+
Snippets: @lsrdir{Repeats,Repeats}
Internals Reference: @internalsref{VoltaBracket},
having the @code{\alternative} belong to the inner @code{\repeat}.
For clarity, it is advisable to use braces in such situations.
-Timing information is not remembered at the start of an
-alternative, so after a repeat timing information must be reset by
-hand; for example, by setting @code{Score.measurePosition} or
-entering @code{\partial}. Similarly, slurs or ties are also not
-repeated.
+Timing information is not remembered at the start of an alternative,
+so after a repeat timing information must be reset by hand; for
+example, by setting @code{Score.measurePosition} or entering
+@code{\partial}. Similarly, slurs or ties are also not repeated.