X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Fspacing.itely;h=9270e31502dc046c4a6e12a7491f33aa8275394e;hb=16013bd6cc1679432f43db72a519378b5993c208;hp=f7234ac0980f97c476fdfbebf491deffc6ccdebd;hpb=89b84a1a2f33cad1a710b434e4e05ef6a7d45ca7;p=lilypond.git diff --git a/Documentation/user/spacing.itely b/Documentation/user/spacing.itely index f7234ac098..9270e31502 100644 --- a/Documentation/user/spacing.itely +++ b/Documentation/user/spacing.itely @@ -7,7 +7,7 @@ version that you are working on. See TRANSLATION for details. @end ignore -@c \version "2.11.64" +@c \version "2.12.0" @ignore GDP TODO list @@ -162,7 +162,6 @@ the variables. @seealso - Installed Files: @file{scm/@/paper@/.scm}. @@ -350,7 +349,6 @@ page given the system to put on it. @seealso - Notation Reference: @ref{Vertical spacing between systems}. @@ -414,7 +412,6 @@ first system. Default: @code{0}, as determined by @seealso - Snippets: @rlsr{Spacing}. @@ -595,7 +592,6 @@ Default: unset. @seealso - Snippets: @rlsr{Spacing}. @@ -712,13 +708,8 @@ These fonts are available in any sizes. The context property @rinternals{StaffSymbol}) can be used to tune the size for individual staves. The sizes of individual staves are relative to the global size. -@example - -@end example - @seealso - Notation Reference: @ref{Selecting notation font size}. @@ -756,7 +747,6 @@ layout. @seealso - Notation Reference: @ref{Changing context default settings}. @@ -850,15 +840,14 @@ complicated. More details are available in @predefined - @funindex \break @code{\break}, @funindex \noBreak @code{\noBreak}. +@endpredefined @seealso - Internals Reference: @rinternals{LineBreakEvent}. @@ -967,16 +956,16 @@ book parts. @} @end example -@predefined +@predefined @funindex \pageBreak @code{\pageBreak}, @funindex \noPageBreak @code{\noPageBreak}. +@endpredefined @seealso - Snippets: @rlsr{Spacing}. @@ -993,7 +982,6 @@ cramping and stretching, both horizontally and vertically. Unlike @seealso - Snippets: @rlsr{Spacing}. @@ -1065,17 +1053,16 @@ top-level markups. @predefined - @funindex \pageTurn @code{\pageTurn}, @funindex \noPageTurn @code{\noPageTurn}, @funindex \allowPageTurn @code{\allowPageTurn}. +@endpredefined @seealso - Snippets: @rlsr{Spacing}. @@ -1105,7 +1092,6 @@ too slow or memory demanding, or a lot of texts. It is enabled using: @seealso - Snippets: @rlsr{Spacing}. @@ -1154,7 +1140,6 @@ page breaks at explicit @code{\pageBreak} commands and nowhere else. @seealso - Snippets: @rlsr{Spacing}. @@ -1238,7 +1223,6 @@ This pattern becomes especially helpful when overriding @seealso - Notation Reference: @ref{Vertical spacing}. @@ -1370,7 +1354,6 @@ the @code{Axis_group_engraver}. @seealso - Snippets: @rlsr{Spacing}. @@ -1435,7 +1418,6 @@ the last one. @seealso - Snippets: @rlsr{Spacing}. @@ -1669,7 +1651,6 @@ passed to these different settings will avoid this. @seealso - Snippets: @rlsr{Spacing}. @@ -1734,7 +1715,6 @@ lilypond .ly @seealso - Snippets: @rlsr{Spacing}. @@ -1795,29 +1775,31 @@ c^"This text is padded away from the previous text" c^"This text is placed close to the previous text" @end lilypond -TODO: this example doesn't work any more ? -By default, outside-staff objects are placed without regard to -their horizontal distance from the previously-positioned grobs. This +By default, outside-staff objects are placed only to avoid +a horizontal collision with previously-positioned grobs. This can lead to situations in which objects are placed very close to each -other horizontally. Setting @code{outside-staff-horizontal-padding} +other horizontally. The vertical spacing between staffs can +also be set so that outside staff objects are interleaved. +Setting @code{outside-staff-horizontal-padding} causes an object to be offset vertically so that such a situation doesn't occur. @lilypond[quote,ragged-right,relative=2,fragment,verbatim] % the markup is too close to the following note -c2^"Text" +c4^"Text" +c4 c''2 % setting outside-staff-horizontal-padding fixes this R1 \once \override TextScript #'outside-staff-horizontal-padding = #1 -c,,2^"Text" +c,,4^"Text" +c4 c''2 @end lilypond @seealso - Snippets: @rlsr{Spacing}. @@ -1926,7 +1908,6 @@ Proportional notation is supported; see @ref{Proportional notation}. @seealso - Snippets: @rlsr{Spacing}. @@ -1934,15 +1915,16 @@ Internals Reference: @rinternals{SpacingSpanner}, @rinternals{NoteSpacing}, @rinternals{StaffSpacing}, -@rinternals{SeparationItem}. +@rinternals{NonMusicalPaperColumn}. @knownissues There is no convenient mechanism to manually override spacing. The -following work-around may be used to insert extra space into a score. +following work-around may be used to insert extra space into a score, +adjusting the padding value as necessary. @example - \once \override Score.SeparationItem #'padding = #1 + \override Score.NonMusicalPaperColumn #'padding = #10 @end example No work-around exists for decreasing the amount of space. @@ -1973,7 +1955,6 @@ may be used in that location. @seealso - Snippets: @rlsr{Spacing}. @@ -2060,7 +2041,6 @@ regard for clefs, bar lines, and grace notes, @seealso - Snippets: @rlsr{Spacing}. @@ -2113,7 +2093,6 @@ paragraph, the last line simply takes its natural horizontal length. @seealso - Snippets: @rlsr{Spacing}. @@ -2462,7 +2441,6 @@ for these related settings. @seealso - Notation Reference: @ref{New spacing area}. @@ -2508,19 +2486,37 @@ that may be altered for page formatting, set } @end lilypond + @noindent -All layout dimensions are displayed in staff spaces, regardless of -the units specified in the @code{\paper} or @code{\layout} block. -For example, @code{paper-height} has a value of 59.75 staff -spaces, using the default staff size of 20 points, which is -equivalent to 148 millimeters, the height of @code{a6} paper in -landscape orientation. The pairs (@var{a},@var{b}) are intervals, -where @var{a} is the lower edge and @var{b} the upper edge of the -interval. +All layout dimensions are displayed in staff-spaces, regardless +of the units specified in the @code{\paper} or @code{\layout} block. +In the above example, @code{paper-height} has a value of 59.75 +@code{staff-spaces}, and the @code{staff-size} is 20 points (the +default value). Note that: +@multitable {1 staff-space} {staff-size)/4 * (25.4/72.27) mm} -@seealso +@item 1 point +@tab = (25.4/72.27) mm + +@item 1 staff-space +@tab = (@code{staff-size})/4 pts +@item +@tab = (@code{staff-size})/4 * (25.4/72.27) mm + +@end multitable +@noindent +In this case, one @code{staff-space} is approximately equal to +1.757mm. Thus the @code{paper-height} measurement of 59.75 +@code{staff-spaces} is equivalent to 105 millimeters, the height +of @code{a6} paper in landscape orientation. The pairs +(@var{a},@var{b}) are intervals, where @var{a} is the lower +edge and @var{b} the upper edge of the interval. + + +@seealso +@ref{Setting the staff size} Snippets: @rlsr{Spacing}. @@ -2625,7 +2621,6 @@ block so that it applies to the whole score. @seealso - Notation Reference: @ref{Page formatting}, @ref{Changing horizontal spacing}.