Beam - LilyPond program-reference
Description: LilyPond program-reference

Next: BreakAlignGroup, Previous: BassFigureLine, Up: All layout objects

#### 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):
  `0.8`

  Size of a gap in a variable symbol.

`positions` (pair):
  `#<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 the staff-space unit of the current staff.

`concaveness` (number):
  `ly:beam::calc-concaveness`

  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.

`direction` (direction):
  `ly:beam::calc-direction`

  #UP or #DOWN, #LEFT or #RIGHT? (or a numerical value, #UP=1, #DOWN=-1, #LEFT=-1, #RIGHT=1, CENTER=0)

`beaming` (pair):
  `ly:beam::calc-beaming`

  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.

`thickness` (number):
  `0.48`

  Bar line thickness, measured in `line-thickness`.

`neutral-direction` (direction):
  `-1`

  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 flags/beams.

`damping` (number):
  `1`

  Amount of beam slope damping. 0: no, 1: yes, 100000: horizontal beams.

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

  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):
  `'roman`

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

This object supports the following interfaces: beam-interface, staff-symbol-referencer-interface, spanner-interface and grob-interface

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

Other languages: English.
Using automatic language selection.