LilyPond Internals Reference: 3.1.31 Custos

### 3.1.31 Custos

Custos objects are created by: Custos_engraver.

Standard settings:

> `break-align-symbol` (symbol):

>   `'custos`

>   This key is used for aligning and spacing breakable items.

> `break-visibility` (vector):

>   `#(#t #f #f)`

>   A vector of 3 booleans, `#(end-of-line unbroken begin-of-line)`. `#t` means visible, `#f` means killed.

> `neutral-direction` (direction):

>   `-1`

>   Which direction to take in the center of the staff.

> `non-musical` (boolean):

>   `#t`

>   True if the grob belongs to a `NonMusicalPaperColumn`.

> `space-alist` (list):

>   `'((first-note minimum-fixed-space . 0.0) (right-edge extra-space . 0.1))`

>   A table that specifies distances between prefatory items, like clef and time-signature. The format is an alist of spacing tuples: `(break-align-symbol type . distance)`, where type can be the symbols `minimum-space` or `extra-space`.

> `stencil` (stencil):

>   `ly:custos::print`

>   The symbol to print.

> `style` (symbol):

>   `'vaticana`

>   This setting determines in what style a grob is typeset. Valid choices depend on the `stencil` callback reading this property.

> `Y-offset` (number):

>   `ly:staff-symbol-referencer::callback`

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

This object supports the following interface(s): break-aligned-interface, custos-interface, font-interface, grob-interface, item-interface and staff-symbol-referencer-interface.

#### Internals Reference