[ << Backend ] | [Top][Contents][Index][ ? ] | [ Scheme functions >> ] | ||
[ < side-position-interface ] | [ Up : Graphical Object Interfaces ] | [ spaceable-grob-interface > ] |
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 between0.0
(no line) and1.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
is0
(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 instaff-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
ordebug-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.
[ << Backend ] | [Top][Contents][Index][ ? ] | [ Scheme functions >> ] | ||
[ < side-position-interface ] | [ Up : Graphical Object Interfaces ] | [ spaceable-grob-interface > ] |