3.1.161 VoltaBracket

A volta bracket. See also VoltaBracketSpanner.

VoltaBracket objects are created by the following engraver(s): Volta_engraver.

Standard settings:

baseline-skip (dimension, in staff space):


Distance between base lines of multiple lines of text.

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.

edge-height (pair):
'(2.0 . 2.0)

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

font-size (number):


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.

range-collapse-threshold (non-negative, exact integer):


If the length of a volta range is greater than or equal to this threshold, print it with a dash. For example, if this is 3, a \volta 1,2,3 is printed as ‘1.-3.’, but if it is 4, it is printed as ‘1.2.3.’.

shorten-pair (pair of numbers):


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.

stencil (stencil):


The symbol to print.

text (markup):


Text markup. See Formatting text.

thickness (number):


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

vertical-skylines (pair of skylines):

#<unpure-pure-container #<procedure ly:grob::vertical-skylines-from-stencil (_)> #<procedure ly:grob::pure-simple-vertical-skylines-from-extents (_ _ _)> >

Two skylines, one above and one below this grob.

volta-number-offset (pair of numbers):
'(1.0 . -0.5)

The offset of the volta number relative to the upper left corner of the volta bracket.

word-space (dimension, in staff space):


Space to insert between words in texts.

Y-extent (pair of numbers):

#<unpure-pure-container #<procedure ly:grob::stencil-height (_)> #<procedure volta-bracket-interface::pure-height (grob start end)> >

Extent (size) in the Y direction, measured in staff-space units, relative to object’s reference point.

This object supports the following interface(s): font-interface, grob-interface, horizontal-bracket-interface, line-interface, side-position-interface, spanner-interface, text-interface, volta-bracket-interface and volta-interface.

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

LilyPond Internals Reference v2.25.16 (development-branch).