[ << Backend ]	[Top][Contents][Index]	[ Scheme functions >> ]
[ < MetronomeMark ]	[ Up: All layout objects ]	[ MultiMeasureRestNumber > ]

---

3.1.88 MultiMeasureRest

A multi-measure rest. See also MultiMeasureRestNumber, MultiMeasureRestText, MultiMeasureRestScript, and Rest.

MultiMeasureRest objects are created by the following engraver(s): Multi_measure_rest_engraver.

Standard settings:

bound-padding (number):

0.5

The amount of padding to insert around spanner bounds.

expand-limit (integer):

10

Maximum number of measures expanded in church rests.

hair-thickness (number):

2.0

Thickness of the thin line in a bar line, expressed as a multiple of the default staff-line thickness (i.e., the visual output is not influenced by changes to Staff.StaffSymbol.thickness).

max-symbol-separation (number):

8.0

The maximum distance between symbols making up a church rest.

round-up-exceptions (list):

'()

A list of pairs where car is the numerator and cdr the denominator of a moment. Each pair in this list means that the multi-measure rests of the corresponding length will be rounded up to the longer rest. See round-up-to-longer-rest.

spacing-pair (pair):

'(break-alignment . break-alignment)

A pair of alignment symbols which set an object’s spacing relative to its left and right BreakAlignments.

For example, a MultiMeasureRest will ignore prefatory items at its bounds (i.e., clefs, key signatures and time signatures) using the following override:

\override MultiMeasureRest.spacing-pair =
             #'(staff-bar . staff-bar)

springs-and-rods (boolean):

ly:multi-measure-rest::set-spacing-rods

Dummy variable for triggering spacing routines.

stencil (stencil):

ly:multi-measure-rest::print

The symbol to print.

thick-thickness (number):

6.6

Thickness of the thick line in a bar line, expressed as a multiple of the default staff-line thickness (i.e., the visual output is not influenced by changes to Staff.StaffSymbol.thickness).

usable-duration-logs (list):

'(-3 -2 -1 0)

List of duration-logs that can be used in typesetting the grob.

voiced-position (number):

4

The staff position of a voiced Rest, negative if the rest has direction DOWN.

Y-extent (pair of numbers):

#<unpure-pure-container ly:multi-measure-rest::height >

Extent (size) in the Y direction, measured in staff-space units, relative to object’s reference point.

Y-offset (number):

#<unpure-pure-container ly:staff-symbol-referencer::callback >

The vertical amount that this object is moved relative to its Y-parent.

Note that many objects have special positioning considerations, which cause any setting of Y-offset to be ignored or modified, even though the object supports the self-alignment-interface.

This object supports the following interface(s): font-interface, grob-interface, multi-measure-interface, multi-measure-rest-interface, outside-staff-interface, rest-interface, spanner-interface and staff-symbol-referencer-interface.

This object is of class Spanner (characterized by spanner-interface).