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.

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]. .

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.

control-points (list)

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

dashed (number)

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

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.

details (list)

alist of parameters for detailed grob behavior.

direction (direction)

up or down, left or right?.

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.

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.

height-limit (dimension, in staff space)

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)
               

ratio (number)

Slur parameter. See height-limit.

slope-limit (number)

set slope to zero if slope is running away steeper than this.

thickness (number)

thickness, measured in stafflinethickness.

y-free (dimension, in staff space)

minimal vertical gap between slur and noteheads or stems.

This grob interface is used in the following graphical objects: Slur and PhrasingSlur

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