Next: , Previous: side-position-interface, Up: Graphical Object Interfaces


3.2.88 slur-interface

A slur.

User settable properties:
annotation (string)
Annotate a grob for debug purposes.
avoid-slur (symbol)
Method of handling slur collisions. Choices are around, inside, outside. If unset, scripts and slurs ignore each other. around only moves the script if there is a collision; outside always moves the script.
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-fraction (number)
Size of the dashes, relative to dash-period. Should be between 0.0 (no line) and 1.0 (continuous line).
dash-period (number)
The length of one dash together with whitespace. If negative, no line is drawn at all.
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.
eccentricity (number)
How asymmetrical to make a slur. Positive means move the center to the right.
height-limit (dimension, in staff space)
Maximum slur height: The longer the slur, the closer it is to this height.
inspect-index (integer)
If debugging is set, set beam and slur configuration to this index, and print the respective scores.
inspect-quants (pair of numbers)
If debugging is set, set beam and slur quants to this position, and print the respective scores.
line-thickness (number)
The thickness of the tie or slur contour.
positions (pair of numbers)
Pair of staff coordinates (left . right), where both left and right are in staff-space units of the current staff. For slurs, this value selects which slur candidate to use; if extreme positions are requested, the closest one is taken.
ratio (number)
Parameter for slur shape. The higher this number, the quicker the slur attains its height-limit.
thickness (number)
Line thickness, generally measured in line-thickness.
Internal properties:
details (list)
Alist of parameters for detailed grob behavior.

More information on the allowed parameters can be found by inspecting lily/slur-scoring.cc, lily/beam-quanting.cc, and lily/tie-formatting-problem.cc. Setting debug-tie-scoring, debug-beam-scoring or debug-slur-scoring also provides useful clues.

encompass-objects (unknown)
Objects that a slur should avoid in addition to notes and stems.
note-columns (pair)
A list of NoteColumn grobs.
quant-score (string)
The beam quanting score; stored for debugging.

This grob interface is used in the following graphical object(s): PhrasingSlur and Slur.

This page is for LilyPond-2.11.58 (development-branch).

Report errors to http://post.gmane.org/post.php?group=gmane.comp.gnu.lilypond.bugs.

Your suggestions for the documentation are welcome.