Next: , Previous: bass-figure-interface, Up: Graphical Object Interfaces



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 (number)
A beam is concave when 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.
damping (number)
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.
inspect-quants (pair of numbers)
If debugging is set, set beam quant to this position, and print the respective scores.
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 (string)
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

This page is for LilyPond-2.6.3 (stable-branch).

Report errors to <bug-lilypond@gnu.org>.

Other languages: English.
Using automatic language selection.