beam-interface
A beam.
The thickness
property is the weight of beams, and is measured in staffspace
User settable properties:
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.
beamed-stem-shorten
(list)- How much to shorten beamed stems,
when their direction is forced. It is a list, since the value is different
depending on the number flags/beams.
concaveness-gap
(dimension, in staff space)- A beam is printed horizontally
if its concaveness-gap is larger than this value. The concaveness-gap
is the distance of an inner note head to the line between two outer
note heads.
concaveness-threshold
(number)- A beam is printed horizontally
if its concaveness is bigger than this threshold.
Concaveness is calculated as the sum of the vertical distances of
inner note heads that fall outside the interval of the two outer
note heads, to the vertically nearest outer note head, divided by the
square of the inner notes involved.
damping
(integer)- Amount of beam slope damping. 0: no, 1: yes,
100000: horizontal beams.
dir-function
(procedure)- The function to determine the
direction of a beam. Choices include:
beam-dir-majority
- number count of up or down notes
beam-dir-mean
- mean center distance of all notes
beam-dir-median.
- mean center distance weighted per note
flag-width-function
(procedure)- Procedure that computes the width of a half-beam (a non-connecting beam.).
gap
(dimension, in staff space)- Size of a gap in a variable symbol.
gap-count
(integer)- Number of gapped beams for tremolo.
knee
(boolean)- Is this beam kneed?
neutral-direction
(direction)- Which direction to take in the
center of the staff.
positions
(pair)- Pair of staff coordinates
(
left
.
right)
, where both left and right are in the
staff-space unit of the current staff.
space-function
(procedure)- Calculate the vertical space between
two beams. This function takes a beam grob and the maximum number of
beams.
thickness
(number)- Bar line thickness, measured in
linethickness
.
Internal properties:
chord-tremolo
(boolean)- if set, this beam is a tremolo.
least-squares-dy
(number)- ideal beam slope, without damping.
position-callbacks
(list)- list of
functions set spanner positions.
positioning-done
(boolean)- Used to signal that a positioning element
did its job. This ensures that a positioning is only done once.
quant-score
(number)- Beam quanting score – can be stored for
debugging
shorten
(dimension, in staff space)- The amount of space that a
stem. Internally used to distribute beam shortening over stems.
This grob interface is used in the following graphical objects: Beam