3.1.111 TextSpanner

TextSpanner objects are created by: Dynamic_engraver, New_dynamic_engraver and Text_spanner_engraver.

Standard settings:

Y-offset (number):

ly:side-position-interface::y-aligned-side

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

font-shape (symbol):

'italic

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

style (symbol):

'dashed-line

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

staff-padding (dimension, in staff space):

0.8

Maintain this much space between reference points and the staff. Its effect is to align objects of differing sizes (like the dynamics p and f) on their baselines.

dash-fraction (number):

0.2

Size of the dashes, relative to dash-period. Should be between 0.0 (no line) and 1.0 (continuous line).

dash-period (number):

3.0

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

side-axis (number):

1

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.

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.

outside-staff-priority (number):

350

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.

left-bound-info (list):

ly:line-spanner::calc-left-bound-info

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

right-bound-info (list):

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

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

bound-details (list):

'((left (Y . 0) (padding . 0.25) (attach-dir . -1)) (right (Y . 0) (padding . 0.25)))

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

stencil (unknown):

ly:line-spanner::print

The symbol to print.

This object supports the following interface(s): spanner-interface, side-position-interface, line-spanner-interface, line-interface, font-interface and grob-interface.


Internals Reference