LilyPond program-reference: 3.1.35 DynamicText

### 3.1.35 DynamicText

DynamicText objects are created by: Dynamic_engraver and New_dynamic_engraver.

Standard settings:

> `stencil` (unknown):

>   `ly:text-interface::print`

>   The symbol to print.

> `direction` (direction):

>   `ly:script-interface::calc-direction`

>   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`.

> `X-offset` (number):

>   `ly:self-alignment-interface::x-aligned-on-self`

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

> `self-alignment-X` (number):

>   `0`

>   Specify alignment of an object. The value `-1` means left aligned, `0` centered, and `1` right-aligned in X direction. Other numerical values may also be specified.

> `Y-offset` (number):

>   `ly:self-alignment-interface::y-aligned-on-self`

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

> `self-alignment-Y` (number):

>   `0`

>   Like `self-alignment-X` but for the Y axis.

> `font-series` (symbol):

>   `'bold`

>   Select the series of a font. Choices include `medium`, `bold`, `bold-narrow`, etc.

> `font-encoding` (symbol):

>   `'fetaDynamic`

>   The font encoding is the broadest category for selecting a font. Currently, only lilypond’s system fonts (Emmentaler and Aybabtu) are using this property. Available values are `fetaMusic` (Emmentaler), `fetaBraces` (Aybabtu), `fetaNumber` (Emmentaler), and `fetaDynamic` (Emmentaler).

> `font-shape` (symbol):

>   `'italic`

>   Select the shape of a font. Choices include `upright`, `italic`, `caps`.

> `extra-spacing-width` (pair of numbers):

>   `'(+inf.0 . -inf.0)`

>   In the horizontal spacing problem, we pad each item by this amount (by adding the ‘car’ on the left side of the item and adding the ‘cdr’ on the right side of the item). In order to make a grob take up no horizontal space at all, set this to `(+inf.0 . -inf.0)`.

> `outside-staff-priority` (number):

>   `250`

>   If set, the grob is positioned outside the staff in such a way as to avoid all collisions. In case of a potential collision, the grob with the smaller `outside-staff-priority` is closer to the staff.

This object supports the following interface(s): text-interface, self-alignment-interface, script-interface, item-interface, font-interface, dynamic-interface and grob-interface.

#### Internals Reference