LilyPond Internals Reference: 3.1.6 AmbitusAccidental

### 3.1.6 AmbitusAccidental

AmbitusAccidental objects are created by: Ambitus_engraver.

Standard settings:

> `direction` (direction):

>   `-1`

>   If `side-axis` is `0` (or `X`), then this property determines whether the object is placed `LEFT`, `CENTER` or `RIGHT` with respect to the other object. Otherwise, it determines whether the object is placed `UP`, `CENTER` or `DOWN`. Numerical values may also be used: `UP`=`1`, `DOWN`=`-1`, `LEFT`=`-1`, `RIGHT`=`1`, `CENTER`=`0`.

> `glyph-name-alist` (list):

>       '((0 . "accidentals.natural")
>         (-1/2 . "accidentals.flat")
>         (1/2 . "accidentals.sharp")
>         (1 . "accidentals.doublesharp")
>         (-1 . "accidentals.flatflat")
>         (3/4
>          .
>          "accidentals.sharp.slashslash.stemstemstem")
>         (1/4 . "accidentals.sharp.slashslash.stem")
>         (-1/4 . "accidentals.mirroredflat")
>         (-3/4 . "accidentals.mirroredflat.flat"))

>   An alist of key-string pairs.

> `padding` (dimension, in staff space):

>   `0.5`

>   Add this much extra space between objects that are next to each other.

> `side-axis` (number):

>   `0`

>   If the value is `X` (or equivalently `0`), the object is placed horizontally next to the other object. If the value is `Y` or `1`, it is placed vertically.

> `stencil` (stencil):

>   `ly:accidental-interface::print`

>   The symbol to print.

> `X-offset` (number):

>   `ly:grob::x-parent-positioning`

>   The horizontal amount that this object is moved relative to its X-parent.

> `Y-extent` (pair of numbers):

>   `#<unpure-pure-container #<primitive-procedure ly:accidental-interface::height> >`

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

This object supports the following interface(s): accidental-interface, break-aligned-interface, font-interface, grob-interface, item-interface and side-position-interface.

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