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