[ << Backend ]	[Top][Contents][Index]	[ Scheme functions >> ]
[ < TextSpanner ]	[ Up : All layout objects ]	[ TieColumn > ]

---

3.1.145 Tie

A tie. See also TieColumn, LaissezVibrerTie, and RepeatTie.

Tie objects are created by the following engraver(s): Completion_heads_engraver and Tie_engraver.

Standard settings:

avoid-slur (symbol):

'inside

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 of number pairs):

ly:tie::calc-control-points

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.

details (alist, with symbols as keys):

'((between-length-limit . 1.0)
  (center-staff-line-clearance . 0.6)
  (dot-collision-clearance . 0.25)
  (dot-collision-penalty . 0.25)
  (height-limit . 1.0)
  (horizontal-distance-penalty-factor . 10)
  (intra-space-threshold . 1.25)
  (min-length . 1.0)
  (min-length-penalty-factor . 26)
  (multi-tie-region-size . 3)
  (note-head-gap . 0.2)
  (outer-tie-length-symmetry-penalty-factor . 10)
  (outer-tie-vertical-distance-symmetry-penalty-factor
    .
    10)
  (outer-tie-vertical-gap . 0.25)
  (ratio . 0.333)
  (same-dir-as-stem-penalty . 8)
  (single-tie-region-size . 4)
  (skyline-padding . 0.05)
  (staff-line-collision-penalty . 5)
  (stem-gap . 0.35)
  (tie-column-monotonicity-penalty . 100)
  (tie-tie-collision-distance . 0.45)
  (tie-tie-collision-penalty . 25.0)
  (tip-staff-line-clearance . 0.45)
  (vertical-distance-penalty-factor . 7)
  (wrong-direction-offset-penalty . 10))

An alist of parameters for detailed grob behavior. See All layout objects for more information on the available parameters and their default values of a particular grob’s details property. See Graphical Object Interfaces for documentation of the available parameters. Supporting interfaces can be found at the bottom of a grob’s description section.

direction (direction):

ly:tie::calc-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.

font-size (number):

-6

The font size, compared to the ‘normal’ size. 0 is style-sheet’s normal size, -1 is smaller, +1 is bigger. Each step of 1 is approximately 12% larger; 6 steps are exactly a factor 2 larger. If the context property fontSize is set, its value is added to this before the glyph is printed. Fractional values are allowed.

line-thickness (number):

0.8

For slurs and ties, this is the diameter of the virtual “pen” that draws the two arcs of the curve’s outline, which intersect at the endpoints. This property is expressed as a multiple of the current staff-line thickness (i.e., the visual output is influenced by changes to Staff.StaffSymbol.thickness).

neutral-direction (direction):

1

Which direction to take in the center of the staff.

springs-and-rods (boolean):

ly:spanner::set-spacing-rods

Dummy variable for triggering spacing routines.

stencil (stencil):

ly:tie::print

The symbol to print.

thickness (number):

1.2

For grobs made up of lines, this is the thickness of the line. For slurs and ties, this is the distance between the two arcs of the curve’s outline at its thickest point, not counting the diameter of the virtual “pen” that draws the arcs. This property is expressed as a multiple of the current staff-line thickness (i.e., the visual output is influenced by changes to Staff.StaffSymbol.thickness).

vertical-skylines (pair of skylines):

#<unpure-pure-container #<procedure ly:grob::vertical-skylines-from-stencil (_)> #<procedure ly:grob::pure-simple-vertical-skylines-from-extents (_ _ _)> >

Two skylines, one above and one below this grob.

This object supports the following interface(s): bezier-curve-interface, grob-interface, spanner-interface and tie-interface.

This object is of class Spanner (characterized by spanner-interface).