#### 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

Read comments on this page, or add one. This page is for LilyPond-2.2.5 (stable-branch).