Node:slur-interface, Next:, Previous:side-position-interface, Up:Graphical Object Interfaces



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.0 (stable-branch).

Report errors to <bug-lilypond@gnu.org>.