LilyPond Internals Reference: 3.1.154 TupletNumber

### 3.1.154 `TupletNumber`

A tuplet number. See also `TupletBracket`.

`TupletNumber` objects are created by: `Tuplet_engraver`.

Standard settings:

`avoid-slur` (symbol):

  `'inside`

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

`direction` (direction):

  `tuplet-number::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`.

`font-shape` (symbol):

  `'italic`

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

`font-size` (number):

  `-2`

  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.

`knee-to-beam` (boolean):

  `#t`

  Determines whether a tuplet number will be positioned next to a kneed beam.

`stencil` (stencil):

  `ly:tuplet-number::print`

  The symbol to print.

`text` (markup):

  `tuplet-number::calc-denominator-text`

  Text markup. See Formatting text.

`X-offset` (number):

  `ly:tuplet-number::calc-x-offset`

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

`Y-offset` (number):

  `ly:tuplet-number::calc-y-offset`

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

This object supports the following interface(s): `font-interface`, `grob-interface`, `outside-staff-interface`, `spanner-interface`, `text-interface` and `tuplet-number-interface`.

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

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