### 3.1.63 LigatureBracket

LigatureBracket objects are created by: Ligature_bracket_engraver.

Standard settings:

> `bracket-visibility` (boolean or symbol):

>   `#t`

>   This controls the visibility of the tuplet bracket. Setting it to false prevents printing of the bracket. Setting the property to `if-no-beam` makes it print only if there is no beam associated with this tuplet bracket.

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

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

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

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

> `edge-height` (pair):

>   `'(0.7 . 0.7)`

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

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

>   `2.0`

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

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

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

> `stencil` (stencil):

>   `ly:tuplet-bracket::print`

>   The symbol to print.

> `thickness` (number):

>   `1.6`

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

> `X-positions` (pair of numbers):

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

>   Pair of X staff coordinates of a spanner in the form `(left . right)`, where both left and right are in `staff-space` units of the current staff.

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

#### Internals Reference v2.18.2 (稳定分支).