[ << Backend ][Top][Contents][Index][ Scheme functions >> ]
[][ Up : Graphical Object Interfaces ][]

3.2.156 tie-interface

A tie – a horizontal curve connecting two noteheads.

The following properties may be set in the details list.

between-length-limit

This detail is currently unused.

center-staff-line-clearance

If the center of the tie is closer to a staff line than this amount, an increasingly large staff line collision penalty is incurred.

dot-collision-clearance

If the tie comes closer to a dot than this amount, an increasingly large dot collision penalty is incurred.

dot-collision-penalty

Demerit factor for ties which come close to dots.

height-limit

The maximum height allowed for this tie.

horizontal-distance-penalty-factor

Demerit factor for ties in the set being considered which are horizontally distant from the note heads.

intra-space-threshold

If the tie’s height (in half staff-spaces) is less than this it is positioned between two adjacent staff lines; otherwise it is positioned to straddle a staff line further from the note heads.

min-length

If the tie is shorter than this amount (in staff-spaces) an increasingly large length penalty is incurred.

min-length-penalty-factor

Demerit factor for tie lengths shorter than min-length.

multi-tie-region-size

The number of variations that are tried for the extremal ties in a chord. Variations differ in their initial vertical position by half a staff-space.

note-head-gap

The distance (in staff-spaces) by which the ends of the tie are offset horizontally from the center line through the note head.

outer-tie-length-symmetry-penalty-factor

Demerit factor for ties horizontally positioned unsymmetrically with respect to the two note heads.

outer-tie-vertical-distance-symmetry-penalty-factor

Demerit factor for ties vertically positioned unsymmetrically with respect to the two note heads.

outer-tie-vertical-gap

Amount (in half staff-spaces) by which a tie is moved away from the note heads if it is closer to either of them than 0.25 half staff-spaces.

ratio

Parameter for tie shape. The higher this number, the quicker the slur attains its height limit.

same-dir-as-stem-penalty

Demerit if tie is on the same side as a stem or on the opposite side to the one specified.

single-tie-region-size

The number of candidate ties to generate when only a single tie is required. Successive candidates differ in their initial vertical position by half a staff-space.

skyline-padding

Padding of the skylines around note heads in chords.

staff-line-collision-penalty

Demerit factor for ties whose tips or center come close to staff lines.

stem-gap

The distance (in staff-spaces) by which the ends of the tie are offset horizontally from a stem which is on the same side of the note head as the tie.

tie-column-monotonicity-penalty

Demerit if the Y-position of this tie in the set of ties being considered is less than the Y-position of the previous tie.

tie-tie-collision-distance

If this tie is closer than this amount to the previous tie in the set being considered, an increasingly large tie-tie collision penalty is incurred.

tie-tie-collision-penalty

Demerit factor for a tie in the set being considered which is close to the previous one.

tip-staff-line-clearance

If the tips of the tie are closer to a staff line than this amount, an increasingly large staff-line collision penalty is incurred.

vertical-distance-penalty-factor

Demerit factor for ties in the set being considered which are vertically distant from the note heads.

wrong-direction-offset-penalty

Demerit for ties that are offset in the wrong direction.

User settable properties:

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

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 (alist, with symbols as keys)

An alist of parameters for detailed grob behavior. See section All layout objects for more information on the available parameters and their default values of a particular grob’s details property. See section 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)

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)

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)

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.

For ties, there is a distinction between exact and inexact values: an exact value serves as a rough vertical offset that gets further tuned to make the tie avoid staff lines. An inexact value is taken as the precise vertical offset without further adjustments.

thickness (number)

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).

Internal properties:

annotation (string)

Annotate a grob for debug purposes.

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

[ << Backend ][Top][Contents][Index][ Scheme functions >> ]
[][ Up : Graphical Object Interfaces ][]

<< Back to Documentation Index

LilyPond Internals Reference v2.25.14 (development-branch).