#### Slur

Slur objects are created by: Slur_engraver

Standard settings:

`print-function` (procedure):
  `Slur::print`

  Function taking grob as argument, returning a `Stencil` object.

`thickness` (number):
  `1.2`

  Bar line thickness, measured in `linethickness`.

`spacing-procedure` (procedure):
  `Spanner::set_spacing_rods`

  Procedure for calculating spacing parameters. The routine is called after `before-line-breaking-callback`.

`minimum-length` (dimension, in staff space):
  `1.5`

  Try to make a spanner at least this long. This requires an appropriate routine for the `spacing-procedure` property.

`extremity-function` (procedure):
  `calc-slur-extremity`

  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):
  `'(((head 1 1) -0.25 . 0.75) ((head 1 -1) -0.25 . 0.75) ((head -1 1) -0.25 . 0.75) ((head -1 -1) -0.85 . 0.75) ((stem 1 1) -0.125 . 0.5) ((stem -1 -1) -0.125 . 0.5) ((loose-end 1 1) -0.4 . 0) ((loose-end 1 -1) -0.4 . 0) ((loose-end -1 -1) -4 . 0) ((loose-end -1 1) -4 . 0))`

  The offset adds to the centre of the note head, or stem.

  Format: alist (attachment stem-dir*dir slur-dir*dir) -> offset.

`Y-extent-callback` (procedure):
  `Slur::height`

  see `X-extent-callback`.

`height-limit` (dimension, in staff space):
  `2.0`

  Maximum slur height: the longer the slur, the closer it is to this height.

`ratio` (number):
  `0.333`

  Parameter for slur shape. The higher this number, the quicker the slur attains it `height-limit`.

`beautiful` (number):
  `0.5`

  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.

`y-free` (dimension, in staff space):
  `0.75`

  The minimal vertical gap between slur and note heads or stems.

`attachment` (pair):
  `'(#f . #f)`

  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):
  `'((0 . 0) 0 . 0)`

  cons of offsets, '(left-offset . right-offset). This offset is added to the attachments to prevent ugly slurs. [fixme: we need more documentation here].

`slope-limit` (number):
  `0.8`

  Set slope to zero if slope is running away steeper than this.

This object supports the following interfaces: spanner-interface, slur-interface and grob-interface

Read comments on this page, or add one. This page is for LilyPond-2.2.5 (stable-branch).