X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=scm%2Fdefine-grob-properties.scm;h=93533ee986b98315d4728d4461296840989e1b98;hb=5b4b0d6e9a197e8f9eb085b7c2ad78b8be3e5cfc;hp=49916fa24ee62543ad408489d2db41e59cfd67ed;hpb=37167c33a70c914334b6a4b5fec8eb5c6a62a555;p=lilypond.git diff --git a/scm/define-grob-properties.scm b/scm/define-grob-properties.scm index 49916fa24e..93533ee986 100644 --- a/scm/define-grob-properties.scm +++ b/scm/define-grob-properties.scm @@ -1,8 +1,8 @@ -;;;; grob-property-description.scm -- part of generated backend documentation +;;;; define-grob-properties.scm -- part of generated backend documentation ;;;; ;;;; source file of the GNU LilyPond music typesetter ;;;; -;;;; (c) 1998--2007 Han-Wen Nienhuys +;;;; (c) 1998--2008 Han-Wen Nienhuys ;;;; Jan Nieuwenhuizen (define (define-grob-property symbol type? description) @@ -168,6 +168,9 @@ other object. Otherwise, it determines whether the object is placed be used: @code{#UP}=@code{1}, @code{#DOWN}=@code{-1}, @code{#LEFT}=@code{-1}, @code{#RIGHT}=@code{1}, @code{#CENTER}=@code{0}.") (dot-count ,integer? "The number of dots.") + (dot-negative-kern ,number? "The space to remove between a dot +a and slash in percent repeat glyphs. Larger values bring the two +elements closer together.") (dot-placement-list ,list? "List consisting of @code{(@var{description} @var{string-number} @var{fret-number} @var{finger-number})} @@ -204,11 +207,16 @@ problem, we pad each item by this amount (by adding the @q{car} on the left side of the item and adding the @q{cdr} on the right side of the item). In order to make a grob take up no horizontal space at all, set this to @code{(+inf.0 . -inf.0)}.") + (flag ,ly:stencil? "A function returning the full flag stencil for +the @code{Stem}, which is passed to the function as the only argument. +The default ly:stem::calc-stencil function uses the @code{flag-style} +property to determine the correct glyph for the +flag. By providing your own function, you can create arbitrary flags.") (flag-count ,number? "The number of tremolo beams.") - (flag-style ,symbol? "A string determining what style of flag -glyph is typeset on a @code{Stem}. Valid options include @code{()} -and @code{mensural}. Additionally, @code{no-flag} switches off the -flag.") + (flag-style ,symbol? "A symbol determining what style of flag +glyph is typeset on a @code{Stem}. Valid options include @code{'()} for +standard flags, @code{'mensural} and @code{'no-flag}, which switches off +the flag.") (font-encoding ,symbol? "The font encoding is the broadest category for selecting a font. Options include: @code{fetaMusic}, @code{fetaNumber}, @code{TeX-text}, @code{TeX-math}, @@ -231,7 +239,6 @@ Fractional values are allowed.") (force-hshift ,number? "This specifies a manual shift for notes in collisions. The unit is the note head width of the first voice note. This is used by @rinternals{note-collision-interface}.") - (forced ,boolean? "Manually forced accidental.") (fraction ,number-pair? "Numerator and denominator of a time signature object.") (french-beaming ,boolean? "Use French beaming style for this @@ -327,18 +334,27 @@ The properties which can be included in harp-pedal-details include the following: @itemize @bullet @item -@code{box-offset} -- Vertical shift of the center of flat / sharp pedal +@code{box-offset} -- Vertical shift of the center of flat / sharp pedal boxes above / below the horizontal line. Default value 0.8. @item @code{box-width} -- Width of each pedal box. Default value 0.4. @item @code{box-height} -- Height of each pedal box. Default value 1.0. @item -@code{space-before-divider} -- Space between boxes before the first divider +@code{space-before-divider} -- Space between boxes before the first divider (so that the diagram can be made symmetric). Default value 0.8. @item -@code{space-after-divider} -- Space between boxes after the first divider. +@code{space-after-divider} -- Space between boxes after the first divider. Default value 0.8. +@item +@code{circle-thickness} -- Thickness (in unit of the line-thickness) of the +ellipse around circled pedals. Default value 0.5. +@item +@code{circle-x-padding} -- Padding in X direction of the ellipse around +circled pedals. Default value 0.15. +@item +@code{circle-y-padding} -- Padding in Y direction of the ellipse around +circled pedals. Default value 0.2. @end itemize") (head-direction ,ly:dir? "Are the note heads left or right in a @@ -553,6 +569,9 @@ is placed vertically.") @code{direction-source} with this to get the direction of this object.") (size ,number? "Size of object, relative to standard size.") + (slash-negative-kern ,number? "The space to remove between +slashes in percent repeat glyphs. Larger values bring the two +elements closer together.") (slope ,number? "The slope of this object.") (slur-padding ,number? "Extra distance between slur and script.") (space-alist ,list? "A table that specifies distances between @@ -593,8 +612,8 @@ be?") (stencil ,ly:stencil? "The symbol to print.") (stencils ,list? "Multiple stencils, used as intermediate value.") - (strict-grace-spacing ,boolean? "If set, grace notes -are not spaced separately, but put before musical columns.") + (strict-grace-spacing ,boolean? "If set, main notes are spaced +normally, then grace notes are put left of the musical columns fot the main notes.") (strict-note-spacing ,boolean? "If set, unbroken columns with non-musical material (clefs, bar lines, etc.) are not spaced separately, but put before musical columns.") @@ -715,6 +734,7 @@ the grob where this is set in.") in addition to notes and stems.") (figures ,ly:grob-array? "Figured bass objects for continuation line.") + (forced ,boolean? "Manually forced accidental.") (glyph-name ,string? "The glyph name within the font.") (grace-spacing ,ly:grob? "A run of grace notes.") @@ -847,7 +867,7 @@ than a whole rest.") ;; However, such a list would consist of a couple of dozens of ;; entries, since head prefixes may be combined in many ways. If - ;; the macros in `gregorian-init.ly' would directly set prefix-set, + ;; the macros in `gregorian.ly' would directly set prefix-set, ;; all the head prefixes could be junked; however, such macros ;; would be quite numerous, I guess. --jr