LilyPond program-reference: 3.1.119 TupletBracket

### 3.1.119 TupletBracket

TupletBracket objects are created by: Tuplet_engraver.

Standard settings:

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

>   `1.1`

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

> `thickness` (number):

>   `1.6`

>   Line thickness, generally measured in `line-thickness`.

> `edge-height` (pair):

>   `'(0.7 . 0.7)`

>   A pair of numbers specifying the heights of the vertical edges: `(left-height . right-height)`.

> `shorten-pair` (pair of numbers):

>   `'(-0.2 . -0.2)`

>   The lengths to shorten a text-spanner on both sides, for example a pedal bracket. Positive values shorten the text-spanner, while negative values lengthen it.

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

>   `0.25`

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

> `full-length-to-extent` (boolean):

>   `#t`

>   Run to the extent of the column for a full-length tuplet bracket.

> `direction` (direction):

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

> `positions` (pair of numbers):

>   `ly:tuplet-bracket::calc-positions`

>   Pair of staff coordinates `(left . right)`, where both left and right are in `staff-space` units of the current staff. For slurs, this value selects which slur candidate to use; if extreme positions are requested, the closest one is taken.

> `connect-to-neighbor` (pair):

>   `ly:tuplet-bracket::calc-connect-to-neighbors`

>   Pair of booleans, indicating whether this grob looks as a continued break.

> `control-points` (list):

>   `ly:tuplet-bracket::calc-control-points`

>   List of offsets (number pairs) that form control points for the tie, slur, or bracket shape. For Béziers, this should list the control points of a third-order Bézier curve.

> `stencil` (unknown):

>   `ly:tuplet-bracket::print`

>   The symbol to print.

This object supports the following interface(s): tuplet-bracket-interface, spanner-interface, line-interface and grob-interface.

#### Internals Reference