LilyPond Internals Reference: 3.1.98 Rest

### 3.1.98 Rest

Rest objects are created by: 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 #<primitive-procedure ly:grob::vertical-skylines-from-stencil> #<primitive-procedure 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 #<primitive-procedure ly:rest::height> #<primitive-procedure 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 #<primitive-procedure ly:rest::y-offset-callback> >`

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

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.

#### Internals Reference v2.22.2 (stable-branch).