|
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
|
Go back to index of LilyPond.
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.
|