3.1.19 Beam

Beam objects are created by: Auto_beam_engraver, Beam_engraver, Chord_tremolo_engraver and Grace_beam_engraver.

Standard settings:

gap (dimension, in staff space):


Size of a gap in a variable symbol.

positions (pair of numbers):

#<simple-closure #<simple-closure (#<procedure chain-grob-member-functions (grob value . funcs)> (#<primitive-procedure cons> 0 0) #<primitive-procedure ly:beam::calc-least-squares-positions> #<primitive-procedure ly:beam::slope-damping> #<primitive-procedure ly:beam::shift-region-to-valid> #<primitive-procedure ly:beam::quanting>) > >

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.

concaveness (number):


A beam is concave if its inner stems are closer to the beam than the two outside stems. This number is a measure of the closeness of the inner stems. It is used for damping the slope of the beam.

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.

beaming (pair):


Pair of number lists. Each number list specifies which beams to make. 0 is the central beam, 1 is the next beam toward the note, etc. This information is used to determine how to connect the beaming patterns from stem to stem inside a beam.

stencil (unknown):


The symbol to print.

clip-edges (boolean):


Allow outward pointing beamlets at the edges of beams?

thickness (number):


Line thickness, generally measured in line-thickness.

neutral-direction (direction):


Which direction to take in the center of the staff.

beamed-stem-shorten (list):

'(1.0 0.5 0.25)

How much to shorten beamed stems, when their direction is forced. It is a list, since the value is different depending on the number of flags and beams.

damping (number):


Amount of beam slope damping.

auto-knee-gap (dimension, in staff space):


If a gap is found between note heads where a horizontal beam fits that is larger than this number, make a kneed beam.

font-family (symbol):


The font family is the broadest category for selecting text fonts. Options include: sans, roman.

This object supports the following interface(s): unbreakable-spanner-interface, staff-symbol-referencer-interface, spanner-interface, font-interface, beam-interface and grob-interface.

Internals Reference