LilyPond Internals Reference: 3.1.76 LigatureBracket

### 3.1.76 `LigatureBracket`

A horizontal bracket over a group of notes, usually indicating an ancient ligature if transcribed into modern notation. See also `KievanLigature`, `MensuralLigature`, and `VaticanaLigature`.

`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 `(start . end)`, where start and end are vertical positions 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 on both sides a hairpin or text-spanner such as a pedal bracket. Positive values shorten the hairpin or 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`

  For grobs made up of lines, this is the thickness of the line. For slurs and ties, this is the distance between the two arcs of the curve’s outline at its thickest point, not counting the diameter of the virtual “pen” that draws the arcs. This property is expressed as a multiple of the current staff-line thickness (i.e., the visual output is influenced by changes to `Staff.StaffSymbol.thickness`).

`tuplet-slur` (boolean):

  `#f`

  Draw a slur instead of a bracket for tuplets.

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

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

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