GNU LilyPond

-- --

slur-interface

A slur

attachment (pair):

cons of symbols indicating how a slur should be attached at the ends. The format is '(LEFT-TYPE . RIGHT-TYPE), where both TYPEs are symbols. The values of these symbols may be alongside-stem, stem, head or loose-end. Default value: (unset)

attachment-offset (pair):

cons of offsets, '(LEFT-offset . RIGHT-offset). This offset is added to the attachments to prevent ugly slurs. [fixme: we need more documentation here]. . Default value: (unset)

beautiful (number):

number that dictates when a slur should be de-uglyfied. It correlates with the enclosed area between noteheads and slurs. A value of 0.1 yields only undisturbed slurs, a value of 5 will tolerate quite high blown slurs. Default value: (unset)

control-points (list):

List of 4 offsets (number-pairs) that form control points for the tie/slur shape. Default value: (unset)

dashed (number):

[FIXME: use dash-period/dash length; see text-spanner] number representing the length of the dashes. Default value: (unset)

de-uglify-parameters (list):

list of 3 real constants. They define the valid areas for the middle control points. Used in de_uglyfy. They are a bit empirical. Default value: (unset)

details (list):

alist of parameters for detailed grob behavior. Default value: (unset)

direction (direction):

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

extremity-offset-alist (list):

an alist (attachment stem-dir*dir slur-dir*dir) -> offset. The offset adds to the centre of the notehead, or stem. Default value: (unset)

extremity-rules (list):

an alist (procedure slur dir) -> attachment to determine the attachment (see above). If procedure returns #t, attachment is used. Otherwise, the next procedure is tried. Default value: (unset)

height-limit (number):

Maximum slur height, long slurs approach this height.

For small width w, the height should be proportional to w, for w -> infinity, the height should rise to limit h_infinity asymptotically.

Hence we take F (x) such that

                 F (0) = 0 , F' (0) = 1, and F (infinity) = 1
               

where

                 h = height-limit * F (x * ratio / height-limit)
               

Currently, for F we use

                 F (x) = 2/pi * atan (pi * x/2)
               

Default value: (unset)

ratio (number):

Slur parameter. See height-limit. Default value: (unset)

slope-limit (number):

set slope to zero if slope is running away steeper than this. Default value: (unset)

thickness (number):

thickness, measured in stafflinethickness. Default value: (unset)

y-free (number):

minimal vertical gap between slur and noteheads or stems. Default value: (unset)

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

Please send comments on these web pages to (address unknown)

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

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