Amend the examples in the LM and NR to use the \compressMMRests
music function rather than the predefs \compressFullBarRests and
\expandFullBarRests to avoid advocating the use of techniques
which may have undesirable side effects.
Guide, node Updating translation committishes..
@end ignore
Guide, node Updating translation committishes..
@end ignore
@node Fundamental concepts
@chapter Fundamental concepts
@node Fundamental concepts
@chapter Fundamental concepts
-When printing the part, multi-rests
-must be condensed. This is done by setting a run-time variable
+When printing the part, multi-measure rests must be compressed. There
+is a music function available to do this:
-\set Score.skipBars = ##t
+\compressMMRests @{ ... @}
-@noindent
-This command sets the property @code{skipBars} in the
-@code{Score} context to true (@code{##t}). Prepending the rest and
-this option to the music above, leads to the following result
+Applying this to @code{hornNotes} gives:
@lilypond[quote,ragged-right]
@lilypond[quote,ragged-right]
-\transpose f c' \relative c {
+\compressMMRests \transpose f c' \relative c {
- \set Score.skipBars = ##t
R2*3 |
r4 f8 a | cis4 f | e4 d |
}
R2*3 |
r4 f8 a | cis4 f | e4 d |
}
+@seealso
+Learning Manual:
+@ref{Organizing pieces with variables}.
+Notation Reference:
+@ruser{Transpose},
+@ruser{Writing parts},
+@ruser{Full measure rests},
+@ruser{Including LilyPond files}.
Guide, node Updating translation committishes..
@end ignore
Guide, node Updating translation committishes..
@end ignore
@node Changing defaults
@chapter Changing defaults
@node Changing defaults
@chapter Changing defaults
@lilypond[verbatim,quote,relative=2]
a1
@lilypond[verbatim,quote,relative=2]
a1
-\compressFullBarRests
-R1*23
-% increase the length of the rest bar
-\once \override MultiMeasureRest.minimum-length = #20
-R1*23
-a1
+\compressMMRests {
+ R1*23
+ % increase the length of the rest bar
+ \once \override MultiMeasureRest.minimum-length = #20
+ R1*23
+ a1
+}
@end lilypond
@lilypond[verbatim,quote,relative=2]
@end lilypond
@lilypond[verbatim,quote,relative=2]
Guide, node Updating translation committishes..
@end ignore
Guide, node Updating translation committishes..
@end ignore
@node Rhythms
@section Rhythms
@node Rhythms
@section Rhythms
@cindex whole rest for a full measure
@cindex rest, whole for a full measure
@cindex whole rest for a full measure
@cindex rest, whole for a full measure
+@funindex compressMMRests
+@funindex \compressMMRests
@funindex R
Rests for one or more full measures are entered like notes with
@funindex R
Rests for one or more full measures are entered like notes with
@lilypond[quote,verbatim,relative=2]
% Rest measures contracted to single measure
@lilypond[quote,verbatim,relative=2]
% Rest measures contracted to single measure
-\compressFullBarRests
-R1*4
-R1*24
-R1*4
-b2^"Tutti" b4 a4
+\compressMMRests {
+ R1*4
+ R1*24
+ R1*4
+ b2^"Tutti" b4 a4
+}
@end lilypond
The duration of full-measure rests is identical to the duration
@end lilypond
The duration of full-measure rests is identical to the duration
or fractions must often be used:
@lilypond[quote,verbatim,relative=2]
or fractions must often be used:
@lilypond[quote,verbatim,relative=2]
-\compressFullBarRests
-\time 2/4
-R1 | R2 |
-\time 3/4
-R2. | R2.*2 |
-\time 13/8
-R1*13/8 | R1*13/8*12 |
-\time 10/8
-R4*5*4 |
+\compressMMRests {
+ \time 2/4
+ R1 | R2 |
+ \time 3/4
+ R2. | R2.*2 |
+ \time 13/8
+ R1*13/8 | R1*13/8*12 |
+ \time 10/8
+ R4*5*4 |
+}
@end lilypond
A full-measure rest is printed as either a whole or breve rest,
@end lilypond
A full-measure rest is printed as either a whole or breve rest,
@cindex multi-measure rest, expanding
@cindex multi-measure rest, contracting
@cindex multi-measure rest, expanding
@cindex multi-measure rest, contracting
-@funindex \expandFullBarRests
-@funindex expandFullBarRests
-@funindex \compressFullBarRests
-@funindex compressFullBarRests
-
By default a multi-measure rest is expanded in the printed score to
show all the rest measures explicitly. Alternatively, a multi-measure
rest can be shown as a single measure containing a multi-measure rest
By default a multi-measure rest is expanded in the printed score to
show all the rest measures explicitly. Alternatively, a multi-measure
rest can be shown as a single measure containing a multi-measure rest
\time 2/4 R2 |
\time 4/4
% Rest measures contracted to single measure
\time 2/4 R2 |
\time 4/4
% Rest measures contracted to single measure
-\compressFullBarRests
-r1 | R1*17 | R1*4 |
-% Rest measures expanded
-\expandFullBarRests
+\compressMMRests {
+ r1 | R1*17 | R1*4 |
+}
+% Rest measures expanded again
\time 3/4
R2.*2 |
@end lilypond
\time 3/4
R2.*2 |
@end lilypond
is provided for adding fermatas.
@lilypond[quote,verbatim,relative=2]
is provided for adding fermatas.
@lilypond[quote,verbatim,relative=2]
-\compressFullBarRests
-\time 3/4
-R2.*10^\markup { \italic "ad lib." }
-R2.^\fermataMarkup
+\compressMMRests {
+ \time 3/4
+ R2.*10^\markup { \italic "ad lib." }
+ R2.^\fermataMarkup
+}
@end lilypond
@warning{Markups attached to a multi-measure rest are objects of type
@end lilypond
@warning{Markups attached to a multi-measure rest are objects of type
@funindex textLengthOff
@funindex \fermataMarkup
@funindex fermataMarkup
@funindex textLengthOff
@funindex \fermataMarkup
@funindex fermataMarkup
-@funindex \compressFullBarRests
-@funindex compressFullBarRests
-@funindex \expandFullBarRests
-@funindex expandFullBarRests
+@funindex \compressMMRests
+@funindex compressMMRests
@predefined
@code{\textLengthOn},
@code{\textLengthOff},
@code{\fermataMarkup},
@predefined
@code{\textLengthOn},
@code{\textLengthOff},
@code{\fermataMarkup},
-@code{\compressFullBarRests},
-@code{\expandFullBarRests}.
+@code{\compressMMRests}.
for horizontal spacing.
@lilypond[verbatim,quote,relative=0]
for horizontal spacing.
@lilypond[verbatim,quote,relative=0]
-\compressFullBarRests
-\markLengthOn
-\tempo "Molto vivace"
-R1*12
-\tempo "Meno mosso"
-R1*16
-\markLengthOff
-\tempo "Tranquillo"
-R1*20
+\compressMMRests {
+ \markLengthOn
+ \tempo "Molto vivace"
+ R1*12
+ \tempo "Meno mosso"
+ R1*16
+ \markLengthOff
+ \tempo "Tranquillo"
+ R1*20
+}