@cindex paper size
@cindex page size
-@findex papersize
+@funindex papersize
To change the paper size, there are two commands,
@example
The default layout responds to the following settings in the
@code{\paper} block.
-@findex \paper
+@funindex \paper
@quotation
@table @code
-@findex first-page-number
+@funindex first-page-number
@item first-page-number
The value of the page number of the first page. Default is@tie{}1.
-@findex printfirst-page-number
+@funindex printfirst-page-number
@item printfirst-page-number
If set to true, will print the page number in the first page. Default is
false.
-@findex print-page-number
+@funindex print-page-number
@item print-page-number
If set to false, page numbers will not be printed.
-@findex paper-width
+@funindex paper-width
@item paper-width
The width of the page.
-@findex paper-height
+@funindex paper-height
@item paper-height
The height of the page.
-@findex top-margin
+@funindex top-margin
@item top-margin
Margin between header and top of the page.
-@findex bottom-margin
+@funindex bottom-margin
@item bottom-margin
Margin between footer and bottom of the page.
-@findex left-margin
+@funindex left-margin
@item left-margin
Margin between the left side of the page and the beginning of the music.
-@findex line-width
+@funindex line-width
@item line-width
The length of the systems.
-@findex head-separation
+@funindex head-separation
@item head-separation
Distance between the top-most music system and the page header.
-@findex foot-separation
+@funindex foot-separation
@item foot-separation
Distance between the bottom-most music system and the page footer.
-@findex page-top-space
+@funindex page-top-space
Distance from the top of the printable area to the center of the first
staff. This only works for staves which are vertically small. Big staves
are set with the top of their bounding box aligned to the top of the
printable area.
-@findex ragged-bottom
+@funindex ragged-bottom
@item ragged-bottom
If set to true, systems will not be spread vertically across the page. This
does not affect the last page.
This should be set to true for pieces that have only two or three
systems per page, for example orchestral scores.
-@findex ragged-last-bottom
+@funindex ragged-last-bottom
@item ragged-last-bottom
If set to false, systems will be spread vertically to fill the last page.
Pieces that amply fill two pages or more should have this set to
true.
-@findex system-count
+@funindex system-count
@item system-count
This variable, if set, specifies into how many lines a score should be
broken.
-@findex between-system-space
+@funindex between-system-space
@item between-system-space
This dimensions determines the distance between systems. It is the
ideal distance between the center of the bottom staff of one system
Increasing this will provide a more even appearance of the page at the
cost of using more vertical space.
-@findex between-system-padding
+@funindex between-system-padding
@item between-system-padding
This dimension is the minimum amount of white space that will always
be present between the bottom-most symbol of one system, and the
farther apart.
-@findex horizontal-shift
+@funindex horizontal-shift
@item horizontal-shift
All systems (including titles and system separators) are shifted by
this amount to the right. Page markup, such as headers and footers are
not affected by this. The purpose of this variable is to make space
for instrument names at the left.
-@findex after-title-space
+@funindex after-title-space
@item after-title-space
Amount of space between the title and the first system.
-@findex after-title-space
+@funindex after-title-space
@item before-title-space
Amount of space between the last system of the previous piece and the
title of the next.
-@findex between-title-space
+@funindex between-title-space
@item between-title-space
Amount of space between consecutive titles (e.g., the title of the
book and the title of a piece).
-@findex printallheaders
+@funindex printallheaders
@item printallheaders
Setting this to #t will print all headers for each \score in a
\book. Normally only the piece and opus \headers are printed.
-@findex systemSeparatorMarkup
+@funindex systemSeparatorMarkup
@item systemSeparatorMarkup
This contains a markup object, which will be inserted between
systems. This is often used for orchestral scores.
@cindex font size, setting
@cindex staff size, setting
-@findex layout file
+@funindex layout file
To set the global staff size, use @code{set-global-staff-size}.
@node Score layout
@subsection Score layout
-@findex \layout
+@funindex \layout
While @code{\paper} contains settings that relate to the page formatting
of the whole document, @code{\layout} contains settings for score-specific
@section Vertical spacing
@cindex vertical spacing
+@cindex spacing, vertical
Vertical spacing is controlled by three things: the amount of
-space available (i.e. paper size and margins), the amount of
+space available (i.e., paper size and margins), the amount of
space between systems, and the amount of space between
staves inside a system.
@node Horizontal spacing
@section Horizontal Spacing
+@cindex horizontal spacing
+@cindex spacing, horizontal
+
@menu
-* Horizontal Intro::
+* Horizontal spacing overview::
+* Changing horizontal spacing::
* Line length::
@end menu
-@node Horizontal Intro
-@subsection Horizontal Intro
+@node Horizontal spacing overview
+@subsection Horizontal spacing overview
The spacing engine translates differences in durations into stretchable
distances (``springs'') of differring lengths. Longer durations get
this sets the base duration for spacing. The maximum duration for this
base (normally an 8th), is set through @code{base-shortest-duration}.
-@findex common-shortest-duration
-@findex base-shortest-duration
-@findex stem-spacing-correction
-@findex spacing
+@funindex common-shortest-duration
+@funindex base-shortest-duration
+@funindex stem-spacing-correction
+@funindex spacing
Notes that are even shorter than the common shortest note are
followed by a space that is proportional to their duration relative to
Proportional notation is supported; see @ref{Proportional notation}.
+
+@seealso
+
+Internals: @internalsref{SpacingSpanner}, @internalsref{NoteSpacing},
+@internalsref{StaffSpacing}, @internalsref{SeparationItem}, and
+@internalsref{SeparatingGroupSpanner}.
+
+
+@refbugs
+
+There is no convenient mechanism to manually override spacing. The
+following work-around may be used to insert extra space into a score.
+@example
+ \once \override Score.SeparationItem #'padding = #1
+@end example
+
+No work-around exists for decreasing the amount of space.
+
+
+@c FIXME: include this in 2.9; currently removed for 2.8 -gp
+@ignore
+@node New spacing area
+@subsection New spacing area
+
+New sections with different spacing parameters can be started with
+@code{newSpacingSection}. This is useful when there are
+sections with a different notions of long and short notes.
+
+In the following example, the time signature change introduces a new
+section, and hence the 16ths notes are spaced wider.
+
+@li lypond[relative,fragment,verbatim,quote]
+\time 2/4
+c4 c8 c
+c8 c c4 c16[ c c8] c4
+\newSpacingSection
+\time 4/16
+c16[ c c8]
+@e nd lilypond
+@end ignore
+
+@node Changing horizontal spacing
+@subsection Changing horizontal spacing
+
+Horizontal spacing may be altered with the
+@code{base-shortest-duration} property. Here
+we compare the same music; once without altering
+the property, and then altered. Larger values
+of @code{ly:make-moment} will produce smaller
+music.
+
+@lilypond[relative,verbatim,line-width=12\cm]
+\score {
+ \relative c'' {
+ g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
+ g4 e e2 | f4 d d2 | c4 e g g | c,1 |
+ d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
+ g4 e e2 | f4 d d2 | c4 e g g | c,1 |
+ }
+}
+@end lilypond
+
+@lilypond[relative,verbatim,line-width=12\cm]
+\score {
+ \relative c'' {
+ g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
+ g4 e e2 | f4 d d2 | c4 e g g | c,1 |
+ d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
+ g4 e e2 | f4 d d2 | c4 e g g | c,1 |
+ }
+ \layout {
+ \context {
+ \Score
+ \override SpacingSpanner
+ #'base-shortest-duration = #(ly:make-moment 1 4)
+ }
+ }
+}
+@end lilypond
+
+
+@commonprop
+
By default, spacing in tuplets depends on various non-duration
factors (such as accidentals, clef changes, etc). To disregard
such symbols and force uniform equal-duration spacing, use
@end lilypond
-@seealso
-
-Internals: @internalsref{SpacingSpanner}, @internalsref{NoteSpacing},
-@internalsref{StaffSpacing}, @internalsref{SeparationItem}, and
-@internalsref{SeparatingGroupSpanner}.
-
-@refbugs
-
-Spacing is determined on a score wide basis. If you have a score that
-changes its character (measured in durations) halfway during the
-score, the part containing the longer durations will be spaced too
-widely.
-
-There is no convenient mechanism to manually override spacing. The
-following work-around may be used to insert extra space into a score.
-@example
- \once \override Score.SeparationItem #'padding = #1
-@end example
-
-No work-around exists for decreasing the amount of space.
-
-
@node Line length
@subsection Line length
@cindex page breaks
@cindex breaking pages
-@findex indent
-@findex line-width
-@findex ragged-right
-@findex ragged-last
+@funindex indent
+@funindex line-width
+@funindex ragged-right
+@funindex ragged-last
@c Although line-width can be set in \layout, it should be set in paper
@c block, to get page layout right.
@refcommands
@code{\break}, and @code{\noBreak}.
-@findex \break
-@findex \noBreak
+@funindex \break
+@funindex \noBreak
@seealso
@refcommands
-@findex \pageBreak
+@funindex \pageBreak
@code{\pageBreak}
-@findex \noPageBreak
+@funindex \noPageBreak
@code{\noPageBreak}
@node Displaying spacing
@section Displaying spacing
-@findex annotate-spacing
+@funindex annotate-spacing
@cindex Spacing, display of properties
To graphically display the dimensions of vertical properties