### 3.1.39 DynamicText

DynamicText objects are created by: Dynamic_engraver.

Standard settings:

> `collision-bias` (number):

>   `-2.0`

>   Number determining how much to favor the left (negative) or right (positive). Larger absolute values in either direction will push a collision in this direction.

> `collision-padding` (number):

>   `0.5`

>   Amount of padding to apply after a collision is detected via the self-alignment-interface.

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

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

> `font-encoding` (symbol):

>   `'fetaText`

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

> `font-series` (symbol):

>   `'bold`

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

> `font-shape` (symbol):

>   `'italic`

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

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

>   `0.5`

>   Space to insert on the right side of an object (e.g., between note and its accidentals).

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

> `stencil` (stencil):

>   `ly:text-interface::print`

>   The symbol to print.

> `vertical-skylines` (pair of skylines):

>   `#<unpure-pure-container #<primitive-procedure ly:grob::vertical-skylines-from-stencil> >`

>   Two skylines, one above and one below this grob.

> `X-offset` (number):

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

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

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

>   `#<unpure-pure-container #<primitive-procedure ly:grob::stencil-height> >`

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

> `Y-offset` (number):

>   `#<unpure-pure-container #<procedure #f (grob)> >`

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

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

#### Internals Reference v2.18.2 (稳定分支).