LilyPond Internals Reference: 3.1.50 DynamicTextSpanner

### 3.1.50 `DynamicTextSpanner`

Dynamic text like ‘cresc’, usually followed by a (dashed) line. See also `DynamicLineSpanner` and `TextSpanner`.

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

Standard settings:

`before-line-breaking` (boolean):

  `dynamic-text-spanner::before-line-breaking`

  Dummy property, used to trigger a callback function.

`bound-details` (alist, with symbols as keys):

      '((right (attach-dir . -1) (padding . 0.75))
        (right-broken (attach-dir . 1) (padding . 0.0))
        (left (attach-dir . -1)
              (stencil-offset -0.75 . -0.5)
              (padding . 0.75))
        (left-broken (attach-dir . 1)))

  An alist of properties for determining attachments of spanners to edges.

`dash-fraction` (number):

  `0.2`

  Size of the dashes, relative to `dash-period`. Should be between `0.1` and `1.0` (continuous line). If set to `0.0`, a dotted line is produced

`dash-period` (number):

  `3.0`

  The length of one dash together with whitespace. If negative, no line is drawn at all.

`font-shape` (symbol):

  `'italic`

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

`font-size` (number):

  `1`

  The font size, compared to the ‘normal’ size. `0` is style-sheet’s normal size, `-1` is smaller, `+1` is bigger. Each step of 1 is approximately 12% larger; 6 steps are exactly a factor 2 larger. If the context property `fontSize` is set, its value is added to this before the glyph is printed. Fractional values are allowed.

`left-bound-info` (alist, with symbols as keys):

  `ly:horizontal-line-spanner::calc-left-bound-info-and-text`

  An alist of properties for determining attachments of spanners to edges.

`minimum-length` (dimension, in staff space):

  `2.0`

  Try to make a spanner at least this long, normally in the horizontal direction. This requires an appropriate callback for the `springs-and-rods` property. If added to a `Tie`, this sets the minimum distance between noteheads.

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

      '(-1 . 1)

  Minimum size of an object in Y dimension, measured in `staff-space` units.

`right-bound-info` (alist, with symbols as keys):

  `ly:horizontal-line-spanner::calc-right-bound-info`

  An alist of properties for determining attachments of spanners to edges.

`skyline-horizontal-padding` (number):

  `0.2`

  For determining the vertical distance between two staves, it is possible to have a configuration which would result in a tight interleaving of grobs from the top staff and the bottom staff. The larger this parameter is, the farther apart the staves are placed in such a configuration.

`springs-and-rods` (boolean):

  `ly:spanner::set-spacing-rods`

  Dummy variable for triggering spacing routines.

`stencil` (stencil):

  `ly:line-spanner::print`

  The symbol to print.

`style` (symbol):

  `'dashed-line`

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

`vertical-skylines` (pair of skylines):

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

  Two skylines, one above and one below this grob.

This object supports the following interface(s): `dynamic-interface`, `dynamic-text-spanner-interface`, `font-interface`, `grob-interface`, `horizontal-line-spanner-interface`, `line-interface`, `line-spanner-interface`, `spanner-interface` and `text-interface`.

This object is of class Spanner (characterized by `spanner-interface`).

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