3.1.54 LigatureBracket

LigatureBracket objects are created by: Ligature_bracket_engraver.

Standard settings:

padding (dimension, in staff space):


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

thickness (number):


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.

direction (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):


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.

stencil (unknown):


The symbol to print.

staff-padding (dimension, in staff space):


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.

connect-to-neighbor (pair):


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

control-points (list):


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.

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

Internals Reference