LilyPond Internals Reference: 3.1.49 DynamicText

### 3.1.49 `DynamicText`

A dynamic text item like ‘ff’ or ‘mp’. See also `DynamicLineSpanner`.

`DynamicText` objects are created by: `Dynamic_engraver`.

Standard settings:

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

`parent-alignment-X` (number):

  `0`

  Specify on which point of the parent the object is aligned. The value `-1` means aligned on parent’s left edge, `0` on center, and `1` right edge, in X direction. Other numerical values may also be specified - the unit is half the parent’s width. If unset, the value from `self-alignment-X` property will be used.

`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 - the unit is half the object width.

`stencil` (stencil):

  `ly:text-interface::print`

  The symbol to print.

`vertical-skylines` (pair of skylines):

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

  Two skylines, one above and one below this grob.

`X-align-on-main-noteheads` (boolean):

  `#t`

  If true, this grob will ignore suspended noteheads when aligning itself on NoteColumn.

`X-offset` (number):

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

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

`Y-extent` (pair of numbers):

  `#<unpure-pure-container #<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 5b68c690d7a0 at /build/out/share/lilypond/current/scm/lily/output-lib.scm:1106:3 (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`, `outside-staff-interface`, `script-interface`, `self-alignment-interface` and `text-interface`.

This object is of class Item (characterized by `item-interface`).

#### LilyPond – Internals Reference v2.24.4 (stable-branch).