GNU LilyPond

Welcome to the home of the GNU Music Typesetter

Node:Stem, Next:StemTremolo, Previous:SostenutoPedal, Up:LilyPond backend

Stem

Stem grobs are created by: Stem_engraver

font-interface

Any symbol that is typeset through fixed sets of glyphs (ie. fonts)

font-style (symbol):

a precooked set of font definitions, eg. finger volta timesig mark script large Large dynamic. Default value: (unset)

font-series (symbol):

partial font definition: medium, bold. Default value: (unset)

font-shape (symbol):

partial font definition: upright or italic. Default value: (unset)

font-family (symbol):

partial font definition: music roman braces dynamic math ... Default value: (unset)

font-name (symbol):

partial font definition: base name of font file FIXME: should override other partials. Default value: (unset)

font-design-size (number):

partial font definition: exact font size in points FIXME: should override font-relative-size. Default value: (unset)

font-relative-size (number):

partial font definition: the relative size compared the `normal' size. 0 is style-sheet's normal size, -1 is smaller, +1 is bigger, -1 is smaller. Default value: (unset)

stem-interface

A stem

thickness (number):

thickness, measured in stafflinethickness. Default value: 0.8

beamed-lengths (list):

list of stem lengths given beam multiplicity . Default value: '(0.0 2.5 2.0 1.5)

beamed-minimum-lengths (list):

list of minimum stem lengths given beam multiplicity. Default value: '(0.0 1.5 1.25 1.0)

lengths (list):

Stem length given multiplicity of flag. Default value: '(3.5 3.5 3.5 4.5 5.0)

beam (grob (GRaphical OBject)):

pointer to the beam, if applicable. Default value: (unset)

stem-shorten (list):

shorten stems in forced directions given flag multiplicity. Default value: '(0.5)

duration-log (integer):

2-log of the notehead duration, i.e. 0=whole note, 1 = half note, etc. Default value: (unset)

beaming (pair of numbers):

number of beams extending to left and right. Default value: (unset)

neutral-direction (direction):

Where to go if we're in the middle of the staff. Default value: -1

stem-end-position (number):

Where does the stem end (the end is opposite to the support-head. Default value: (unset)

support-head (grob (GRaphical OBject)):

the note head at one end of the stem. Default value: (unset)

heads (pair):

list of note heads,

FIXME: in Tie this is a pair of grob pointers, pointing to the two heads of the tie.

. Default value: (unset)

direction (direction):

up or down, left or right?. Default value: (unset)

length (number):

Stem length for unbeamed stems, only for user override. Default value: (unset)

style (symbol):

a string determining what style of glyph is typeset. Valid choices depend on the function that is reading this property. . Default value: (unset)

flag-style (string):

style for flag (hook of a stem). Default value: (unset)

dir-forced (boolean):

set if direction has been forced; read by Beam. Default value: (unset)

general-grob-interface

All grobs support this

X-offset-callbacks (list):

list of functions, each taking an grob and axis argument. The function determine the position relative to this grob's parent. The last one in the list is called first. Default value: '(#<primitive-procedure Stem::off_callback>)

Y-offset-callbacks (list):

see X-offset-callbacks. Default value: (unset)

X-extent-callback (procedure):

procedure taking an grob and axis argument, returning a number-pair. The return value is the extent of the grob. Default value: #<primitive-procedure Stem::dim_callback>

Y-extent-callback (procedure):

see X-extent-callback. Default value: #<primitive-procedure Stem::height>

molecule-callback (procedure):

Function taking grob as argument, returning a Scheme encoded Molecule. Default value: #<primitive-procedure Stem::brew_molecule>

font-relative-size (number):

partial font definition: the relative size compared the `normal' size. 0 is style-sheet's normal size, -1 is smaller, +1 is bigger, -1 is smaller. Default value: (unset)

extra-offset (pair of numbers):

pair of reals (a cons) forcing an extra offset before outputting. extra-offset is added just before `printing' the grob, so the typesetting engine is completely oblivious to it.

Default value: (unset)

interfaces (list):

list of symbols indicating the interfaces supported by this object. Is initialized from the meta field. Default value: (unset)

dependencies (list):

list of score-grob pointers that indicate who to compute first for certain global passes. Default value: (unset)

no-spacing-rods (boolean):

read from grobs: boolean that makes Separation_item ignore this item (MOVE ME TO ITEM). Default value: (unset)

extra-extent-X (pair of numbers):

enlarge in X dimension by this much, measured in staff space. Default value: (unset)

extra-extent-Y (pair of numbers):

see extra-extent-Y. Default value: (unset)

minimum-extent-X (pair of numbers):

minimum size in X dimension, measured in staff space. Default value: (unset)

minimum-extent-Y (pair of numbers):

see minimum-extent-Y. Default value: (unset)

origin (input location):

location in input file of the definition. Default value: (unset)

transparent (boolean):

This is almost the same as setting molecule-callback to #f, but this retains the dimensions of this grob, which means that you can erase grobs individually. . Default value: (unset)

Please send GNU LilyPond questions and comments to lilypond-user@gnu.org.

Please send comments on these web pages to lilypond@packages.debian.org

Copyright (c) 1997--2001 Han-Wen Nienhuys and Jan Nieuwenhuizen.

Verbatim copying and distribution of this entire article is permitted in any medium, provided this notice is preserved.