GNU LilyPond

Welcome to the home of the GNU Music Typesetter

Node:PhrasingSlur, Next:NonMusicalPaperColumn, Previous:PaperColumn, Up:LilyPond backend

PhrasingSlur

PhrasingSlur grobs are created by: none

slur-interface

A slur

de-uglify-parameters (list):

list of 3 real constants. They define the valid areas for the middle control points. Used in de_uglyfy. They are a bit empirical. Default value: '(1.5 0.8 -2.0)

details (list):

alist of parameters for detailed grob behavior. Default value: '((height-limit . 2.0) (ratio . 0.333) (force-blowfit . 0.5) (bezier-pct-c0 . -0.2) (bezier-pct-c3 . 6.0e-6) (bezier-pct-out-max . 0.8) (bezier-pct-in-max . 1.2) (bezier-area-steps . 1.0))

attachment (pair):

cons of symbols, '(LEFT-TYPE . RIGHT-TYPE), where both types may be alongside-stem, stem, head or loose-end. Default value: '(#f . #f)

direction (direction):

up or down, left or right?. Default value: (unset)

attachment-offset (pair):

cons of offsets, '(LEFT-offset . RIGHT-offset). This offset is added to the attachments to prevent ugly slurs. [fixme: we need more documentation here]. . Default value: '((0 . 0) 0 . 0)

beautiful (number):

number that dictates when a slur should be de-uglyfied. It correlates with the enclosed area between noteheads and slurs. A value of 0.1 yields only undisturbed slurs, a value of 5 will tolerate quite high blown slurs. Default value: 0.5

y-free (number):

minimal vertical gap between slur and noteheads or stems. Default value: 0.75

control-points (list):

List of 4 offsets (number-pairs) that form control points for the tie/slur shape. Default value: (unset)

extremity-rules (list):

an alist (procedure slur dir) -> attachment to determine the attachment (see above). If procedure returns #t, attachment is used. Otherwise, the next procedure is tried. Default value: '((#<procedure (slur dir)> . head) (#<procedure (slur dir)> . loose-end) (#<procedure (slur dir)> . head) (#<procedure (slur dir)> . stem) (#<procedure (slur dir)> . loose-end) (#<procedure (x y)> . head))

extremity-offset-alist (list):

an alist (attachment stem-dir*dir slur-dir*dir) -> offset. The offset adds to the centre of the notehead, or stem. Default value: '(((head 1 1) -0.25 . 1.25) ((head 1 -1) -0.25 . 1.25) ((head -1 1) -0.25 . 1.25) ((head -1 -1) -0.85 . 1.25) ((stem 1 1) 0 . 1.5) ((stem -1 -1) 0 . 1.5) ((loose-end 1 1) -0.4 . 0) ((loose-end 1 -1) -0.4 . 0) ((loose-end -1 -1) -4 . 0) ((loose-end -1 1) -4 . 0))

thickness (number):

thickness, measured in stafflinethickness. Default value: 1.2

dashed (number):

[FIXME: use dash-period/dash length; see text-spanner] number representing the length of the dashes. Default value: (unset)

general-grob-interface

All grobs support this

X-offset-callbacks (list):

list of functions, each taking an grob and axis argument. The function determine the position relative to this grob's parent. The last one in the list is called first. Default value: (unset)

Y-offset-callbacks (list):

see X-offset-callbacks. Default value: (unset)

X-extent-callback (procedure):

procedure taking an grob and axis argument, returning a number-pair. The return value is the extent of the grob. Default value: (unset)

Y-extent-callback (procedure):

see X-extent-callback. Default value: #<primitive-procedure Slur::height>

molecule-callback (procedure):

Function taking grob as argument, returning a Scheme encoded Molecule. Default value: #<primitive-procedure Slur::brew_molecule>

font-relative-size (number):

partial font definition: the relative size compared the `normal' size. 0 is style-sheet's normal size, -1 is smaller, +1 is bigger, -1 is smaller. Default value: (unset)

extra-offset (pair of numbers):

pair of reals (a cons) forcing an extra offset before outputting. extra-offset is added just before `printing' the grob, so the typesetting engine is completely oblivious to it.

Default value: (unset)

interfaces (list):

list of symbols indicating the interfaces supported by this object. Is initialized from the meta field. Default value: (unset)

dependencies (list):

list of score-grob pointers that indicate who to compute first for certain global passes. Default value: (unset)

no-spacing-rods (boolean):

read from grobs: boolean that makes Separation_item ignore this item (MOVE ME TO ITEM). Default value: (unset)

extra-extent-X (pair of numbers):

enlarge in X dimension by this much, measured in staff space. Default value: (unset)

extra-extent-Y (pair of numbers):

see extra-extent-Y. Default value: (unset)

minimum-extent-X (pair of numbers):

minimum size in X dimension, measured in staff space. Default value: (unset)

minimum-extent-Y (pair of numbers):

see minimum-extent-Y. Default value: (unset)

origin (input location):

location in input file of the definition. Default value: (unset)

transparent (boolean):

This is almost the same as setting molecule-callback to #f, but this retains the dimensions of this grob, which means that you can erase grobs individually. . Default value: (unset)

Please send GNU LilyPond questions and comments to lilypond-user@gnu.org.

Please send comments on these web pages to lilypond@packages.debian.org

Copyright (c) 1997--2001 Han-Wen Nienhuys and Jan Nieuwenhuizen.

Verbatim copying and distribution of this entire article is permitted in any medium, provided this notice is preserved.