### 3.2.124 tie-interface

A horizontal curve connecting two noteheads.

#### User settable properties:

> `annotation` (string)

>   Annotate a grob for debug purposes.

> `avoid-slur` (symbol)

>   Method of handling slur collisions. Choices are `inside`, `outside`, `around`, and `ignore`. `inside` adjusts the slur if needed to keep the grob inside the slur. `outside` moves the grob vertically to the outside of the slur. `around` moves the grob vertically to the outside of the slur only if there is a collision. `ignore` does not move either. In grobs whose notational significance depends on vertical position (such as accidentals, clefs, etc.), `outside` and `around` behave like `ignore`.

> `control-points` (list)

>   List of offsets (number pairs) that form control points for the tie, slur, or bracket shape. For Béziers, this should list the control points of a third-order Bézier curve.

> `dash-definition` (pair)

>   List of `dash-elements` defining the dash structure. Each `dash-element` has a starting t value, an ending t-value, a `dash-fraction`, and a `dash-period`.

> `details` (list)

>   Alist of parameters for detailed grob behavior. More information on the allowed parameters for a grob can be found by looking at the top of the Internals Reference page for each interface having a `details` property.

> `direction` (direction)

>   If `side-axis` is `0` (or `X`), then this property determines whether the object is placed `LEFT`, `CENTER` or `RIGHT` with respect to the other object. Otherwise, it determines whether the object is placed `UP`, `CENTER` or `DOWN`. Numerical values may also be used: `UP`=`1`, `DOWN`=`-1`, `LEFT`=`-1`, `RIGHT`=`1`, `CENTER`=`0`.

> `head-direction` (direction)

>   Are the note heads left or right in a semitie?

> `line-thickness` (number)

>   The thickness of the tie or slur contour.

> `neutral-direction` (direction)

>   Which direction to take in the center of the staff.

> `staff-position` (number)

>   Vertical position, measured in half staff spaces, counted from the middle line.

> `thickness` (number)

>   Line thickness, generally measured in `line-thickness`.

This grob interface is used in the following graphical object(s): Tie.

#### Internals Reference v2.18.2 (稳定分支).