[ << Backend ]	[Top][Contents][Index]	[ Scheme functions >> ]
[ < RepeatTieColumn ]	[ Up: All layout objects ]	[ RestCollision > ]

---

3.1.110 Rest

An ordinary rest. See also MultiMeasureRest.

Rest objects are created by the following engraver(s): Completion_rest_engraver and Rest_engraver.

Standard settings:

duration-log (integer):

stem::calc-duration-log

The 2-log of the note head duration, i.e., 0 = whole note, 1 = half note, etc.

minimum-distance (dimension, in staff space):

0.25

Minimum distance between rest and notes or beam.

parenthesis-friends (list):

'(dot)

A list of Grob types, as symbols. When parentheses enclose a Grob that has ’parenthesis-friends, the parentheses widen to include any child Grobs with type among ’parenthesis-friends.

stencil (stencil):

ly:rest::print

The symbol to print.

vertical-skylines (pair of skylines):

#<unpure-pure-container ly:grob::vertical-skylines-from-stencil ly:grob::pure-simple-vertical-skylines-from-extents >

Two skylines, one above and one below this grob.

voiced-position (number):

4

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

X-extent (pair of numbers):

ly:rest::width

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

Y-extent (pair of numbers):

#<unpure-pure-container ly:rest::height ly:rest::pure-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:rest::y-offset-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, item-interface, rest-interface, rhythmic-grob-interface, rhythmic-head-interface and staff-symbol-referencer-interface.

This object is of class Item (characterized by item-interface).