| [ << Backend ] | [Top][Contents][Index][ ? ] | [ Scheme functions >> ] | ||
| [ < BassFigureLine ] | [ Up : All layout objects ] | [ BendAfter > ] | ||
3.1.19 Beam
Beam objects are created by: Auto_beam_engraver, Beam_engraver, Chord_tremolo_engraver and Grace_beam_engraver.
Standard settings:
auto-knee-gap(dimension, in staff space):
5.5If a gap is found between note heads where a horizontal beam fits that is larger than this number, make a kneed beam.
beam-thickness(dimension, in staff space):
0.48Beam thickness, measured in
staff-spaceunits.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.
beaming(pair):
ly:beam::calc-beamingPair of number lists. Each number list specifies which beams to make.
0is the central beam,1is 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.clip-edges(boolean):
#tAllow outward pointing beamlets at the edges of beams?
collision-interfaces(list):
'(beam-interface clef-interface inline-accidental-interface key-signature-interface note-head-interface stem-interface time-signature-interface)A list of interfaces for which automatic beam-collision resolution is run.
concaveness(number):
ly:beam::calc-concavenessA 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.
damping(number):
1Amount of beam slope damping.
details(list):
'((secondary-beam-demerit . 10) (stem-length-demerit-factor . 5) (region-size . 2) (beam-eps . 0.001) (stem-length-limit-penalty . 5000) (damping-direction-penalty . 800) (hint-direction-penalty . 20) (musical-direction-factor . 400) (ideal-slope-factor . 10) (collision-penalty . 500) (collision-padding . 0.35) (round-to-zero-slope . 0.02))Alist of parameters for detailed grob behavior. More information on the allowed parameters for a grob can be found by looking at the top of the Internals Reference page for each interface having a
detailsproperty.direction(direction):
ly:beam::calc-directionIf
side-axisis0(or#X), then this property determines whether the object is placed#LEFT,#CENTERor#RIGHTwith respect to the other object. Otherwise, it determines whether the object is placed#UP,#CENTERor#DOWN. Numerical values may also be used:#UP=1,#DOWN=-1,#LEFT=-1,#RIGHT=1,#CENTER=0.font-family(symbol):
'romanThe font family is the broadest category for selecting text fonts. Options include:
sans,roman.gap(dimension, in staff space):
0.8Size of a gap in a variable symbol.
neutral-direction(direction):
-1Which direction to take in the center of the staff.
normalized-endpoints(pair):
ly:spanner::calc-normalized-endpointsRepresents left and right placement over the total spanner, where the width of the spanner is normalized between 0 and 1.
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 instaff-spaceunits of the current staff. For slurs, this value selects which slur candidate to use; if extreme positions are requested, the closest one is taken.stencil(stencil):
ly:beam::printThe symbol to print.
This object supports the following interface(s): beam-interface, font-interface, grob-interface, spanner-interface, staff-symbol-referencer-interface and unbreakable-spanner-interface.
| [ << Backend ] | [Top][Contents][Index][ ? ] | [ Scheme functions >> ] | ||
| [ < BassFigureLine ] | [ Up : All layout objects ] | [ BendAfter > ] | ||