slur-interface
A slur
User settable properties:
attachment
(pair)- Pair 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)- number representing the length of the dashes.
direction
(direction)- Up or down, left or right?
extremity-function
(procedure)- A function that calculates the
attachment of a slur-end. The function takes a slur and direction argument and returns a symbol.
extremity-offset-alist
(list)- The offset adds to the centre of
the note head, or stem.
Format: alist (attachment stem-dir*dir slur-dir*dir) -> offset.
height-limit
(dimension, in staff space)- Maximum slur height: the longer the
slur, the closer it is to this height.
ratio
(number)- Parameter for slur shape. The higher this number, the
quicker the slur attains it
height-limit
.
slope-limit
(number)- Set slope to zero if slope is running away
steeper than this.
thickness
(number)- Bar line thickness, measured in
linethickness
.
y-free
(dimension, in staff space)- The minimal vertical gap between slur and
note heads or stems.
Internal properties:
de-uglify-parameters
(list)- list of 3 real constants. They
define the valid areas for the middle control points. They are
empirical.
details
(list)- alist of parameters for detailed grob behavior.
note-columns
(pair)- list of NoteColumn grobs.
This grob interface is used in the following graphical objects: PhrasingSlur and Slur