| [ << Spacing issues ] | [Top][Contents][Index] | [ Changing defaults >> ] |
| [ < List of flexible vertical spacing paper variables ] | [ Up : Page layout ] | [ paper variables for widths and margins > ] |
4.1.5 Horizontal spacing \paper variables
Note: Some \paper dimensions are automatically
scaled to the paper size, which may lead to unexpected behavior.
See Automatic scaling to paper size.
\paper variables for widths and margins | ||
\paper variables for two-sided mode | ||
\paper variables for shifts and indents |
| [ << Spacing issues ] | [Top][Contents][Index] | [ Changing defaults >> ] |
| [ < Horizontal spacing paper variables ] | [ Up : Horizontal spacing paper variables ] | [ paper variables for two-sided mode > ] |
\paper variables for widths and margins
Default values (before scaling) that are not listed here are defined in ‘ly/paper-defaults-init.ly’.
-
paper-width -
The width of the page, unset by default. While
paper-widthhas no effect on the automatic scaling of some horizontal dimensions, it does influence theline-widthvariable. If bothpaper-widthandline-widthare set, thenleft-marginandright-marginwill also be updated. Also seecheck-consistency. -
line-width -
When specified in a
\paperblock this defines the horizontal extent available for the staff lines in un-indented systems. If left unspecified, the paper’sline-widthis determined from(paper-width - left-margin - right-margin). If the paper’sline-widthis specified, and bothleft-marginandright-marginare not, then the margins will be updated to center the systems on the page automatically. Also seecheck-consistency.line-widths for individual scores can be specified in the scores’\layoutblocks. These values control the width of the lines produced on a score-by-score basis. Ifline-widthis not specified for a score, it defaults to the paper’sline-width. Setting a score’sline-widthhas no effect on the paper margins. Staff lines, of a length determined by the score’sline-width, are left-aligned within the paper area defined by the paper’sline-width. If the score and paperline-widths are equal, the staff lines will extend exactly from the left margin to the right margin, but if the score’sline-widthis greater than the paper’sline-widththe staff lines will run over into the right margin. -
left-margin -
The margin between the left edge of the page and the start of the staff lines in unindented systems. If the paper size is modified, this dimension’s default value is scaled accordingly. If
left-marginis unset, and bothline-widthandright-marginare set, thenleft-marginis set to(paper-width - line-width - right-margin). If onlyline-widthis set, then both margins are set to((paper-width - line-width) / 2), and the systems are consequently centered on the page. Also seecheck-consistency. -
right-margin -
The margin between the right edge of the page and the end of the staff lines in non-ragged systems. If the paper size is modified, this dimension’s default value is scaled accordingly. If
right-marginis unset, and bothline-widthandleft-marginare set, thenright-marginis set to(paper-width - line-width - left-margin). If onlyline-widthis set, then both margins are set to((paper-width - line-width) / 2), and the systems are consequently centered on the page. Also seecheck-consistency. -
check-consistency -
If this is true (the default value), print a warning if
left-margin,line-width, andright-margindo not exactly add up topaper-width, and replace each of these (exceptpaper-width) with their default values (scaled to the paper size if necessary). If set to false, ignore any inconsistencies and allow systems to run off the edge of the page. -
ragged-right -
If set to true, systems will not fill the line width. Instead, systems end at their natural horizontal length. Default:
#tfor scores with only one system, and#ffor scores with two or more systems. This variable can also be set in a\layoutblock. -
ragged-last -
If set to true, the last system in the score will not fill the line width. Instead the last system ends at its natural horizontal length. Default:
#f. This variable can also be set in a\layoutblock.
See also
Notation Reference: Automatic scaling to paper size.
Installed Files: ‘ly/paper-defaults-init.ly’.
Known issues and warnings
Explicitly defined paper-sizes will override any user-defined left or right margin settings.
| [ << Spacing issues ] | [Top][Contents][Index] | [ Changing defaults >> ] |
| [ < paper variables for widths and margins ] | [ Up : Horizontal spacing paper variables ] | [ paper variables for shifts and indents > ] |
\paper variables for two-sided mode
Default values (before scaling) are defined in ‘ly/paper-defaults-init.ly’.
-
two-sided -
If set to true, use
inner-margin,outer-marginandbinding-offsetto determine margins depending on whether the page number is odd or even. This overridesleft-marginandright-margin. -
inner-margin -
The margin all pages have at the inner side if they are part of a book. If the paper size is modified, this dimension’s default value is scaled accordingly. Works only with
two-sidedset to true. -
outer-margin -
The margin all pages have at the outer side if they are part of a book. If the paper size is modified, this dimension’s default value is scaled accordingly. Works only with
two-sidedset to true. -
binding-offset -
The amount
inner-marginis increased to make sure nothing will be hidden by the binding. If the paper size is modified, this dimension’s default value is scaled accordingly. Works only withtwo-sidedset to true.
See also
Notation Reference: Automatic scaling to paper size.
Installed Files: ‘ly/paper-defaults-init.ly’.
| [ << Spacing issues ] | [Top][Contents][Index] | [ Changing defaults >> ] |
| [ < paper variables for two-sided mode ] | [ Up : Horizontal spacing paper variables ] | [ Other paper variables > ] |
\paper variables for shifts and indents
Default values (before scaling) that are not listed here are defined in ‘ly/paper-defaults-init.ly’.
-
horizontal-shift -
The amount that all systems (including titles and system separators) are shifted to the right. Default:
0.0\mm. -
indent -
The level of indentation for the first system in a score. If the paper size is modified, this dimension’s default value is scaled accordingly. The space within
line-widthavailable for the first system is reduced by this amount.indentmay also be specified in\layoutblocks to set indents on a score-by-score basis. -
short-indent -
The level of indentation for all systems in a score besides the first system. If the paper size is modified, this dimension’s default value is scaled accordingly. The space within
line-widthavailable for systems other than the first is reduced by this amount.short-indentmay also be specified in\layoutblocks to set short indents on a score-by-score basis.
See also
Notation Reference: Automatic scaling to paper size.
Installed Files: ‘ly/paper-defaults-init.ly’.
Snippets: Spacing.
| [ << Spacing issues ] | [Top][Contents][Index] | [ Changing defaults >> ] |
| [ < paper variables for two-sided mode ] | [ Up : Horizontal spacing paper variables ] | [ Other paper variables > ] |