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



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

Read comments on this page, or add one.

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

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