3.1.98 Stem

Stem objects are created by: Stem_engraver.

Standard settings:

direction (direction):


If side-axis is 0 (or #X), then this property determines whether the object is placed #LEFT, #CENTER or #RIGHT with respect to the other object. Otherwise, it determines whether the object is placed #UP, #CENTER or #DOWN. Numerical values may also be used: #UP=1, #DOWN=-1, #LEFT=-1, #RIGHT=1, #CENTER=0.

duration-log (integer):


The 2-log of the note head duration, i.e., 0 = whole note, 1 = half note, etc.

default-direction (direction):


Direction determined by note head positions.

stem-end-position (number):


Where does the stem end (the end is opposite to the support-head)?

neutral-direction (direction):


Which direction to take in the center of the staff.

stencil (unknown):


The symbol to print.

X-extent (pair of numbers):


Hard coded extent in X direction.

Y-extent (pair of numbers):


Hard coded extent in Y direction.

length (dimension, in staff space):


User override for the stem length of unbeamed stems.

thickness (number):


Line thickness, generally measured in line-thickness.

flag (unknown):


A function returning the full flag stencil for the Stem, which is passed to the function as the only argument. The default ly:stem::calc-stencil function uses the flag-style property to determine the correct glyph for the flag. By providing your own function, you can create arbitrary flags.

beamlet-default-length (pair):

'(1.1 . 1.1)

A pair of numbers. The first number specifies the default length of a beamlet that sticks out of the left hand side of this stem; the second number specifies the default length of the beamlet to the right. The actual length of a beamlet is determined by taking either the default length or the length specified by beamlet-max-length-proportion, whichever is smaller.

beamlet-max-length-proportion (pair):

'(0.75 . 0.75)

The maximum length of a beamlet, as a proportion of the distance between two adjacent stems.

X-offset (number):


The horizontal amount that this object is moved relative to its X-parent.

Y-offset (number):


The vertical amount that this object is moved relative to its Y-parent.

This object supports the following interface(s): stem-interface, item-interface, font-interface and grob-interface.

Internals Reference