[ << Backend ]  [Top][Contents][Index][ ? ]  [ Scheme functions >> ]  
[ < sidepositioninterface ]  [ Up : Graphical Object Interfaces ]  [ spaceablegrobinterface > ] 
3.2.105 slurinterface
A slur.
The following properties may be set in the details
list.

regionsize
Size of region (in staff spaces) for determining potential endpoints in the Y direction.

headencompasspenalty
Demerit to apply when note heads collide with a slur.

stemencompasspenalty
Demerit to apply when stems collide with a slur.

edgeattractionfactor
Factor used to calculate the demerit for distances between slur endpoints and their corresponding base attachments.

sameslopepenalty
Demerit for slurs with attachment points that are horizontally aligned.

steeperslopefactor
Factor used to calculate demerit only if this slur is not broken.

nonhorizontalpenalty
Demerit for slurs with attachment points that are not horizontally aligned.

maxslope
The maximum slope allowed for this slur.

maxslopefactor
Factor that calculates demerit based on the max slope.

freeheaddistance
The amount of vertical free space that must exist between a slur and note heads.

absoluteclosenessmeasure
Factor to calculate demerit for variance between a note head and slur.

extraobjectcollisionpenalty
Factor to calculate demerit for extra objects that the slur encompasses, including accidentals, fingerings, and tuplet numbers.

accidentalcollision
Factor to calculate demerit for
Accidental
objects that the slur encompasses. This property value replaces the value ofextraobjectcollisionpenalty
.
extraencompassfreedistance
The amount of vertical free space that must exist between a slur and various objects it encompasses, including accidentals, fingerings, and tuplet numbers.

extraencompasscollisiondistance
This detail is currently unused.

headslurdistancefactor
Factor to calculate demerit for variance between a note head and slur.

headslurdistancemaxratio
The maximum value for the ratio of distance between a note head and slur.

gaptostafflineinside
Minimum gap inside the curve of the slur where the slur is parallel to a staffline.

gaptostafflineoutside
Minimum gap outside the curve of the slur where the slur is parallel to a staffline.

freeslurdistance
The amount of vertical free space that must exist between adjacent slurs. This subproperty only works for
PhrasingSlur
.
edgeslopeexponent
Factor used to calculate the demerit for the slope of a slur near its endpoints; a larger value yields a larger demerit.
User settable properties:
annotation
(string)Annotate a grob for debug purposes.
avoidslur
(symbol)Method of handling slur collisions. Choices are
inside
,outside
,around
, andignore
.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
andaround
behave likeignore
.controlpoints
(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 thirdorder Bézier curve.
dashdefinition
(pair)List of
dashelements
defining the dash structure. Eachdashelement
has a starting t value, an ending tvalue, adashfraction
, and adashperiod
.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
sideaxis
is0
(orX
), then this property determines whether the object is placedLEFT
,CENTER
orRIGHT
with respect to the other object. Otherwise, it determines whether the object is placedUP
,CENTER
orDOWN
. 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.
heightlimit
(dimension, in staff space)Maximum slur height: The longer the slur, the closer it is to this height.
inspectindex
(integer)If debugging is set, set beam and slur configuration to this index, and print the respective scores.
inspectquants
(pair of numbers)If debugging is set, set beam and slur quants to this position, and print the respective scores.
linethickness
(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 staffline thickness (i.e. the visual output is influenced by changes to
Staff.StaffSymbol.thickness
).positions
(pair of numbers)Pair of staff coordinates
(left . right)
, where both left and right are instaffspace
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
heightlimit
.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 staffline thickness (i.e. the visual output is influenced by changes to
Staff.StaffSymbol.thickness
).
Internal properties:
encompassobjects
(array of grobs)Objects that a slur should avoid in addition to notes and stems.
notecolumns
(array of grobs)An array of
NoteColumn
grobs.
This grob interface is used in the following graphical object(s): PhrasingSlur and Slur.
[ << Backend ]  [Top][Contents][Index][ ? ]  [ Scheme functions >> ]  
[ < sidepositioninterface ]  [ Up : Graphical Object Interfaces ]  [ spaceablegrobinterface > ] 