From 501b19f070cbf3d3b147ce2aeba3cf6120cb22c1 Mon Sep 17 00:00:00 2001 From: Han-Wen Nienhuys Date: Mon, 3 Oct 2005 12:10:52 +0000 Subject: [PATCH] * Documentation/user/global.itely (Vertical spacing): document alignment-extra-space and fixed-alignment-extra-space. * Documentation/topdocs/NEWS.tely (Top): add entry. --- ChangeLog | 5 +++ Documentation/topdocs/NEWS.tely | 31 ++++++++++++-- Documentation/user/global.itely | 74 +++++++++++++++++++++++++++++++-- 3 files changed, 103 insertions(+), 7 deletions(-) diff --git a/ChangeLog b/ChangeLog index 2b47d146bf..65c841882f 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,10 @@ 2005-10-03 Han-Wen Nienhuys + * Documentation/user/global.itely (Vertical spacing): document + alignment-extra-space and fixed-alignment-extra-space. + + * Documentation/topdocs/NEWS.tely (Top): add entry. + * input/regression/alignment-vertical-spacing.ly: new file. * python/convertrules.py (conv): add rule. diff --git a/Documentation/topdocs/NEWS.tely b/Documentation/topdocs/NEWS.tely index 4d50e397da..c902799d1c 100644 --- a/Documentation/topdocs/NEWS.tely +++ b/Documentation/topdocs/NEWS.tely @@ -46,9 +46,34 @@ This document is also available in @uref{NEWS.pdf,PDF}. @itemize @bullet @item -Vertical alignments of staves may be tuned for individual systems -easily. +Vertical alignments of staves can now be tuned easily for individual +systems. + +@lilypond[raggedright] +#(set-global-staff-size 13) +\relative c'' << + \new PianoStaff << + \new Voice { + \set PianoStaff.instrument = #"piano" + \set PianoStaff.instr = #"pn" + c1_"normal" + + \overrideProperty + #"Score.NonMusicalPaperColumn" + #'line-break-system-details + #'((fixed-alignment-extra-space . 15)) + c + + } + { + c1\break + c\break + } + >> +>> +@end lilypond +This feature was sponsored by Nicolas Sceaux. @item Vertical spacing for page layout can now be tuned for each system @@ -62,7 +87,7 @@ individually. The dimensions that can be tuned can be visualized. } @end lilypond -This feature was sponsored by Trevor Bača and Nicolas Sceaux. +These features were sponsored by Trevor Bača and Nicolas Sceaux. @item The slope of a stem-tremolo may be set manually diff --git a/Documentation/user/global.itely b/Documentation/user/global.itely index 67d301ba03..fecb28f8dd 100644 --- a/Documentation/user/global.itely +++ b/Documentation/user/global.itely @@ -483,6 +483,8 @@ systems from bumping into each other, some minimum distances are set. By changing these, you can put staves closer together, and thus put more systems onto one page. +@c TODO: junk explanation of minimumVerticalExtent + Normally staves are stacked vertically. To make staves maintain a distance, their vertical size is padded. This is done with the property @code{minimumVerticalExtent}. It takes a pair of numbers, so @@ -500,6 +502,40 @@ either side of the center staff line. The argument of center line is the 0, so the first number is generally negative. The staff can be made larger at the bottom by setting it to @code{(-6 . 4)}. +The spacing of staves in a system may also be tuned per system. This is +done with the command + +@example +\overrideProperty +#"Score.NonMusicalPaperColumn" +#'line-break-system-details +#'((alignment-extra-space . 15)) +@end example + +@noindent +at the line break before the system to be changed. The distance +@code{15} is distributed over all staves that have a fixed distance +alignment. For example, + +@lilypond[raggedright, fragment, relative=2, staffsize=13] +\new StaffGroup << + \new Staff { + c1\break + + \overrideProperty + #"Score.NonMusicalPaperColumn" + #'line-break-system-details + #'((fixed-alignment-extra-space . 15)) + + c\break + } + \new Staff { c c } +>> +@end lilypond + +The distance for @code{alignment-extra-space} may also be negative. + + To change the amount of space between systems, use @code{betweensystemspace}. A score with only one staff is still considered to have systems, so setting @code{betweensystemspace} @@ -535,7 +571,7 @@ will graphically indicate the dimensions of properties that may be set for page spacing, @lilypond[verbatim] -#(set-default-paper-size "a6") +#(set-default-paper-size "a7" 'landscape) \paper { annotatespacing = ##t } { c4 } @end lilypond @@ -588,7 +624,7 @@ measured from the center line of each staff. The difference is demonstrated in the following example, @lilypond[quote,verbatim] -\relative << +\relative c'' << \new PianoStaff \with { \override VerticalAlignment #'forced-distance = #7 } << @@ -603,10 +639,40 @@ The difference is demonstrated in the following example, @end lilypond +It is also possible to change the distance between for each system +individually. This is done by including the command -@refbugs +@example +\overrideProperty +#"Score.NonMusicalPaperColumn" +#'line-break-system-details +#'((fixed-alignment-extra-space . 15)) +@end example + +@noindent +at the line break before the system to be changed. The distance +@code{15} is distributed over all staves that have a fixed distance +alignment. For example, + +@lilypond[raggedright, fragment, relative=2, staffsize=13] +\new PianoStaff << + \new Staff { + c1\break + + \overrideProperty + #"Score.NonMusicalPaperColumn" + #'line-break-system-details + #'((fixed-alignment-extra-space . 15)) + + c\break + } + \new Staff { c c } +>> +@end lilypond + +The distance for @code{fixed-alignment-extra-space} may also be +negative. -@code{forced-distance} cannot be changed per system. @node Horizontal spacing @subsection Horizontal Spacing -- 2.39.5