LilyPond Internals Reference: 3.1.132 StringNumber

### 3.1.132 `StringNumber`

A markup (by default a digit in a circle) to name a string.

`StringNumber` objects are created by: `New_fingering_engraver`.

Standard settings:

`add-stem-support` (boolean):

  `only-if-beamed`

  If set, the `Stem` object is included in this script’s support.

`avoid-slur` (symbol):

  `'around`

  Method of handling slur collisions. Choices are `inside`, `outside`, `around`, and `ignore`. `inside` adjusts the slur if needed to keep the grob inside the slur. `outside` moves the grob vertically to the outside of the slur. `around` moves the grob vertically to the outside of the slur only if there is a collision. `ignore` does not move either. In grobs whose notational significance depends on vertical position (such as accidentals, clefs, etc.), `outside` and `around` behave like `ignore`.

`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-features` (list):

      '("cv47")

  Opentype features.

`font-size` (number):

  `-5`

  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.

`number-type` (symbol):

  `'arabic`

  Numbering style. Choices include `arabic`, `roman-ij-lower`, `roman-ij-upper`, `roman-lower`, and `roman-upper`.

`padding` (dimension, in staff space):

  `0.5`

  Add this much extra space between objects that are next to each other.

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

`script-priority` (number):

  `100`

  A key for determining the order of scripts in a stack, by being added to the position of the script in the user input, the sum being the overall priority. Smaller means closer to the head.

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

`self-alignment-Y` (number):

  `0`

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

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

  `0.5`

  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.

`stencil` (stencil):

  `print-circled-text-callback`

  The symbol to print.

`text` (markup):

  `string-number::calc-text`

  Text markup. See Formatting text.

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

This object supports the following interface(s): `font-interface`, `grob-interface`, `item-interface`, `number-interface`, `outside-staff-interface`, `self-alignment-interface`, `side-position-interface`, `string-number-interface`, `text-interface` and `text-script-interface`.

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

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