scm/define-grobs.scm

   1 ;;;; This file is part of LilyPond, the GNU music typesetter.
   2 ;;;;
   3 ;;;; Copyright (C) 1998--2012 Han-Wen Nienhuys <hanwen@xs4all.nl>
   4 ;;;;                 Jan Nieuwenhuizen <janneke@gnu.org>
   5 ;;;;
   6 ;;;; LilyPond is free software: you can redistribute it and/or modify
   7 ;;;; it under the terms of the GNU General Public License as published by
   8 ;;;; the Free Software Foundation, either version 3 of the License, or
   9 ;;;; (at your option) any later version.
  10 ;;;;
  11 ;;;; LilyPond is distributed in the hope that it will be useful,
  12 ;;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 ;;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 ;;;; GNU General Public License for more details.
  15 ;;;;
  16 ;;;; You should have received a copy of the GNU General Public License
  17 ;;;; along with LilyPond.  If not, see <http://www.gnu.org/licenses/>.
  18
  19 ;;;; distances are given in line-thickness (thicknesses) and
  20 ;;;; staff-space (distances)
  21
  22 ;;;; WARNING: the meta field should be the last one.
  23 ;;;; WARNING: don't use anonymous functions for initialization.
  24
  25 ;; TODO: junk the meta field in favor of something more compact?
  26
  27
  28 (define-session-public all-grob-descriptions
  29   `(
  30     (Accidental
  31      . (
  32         (alteration . ,accidental-interface::calc-alteration)
  33         (avoid-slur . inside)
  34         (glyph-name . ,accidental-interface::glyph-name)
  35         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
  36         (stencil . ,ly:accidental-interface::print)
  37         (horizontal-skylines . ,(ly:make-unpure-pure-container ly:accidental-interface::horizontal-skylines))
  38         (vertical-skylines . ,grob::unpure-vertical-skylines-from-stencil)
  39         (X-extent . ,ly:accidental-interface::width)
  40         (Y-extent . ,accidental-interface::height)
  41         (meta . ((class . Item)
  42                  (interfaces . (accidental-interface
  43                                 inline-accidental-interface
  44                                 font-interface))))))
  45
  46     (AccidentalCautionary
  47      . (
  48         (alteration . ,accidental-interface::calc-alteration)
  49         (avoid-slur . inside)
  50         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
  51         (parenthesized . #t)
  52         (stencil . ,ly:accidental-interface::print)
  53         (Y-extent . ,accidental-interface::height)
  54         (meta . ((class . Item)
  55                  (interfaces . (accidental-interface
  56                                 inline-accidental-interface
  57                                 font-interface))))))
  58
  59     (AccidentalPlacement
  60      . (
  61         (direction .  ,LEFT)
  62         (positioning-done . ,ly:accidental-placement::calc-positioning-done)
  63
  64         ;; this is quite small, but it is very ugly to have
  65         ;; accs closer to the previous note than to the next one.
  66         (right-padding . 0.15)
  67
  68         ;; for horizontally stacked scripts.
  69         (script-priority .  -100)
  70
  71         (X-extent . ,ly:axis-group-interface::width)
  72         (meta . ((class . Item)
  73                  (interfaces . (accidental-placement-interface))))))
  74
  75     (AccidentalSuggestion
  76      . (
  77         (alteration . ,accidental-interface::calc-alteration)
  78         (direction . ,UP)
  79         (font-size . -2)
  80         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
  81         (outside-staff-priority . 0)
  82         (script-priority . 0)
  83         (self-alignment-X . ,CENTER)
  84         (side-axis . ,Y)
  85         (staff-padding . 0.25)
  86         (stencil . ,ly:accidental-interface::print)
  87         (X-extent . ,ly:accidental-interface::width)
  88         (X-offset . ,(ly:make-simple-closure
  89                       `(,+
  90                         ,(ly:make-simple-closure
  91                           (list ly:self-alignment-interface::centered-on-x-parent))
  92                         ,(ly:make-simple-closure
  93                           (list ly:self-alignment-interface::x-aligned-on-self)))))
  94         (Y-extent . ,accidental-interface::height)
  95         (Y-offset . ,side-position-interface::y-aligned-side)
  96         (meta . ((class . Item)
  97                  (interfaces . (accidental-interface
  98                                 accidental-suggestion-interface
  99                                 font-interface
 100                                 script-interface
 101                                 self-alignment-interface
 102                                 side-position-interface))))))
 103
 104     (Ambitus
 105      . (
 106         (axes . (,X ,Y))
 107         (break-align-symbol . ambitus)
 108         (break-visibility . ,begin-of-line-visible)
 109         (non-musical . #t)
 110         (space-alist . (
 111                         (cue-end-clef . (extra-space . 0.5))
 112                         (clef . (extra-space . 0.5))
 113                         (cue-clef . (extra-space . 0.5))
 114                         (key-signature . (extra-space . 0.0))
 115                         (staff-bar . (extra-space . 0.0))
 116                         (time-signature . (extra-space . 0.0))
 117                         (first-note . (fixed-space . 0.0))))
 118         (X-extent . ,ly:axis-group-interface::width)
 119         (Y-extent . ,axis-group-interface::height)
 120         (meta . ((class . Item)
 121                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
 122                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
 123                  (interfaces . (ambitus-interface
 124                                 axis-group-interface
 125                                 break-aligned-interface))))))
 126
 127     (AmbitusAccidental
 128      . (
 129         (direction . ,LEFT)
 130         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
 131         (padding . 0.5)
 132         (side-axis . ,X)
 133         (stencil . ,ly:accidental-interface::print)
 134         (X-offset . ,ly:side-position-interface::x-aligned-side)
 135         (Y-extent . ,accidental-interface::height)
 136         (meta . ((class . Item)
 137                  (interfaces . (accidental-interface
 138                                 break-aligned-interface
 139                                 font-interface
 140                                 side-position-interface))))))
 141
 142     (AmbitusLine
 143      . (
 144         (gap . ,ambitus-line::calc-gap)
 145         (length-fraction . 0.7)
 146         (maximum-gap . 0.45)
 147         (stencil . ,ambitus::print)
 148         (thickness . 2)
 149         (X-offset . ,ly:self-alignment-interface::centered-on-x-parent)
 150         (meta . ((class . Item)
 151                  (interfaces . (ambitus-interface
 152                                 font-interface))))))
 153
 154     (AmbitusNoteHead
 155      . (
 156         (duration-log . 2)
 157         (glyph-name . ,note-head::calc-glyph-name)
 158         (stencil . ,ly:note-head::print)
 159         (Y-offset . ,staff-symbol-referencer::callback)
 160         (Y-extent . ,grob::always-Y-extent-from-stencil)
 161         (meta . ((class . Item)
 162                  (interfaces . (ambitus-interface
 163                                 font-interface
 164                                 ledgered-interface
 165                                 note-head-interface
 166                                 rhythmic-head-interface
 167                                 staff-symbol-referencer-interface))))))
 168
 169     (Arpeggio
 170      . (
 171         (cross-staff . ,ly:arpeggio::calc-cross-staff)
 172         (direction . ,LEFT)
 173         (padding . 0.5)
 174         (positions . ,ly:arpeggio::calc-positions)
 175         (protrusion . 0.4)
 176         (script-priority . 0)
 177         (side-axis . ,X)
 178         (staff-position . 0.0)
 179         (stencil . ,ly:arpeggio::print)
 180         (X-extent . ,ly:arpeggio::width)
 181         (Y-extent . ,(grob::unpure-Y-extent-from-stencil ly:arpeggio::pure-height))
 182         (X-offset . ,ly:side-position-interface::x-aligned-side)
 183         (Y-offset . ,staff-symbol-referencer::callback)
 184         (meta . ((class . Item)
 185                  (interfaces . (arpeggio-interface
 186                                 font-interface
 187                                 side-position-interface
 188                                 staff-symbol-referencer-interface))))))
 189
 190     (BalloonTextItem
 191      . (
 192         (annotation-balloon . #t)
 193         (annotation-line . #t)
 194         (extra-spacing-width . (+inf.0 . -inf.0))
 195         (stencil . ,ly:balloon-interface::print)
 196         (text . ,(grob::calc-property-by-copy 'text))
 197         (X-offset . ,(grob::calc-property-by-copy 'X-offset))
 198         (Y-offset . ,(grob::calc-property-by-copy 'Y-offset))
 199         (Y-extent . ,grob::always-Y-extent-from-stencil)
 200         (meta . ((class . Item)
 201                  (interfaces . (balloon-interface
 202                                 font-interface
 203                                 text-interface))))))
 204
 205     (BarLine
 206      . (
 207         (allow-span-bar . #t)
 208         (bar-extent . ,ly:bar-line::calc-bar-extent)
 209         (break-align-anchor . ,ly:bar-line::calc-anchor)
 210         (break-align-symbol . staff-bar)
 211         (break-visibility . ,bar-line::calc-break-visibility)
 212         (extra-spacing-height . ,pure-from-neighbor-interface::account-for-span-bar)
 213         (gap . 0.4)
 214         (glyph . "|")
 215         (glyph-name . ,bar-line::calc-glyph-name)
 216
 217         ;;
 218         ;; Ross. page 151 lists other values, we opt for a leaner look
 219         ;;
 220         ;; TODO:
 221         ;; kern should scale with line-thickness too.
 222         (kern . 3.0)
 223         (thin-kern . 3.0)
 224         (hair-thickness . 1.9)
 225         (thick-thickness . 6.0)
 226
 227         (layer . 0)
 228         (non-musical . #t)
 229         (rounded . #f)
 230         (space-alist . (
 231                         (time-signature . (extra-space . 0.75))
 232                         (custos . (minimum-space . 2.0))
 233                         (clef . (minimum-space . 1.0))
 234                         (key-signature . (extra-space . 1.0))
 235                         (key-cancellation . (extra-space . 1.0))
 236                         (first-note . (fixed-space . 1.3))
 237                         (next-note . (semi-fixed-space . 0.9))
 238                         (right-edge . (extra-space . 0.0))))
 239         (stencil . ,ly:bar-line::print)
 240         (Y-extent . ,grob::always-Y-extent-from-stencil)
 241         (meta . ((class . Item)
 242                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
 243                                       (pure-relevant-grobs . ,ly:pure-from-neighbor-interface::calc-pure-relevant-grobs)))
 244                  (interfaces . (bar-line-interface
 245                                 break-aligned-interface
 246                                 font-interface
 247                                 pure-from-neighbor-interface))))))
 248
 249     (BarNumber
 250      . (
 251         (after-line-breaking . ,ly:side-position-interface::move-to-extremal-staff)
 252         ;; want the bar number before the clef at line start.
 253         (break-align-symbols . (left-edge staff-bar))
 254
 255         (break-visibility . ,begin-of-line-visible)
 256         (direction . ,UP)
 257         (extra-spacing-width . (+inf.0 . -inf.0))
 258         (font-family . roman)
 259         (font-size . -2)
 260         (non-musical . #t)
 261         ;; w/o padding, bars numbers are not positioned over the staff as
 262         ;; they are slightly to the left. so we add just a bit.
 263         (horizon-padding . 0.05)
 264         (outside-staff-priority . 100)
 265         (padding . 1.0)
 266         (self-alignment-X . ,RIGHT)
 267         (side-axis . ,Y)
 268         (stencil . ,ly:text-interface::print)
 269         (X-offset . ,(ly:make-simple-closure
 270                       `(,+
 271                         ,(ly:make-simple-closure
 272                           (list ly:break-alignable-interface::self-align-callback))
 273                         ,(ly:make-simple-closure
 274                           (list ly:self-alignment-interface::x-aligned-on-self)))))
 275         (Y-offset . ,side-position-interface::y-aligned-side)
 276         (Y-extent . ,grob::always-Y-extent-from-stencil)
 277         (meta .
 278               ((class . Item)
 279                (interfaces . (break-alignable-interface
 280                               font-interface
 281                               self-alignment-interface
 282                               side-position-interface
 283                               text-interface))))))
 284
 285     (BassFigure
 286      . (
 287         (stencil . ,ly:text-interface::print)
 288         (Y-extent . ,grob::always-Y-extent-from-stencil)
 289         (meta . ((class . Item)
 290                  (interfaces . (bass-figure-interface
 291                                 font-interface
 292                                 rhythmic-grob-interface
 293                                 text-interface))))))
 294
 295     (BassFigureAlignment
 296      . (
 297         (axes . (,Y))
 298         (padding . 0.2)
 299         (positioning-done . ,ly:align-interface::align-to-minimum-distances)
 300         (stacking-dir . ,DOWN)
 301         (X-extent . ,ly:axis-group-interface::width)
 302         (Y-extent . ,axis-group-interface::height)
 303         (meta . ((class . Spanner)
 304                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
 305                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
 306                  (interfaces . (align-interface
 307                                 axis-group-interface
 308                                 bass-figure-alignment-interface))))))
 309
 310     (BassFigureAlignmentPositioning
 311      . (
 312         (axes . (,Y))
 313         (direction . ,UP)
 314         (padding . 0.5)
 315         (side-axis . ,Y)
 316         (staff-padding . 1.0)
 317         (X-extent . ,ly:axis-group-interface::width)
 318         (Y-extent . ,axis-group-interface::height)
 319         (Y-offset . ,side-position-interface::y-aligned-side)
 320         (meta . ((class . Spanner)
 321                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
 322                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
 323                  (interfaces . (axis-group-interface
 324                                 side-position-interface))))))
 325
 326     (BassFigureBracket
 327      . (
 328         (edge-height . (0.2 . 0.2))
 329         (stencil . ,ly:enclosing-bracket::print)
 330         (X-extent . ,ly:enclosing-bracket::width)
 331         (meta . ((class . Item)
 332                  (interfaces . (enclosing-bracket-interface))))))
 333
 334     (BassFigureContinuation
 335      . (
 336         (stencil . ,ly:figured-bass-continuation::print)
 337         (Y-offset . ,ly:figured-bass-continuation::center-on-figures)
 338         (meta . ((class . Spanner)
 339                  (interfaces . (figured-bass-continuation-interface))))))
 340
 341     (BassFigureLine
 342      . (
 343         (adjacent-pure-heights . ,ly:axis-group-interface::adjacent-pure-heights)
 344         (axes . (,Y))
 345         (vertical-skylines . ,ly:axis-group-interface::calc-skylines)
 346         (X-extent . ,ly:axis-group-interface::width)
 347         (Y-extent . ,axis-group-interface::height)
 348         (meta . ((class . Spanner)
 349                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
 350                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
 351                  (interfaces . (axis-group-interface))))))
 352
 353
 354     (Beam
 355      . (
 356         ;; todo: clean this up a bit: the list is getting
 357         ;; rather long.
 358         (auto-knee-gap . 5.5)
 359         (beam-segments . ,ly:beam::calc-beam-segments)
 360         (beam-thickness . 0.48) ; in staff-space
 361
 362         ;; We have some unreferenced problems here.
 363         ;;
 364         ;; If we shorten beamed stems less than normal stems (1 staff-space),
 365         ;; or high order less than 8th beams, patterns like
 366         ;;     c''4 [c''8 c''] c''4 [c''16 c]
 367         ;; are ugly (different stem lengths).
 368         ;;
 369         ;; But if we shorten 16th beams as much as 8th beams, a single
 370         ;; forced 16th beam looks *very* short.
 371
 372         ;; We choose to shorten 8th beams the same as single stems,
 373         ;; and high order beams less than 8th beams, so that all
 374         ;; isolated shortened beams look nice and a bit shortened,
 375         ;; sadly possibly breaking patterns with high order beams.
 376         (beamed-stem-shorten . (1.0 0.5 0.25))
 377
 378         (beaming . ,ly:beam::calc-beaming)
 379         (clip-edges . #t)
 380         (collision-interfaces . (beam-interface
 381                                  clef-interface
 382                                  clef-modifier-interface
 383                                  flag-interface
 384                                  inline-accidental-interface
 385                                  key-signature-interface
 386                                  note-head-interface
 387                                  stem-interface
 388                                  time-signature-interface))
 389         (cross-staff . ,ly:beam::calc-cross-staff)
 390         (damping . 1)
 391         (details
 392          .(
 393            (secondary-beam-demerit . 10)
 394            (stem-length-demerit-factor . 5)
 395            (region-size . 2)
 396            (beam-eps . 0.001)
 397            (stem-length-limit-penalty . 5000)
 398            (damping-direction-penalty . 800)
 399            (hint-direction-penalty . 20)
 400            (musical-direction-factor . 400)
 401            (ideal-slope-factor . 10)
 402            (collision-penalty . 500)
 403            (collision-padding . 0.35)
 404            (round-to-zero-slope . 0.02)))
 405         (direction . ,ly:beam::calc-direction)
 406
 407         (normalized-endpoints . ,ly:spanner::calc-normalized-endpoints)
 408         ;; only for debugging.
 409         (font-family . roman)
 410
 411         (gap . 0.8)
 412         (neutral-direction . ,DOWN)
 413         (positions . ,beam::place-broken-parts-individually)
 414         (X-positions . ,ly:beam::calc-x-positions)
 415         (transparent . ,(grob::inherit-parent-property
 416                          X 'transparent))
 417
 418         ;; this is a hack to set stem lengths, if positions is set.
 419         (quantized-positions . ,ly:beam::set-stem-lengths)
 420
 421         (shorten . ,ly:beam::calc-stem-shorten)
 422         (vertical-skylines . ,grob::unpure-vertical-skylines-from-stencil)
 423         (stencil . ,ly:beam::print)
 424
 425         (meta . ((class . Spanner)
 426                  (object-callbacks . ((normal-stems . ,ly:beam::calc-normal-stems)))
 427                  (interfaces . (beam-interface
 428                                 font-interface
 429                                 staff-symbol-referencer-interface
 430                                 unbreakable-spanner-interface))))))
 431
 432     (BendAfter
 433      . (
 434         (minimum-length . 0.5)
 435         (stencil . ,bend::print)
 436         (thickness . 2.0)
 437         (meta . ((class . Spanner)
 438                  (interfaces . (bend-after-interface
 439                                 spanner-interface))))))
 440
 441     (BreakAlignGroup
 442      . (
 443         (axes . (,X))
 444         (break-align-anchor . ,ly:break-aligned-interface::calc-average-anchor)
 445         (break-visibility . ,ly:break-aligned-interface::calc-break-visibility)
 446         (X-extent . ,ly:axis-group-interface::width)
 447         (meta . ((class . Item)
 448                  (interfaces . (axis-group-interface
 449                                 break-aligned-interface))))))
 450
 451     (BreakAlignment
 452      . (
 453         (axes . (,X))
 454         (break-align-orders . ;; end of line
 455                             #((
 456                                left-edge
 457                                cue-end-clef
 458                                ambitus
 459                                breathing-sign
 460                                clef
 461                                cue-clef
 462                                staff-bar
 463                                key-cancellation
 464                                key-signature
 465                                time-signature
 466                                custos)
 467
 468                               ;; unbroken
 469                               (
 470                                left-edge
 471                                cue-end-clef
 472                                ambitus
 473                                breathing-sign
 474                                clef
 475                                cue-clef
 476                                staff-bar
 477                                key-cancellation
 478                                key-signature
 479                                time-signature
 480                                custos)
 481
 482                               ;; begin of line
 483                               (
 484                                left-edge
 485                                ambitus
 486                                breathing-sign
 487                                clef
 488                                key-cancellation
 489                                key-signature
 490                                time-signature
 491                                staff-bar
 492                                cue-clef
 493                                custos)))
 494         (non-musical . #t)
 495         (positioning-done . ,ly:break-alignment-interface::calc-positioning-done)
 496         (stacking-dir . 1)
 497         (X-extent . ,ly:axis-group-interface::width)
 498         (meta . ((class . Item)
 499                  (interfaces . (axis-group-interface
 500                                 break-alignment-interface))))))
 501
 502     (BreathingSign
 503      . (
 504         (break-align-symbol . breathing-sign)
 505         (break-visibility . ,begin-of-line-invisible)
 506         (non-musical . #t)
 507         (space-alist . (
 508                         (ambitus . (extra-space . 2.0))
 509                         (custos . (minimum-space . 1.0))
 510                         (key-signature . (minimum-space . 1.5))
 511                         (time-signature . (minimum-space . 1.5))
 512                         (staff-bar . (minimum-space . 1.5))
 513                         (clef . (minimum-space . 2.0))
 514                         (cue-clef . (minimum-space . 2.0))
 515                         (cue-end-clef . (minimum-space . 2.0))
 516                         (first-note . (fixed-space . 1.0)) ;huh?
 517                         (right-edge . (extra-space . 0.1))))
 518         (stencil . ,ly:text-interface::print)
 519         (text . ,(make-musicglyph-markup "scripts.rcomma"))
 520         (Y-offset . ,ly:breathing-sign::offset-callback)
 521         (Y-extent . ,grob::always-Y-extent-from-stencil)
 522         (meta . ((class . Item)
 523                  (interfaces . (break-aligned-interface
 524                                 breathing-sign-interface
 525                                 font-interface
 526                                 text-interface))))))
 527
 528     (ChordName
 529      . (
 530         (after-line-breaking . ,ly:chord-name::after-line-breaking)
 531         (font-family . sans)
 532         (font-size . 1.5)
 533         (stencil . ,ly:text-interface::print)
 534         (extra-spacing-height . (0.2 . -0.2))
 535         (extra-spacing-width . (-0.5 . 0.5))
 536         (word-space . 0.0)
 537         (Y-extent . ,grob::always-Y-extent-from-stencil)
 538         (meta . ((class . Item)
 539                  (interfaces . (chord-name-interface
 540                                 font-interface
 541                                 rhythmic-grob-interface
 542                                 text-interface))))))
 543
 544     (Clef
 545      . (
 546         (avoid-slur . inside)
 547         (break-align-anchor . ,ly:break-aligned-interface::calc-extent-aligned-anchor)
 548         (break-align-anchor-alignment . ,RIGHT)
 549         (break-align-symbol . clef)
 550         (break-visibility . ,begin-of-line-visible)
 551         (extra-spacing-height . ,pure-from-neighbor-interface::extra-spacing-height-at-beginning-of-line)
 552         (glyph-name . ,ly:clef::calc-glyph-name)
 553         (non-musical . #t)
 554         (space-alist . ((cue-clef . (extra-space . 2.0))
 555                         (staff-bar . (extra-space . 0.7))
 556                         (key-cancellation . (minimum-space . 3.5))
 557                         (key-signature . (minimum-space . 3.5))
 558                         (time-signature . (minimum-space . 4.2))
 559                         (first-note . (minimum-fixed-space . 5.0))
 560                         (next-note . (extra-space . 1.0))
 561                         (right-edge . (extra-space . 0.5))))
 562         (stencil . ,ly:clef::print)
 563         (vertical-skylines . ,grob::always-vertical-skylines-from-stencil)
 564         (Y-offset . ,staff-symbol-referencer::callback)
 565         (Y-extent . ,grob::always-Y-extent-from-stencil)
 566         (meta . ((class . Item)
 567                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
 568                                       (pure-relevant-grobs . ,ly:pure-from-neighbor-interface::calc-pure-relevant-grobs)))
 569                  (interfaces . (break-aligned-interface
 570                                 clef-interface
 571                                 font-interface
 572                                 pure-from-neighbor-interface
 573                                 staff-symbol-referencer-interface))))))
 574
 575     (ClefModifier
 576      . (
 577         (break-visibility . ,(grob::inherit-parent-property
 578                               X 'break-visibility))
 579         (font-shape . italic)
 580         (font-size . -4)
 581         (transparent . ,(grob::inherit-parent-property
 582                          X 'transparent))
 583         (color . ,(grob::inherit-parent-property
 584                    X 'color))
 585         (self-alignment-X . ,CENTER)
 586         (staff-padding . 0.7)
 587         (stencil . ,ly:text-interface::print)
 588         (X-offset . ,(ly:make-simple-closure
 589                       `(,+
 590                         ,(ly:make-simple-closure
 591                           (list ly:self-alignment-interface::x-aligned-on-self))
 592                         ,(ly:make-simple-closure
 593                           (list ly:self-alignment-interface::centered-on-x-parent)))))
 594         (Y-offset . ,side-position-interface::y-aligned-side)
 595         (vertical-skylines . ,grob::always-vertical-skylines-from-stencil)
 596         (Y-extent . ,grob::always-Y-extent-from-stencil)
 597         (meta . ((class . Item)
 598                  (interfaces . (clef-modifier-interface
 599                                 font-interface
 600                                 self-alignment-interface
 601                                 side-position-interface
 602                                 text-interface))))))
 603
 604     (ClusterSpanner
 605      . (
 606         (cross-staff . ,ly:cluster::calc-cross-staff)
 607         (minimum-length . 0.0)
 608         (padding . 0.25)
 609         (springs-and-rods . ,ly:spanner::set-spacing-rods)
 610         (stencil . ,ly:cluster::print)
 611         (style . ramp)
 612         (meta . ((class . Spanner)
 613                  (interfaces . (cluster-interface))))))
 614
 615     (ClusterSpannerBeacon
 616      . (
 617         (Y-extent . ,ly:cluster-beacon::height)
 618         (meta . ((class . Item)
 619                  (interfaces . (cluster-beacon-interface
 620                                 rhythmic-grob-interface))))))
 621
 622     (CombineTextScript
 623      . (
 624         (avoid-slur . outside)
 625         (baseline-skip . 2)
 626         (direction . ,UP)
 627         (extra-spacing-width . (+inf.0 . -inf.0))
 628         (font-series . bold)
 629         (outside-staff-priority . 450)
 630         (padding . 0.5)
 631         (script-priority . 200)
 632         (side-axis . ,Y)
 633         (staff-padding . 0.5)
 634         ;; todo: add X self alignment?
 635         (stencil . ,ly:text-interface::print)
 636         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
 637         (Y-offset . ,side-position-interface::y-aligned-side)
 638         (Y-extent . ,grob::always-Y-extent-from-stencil)
 639         (meta . ((class . Item)
 640                  (interfaces . (font-interface
 641                                 side-position-interface
 642                                 text-interface
 643                                 text-script-interface))))))
 644
 645     (CueClef
 646      . (
 647         (avoid-slur . inside)
 648         (break-align-anchor . ,ly:break-aligned-interface::calc-extent-aligned-anchor)
 649         (break-align-symbol . cue-clef)
 650         (break-visibility . ,begin-of-line-visible)
 651         (extra-spacing-height . ,pure-from-neighbor-interface::extra-spacing-height-at-beginning-of-line)
 652         (font-size . -4)
 653         (glyph-name . ,ly:clef::calc-glyph-name)
 654         (non-musical . #t)
 655         (full-size-change . #t)
 656         (space-alist . ((staff-bar . (minimum-space . 2.7))
 657                         (key-cancellation . (minimum-space . 3.5))
 658                         (key-signature . (minimum-space . 3.5))
 659                         (time-signature . (minimum-space . 4.2))
 660                         (custos . (minimum-space . 0.0))
 661                         (first-note . (minimum-fixed-space . 3.0))
 662                         (next-note . (extra-space . 1.0))
 663                         (right-edge . (extra-space . 0.5))))
 664         (stencil . ,ly:clef::print)
 665         (vertical-skylines . ,grob::always-vertical-skylines-from-stencil)
 666         (Y-offset . ,staff-symbol-referencer::callback)
 667         (Y-extent . ,grob::always-Y-extent-from-stencil)
 668         (meta . ((class . Item)
 669                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
 670                                       (pure-relevant-grobs . ,ly:pure-from-neighbor-interface::calc-pure-relevant-grobs)))
 671                  (interfaces . (break-aligned-interface
 672                                 clef-interface
 673                                 font-interface
 674                                 pure-from-neighbor-interface
 675                                 staff-symbol-referencer-interface))))))
 676
 677     (CueEndClef
 678      . (
 679         (avoid-slur . inside)
 680         (break-align-anchor . ,ly:break-aligned-interface::calc-extent-aligned-anchor)
 681         (break-align-symbol . cue-end-clef)
 682         (break-visibility . ,begin-of-line-invisible)
 683         (extra-spacing-height . ,pure-from-neighbor-interface::extra-spacing-height-at-beginning-of-line)
 684         (font-size . -4)
 685         (glyph-name . ,ly:clef::calc-glyph-name)
 686         (non-musical . #t)
 687         (full-size-change . #t)
 688         (space-alist . ((clef . (extra-space . 0.7))
 689                         (cue-clef . (extra-space . 0.7))
 690                         (staff-bar . (extra-space . 0.7))
 691                         (key-cancellation . (minimum-space . 3.5))
 692                         (key-signature . (minimum-space . 3.5))
 693                         (time-signature . (minimum-space . 4.2))
 694                         (first-note . (minimum-fixed-space . 5.0))
 695                         (next-note . (extra-space . 1.0))
 696                         (right-edge . (extra-space . 0.5))))
 697         (stencil . ,ly:clef::print)
 698         (Y-offset . ,staff-symbol-referencer::callback)
 699         (Y-extent . ,grob::always-Y-extent-from-stencil)
 700         (meta . ((class . Item)
 701                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
 702                                       (pure-relevant-grobs . ,ly:pure-from-neighbor-interface::calc-pure-relevant-grobs)))
 703                  (interfaces . (break-aligned-interface
 704                                 clef-interface
 705                                 font-interface
 706                                 pure-from-neighbor-interface
 707                                 staff-symbol-referencer-interface))))))
 708
 709     (Custos
 710      . (
 711         (break-align-symbol . custos)
 712         (break-visibility . ,end-of-line-visible)
 713         (neutral-direction . ,DOWN)
 714         (non-musical . #t)
 715         (space-alist . (
 716                         (first-note . (minimum-fixed-space . 0.0))
 717                         (right-edge . (extra-space . 0.1))))
 718         (stencil . ,ly:custos::print)
 719         (style . vaticana)
 720         (Y-offset . ,staff-symbol-referencer::callback)
 721         (meta . ((class . Item)
 722                  (interfaces  . (break-aligned-interface
 723                                  custos-interface
 724                                  font-interface
 725                                  staff-symbol-referencer-interface))))))
 726
 727     (DotColumn
 728      . (
 729         (axes . (,X))
 730         (chord-dots-limit . 3)
 731         (direction . ,RIGHT)
 732         (positioning-done . ,ly:dot-column::calc-positioning-done)
 733         (X-extent . ,ly:axis-group-interface::width)
 734         (meta . ((class . Item)
 735                  (interfaces . (axis-group-interface
 736                                 dot-column-interface))))))
 737
 738     (Dots
 739      . (
 740         (avoid-slur . inside)
 741         (dot-count . ,dots::calc-dot-count)
 742         (staff-position . ,dots::calc-staff-position)
 743         (stencil . ,ly:dots::print)
 744         (Y-extent . ,grob::always-Y-extent-from-stencil)
 745         (extra-spacing-height . (-0.5 . 0.5))
 746         (meta . ((class . Item)
 747                  (interfaces . (dots-interface
 748                                 font-interface
 749                                 staff-symbol-referencer-interface))))))
 750
 751     (DoublePercentRepeat
 752      . (
 753         (break-align-symbol . staff-bar)
 754         (break-visibility . ,begin-of-line-invisible)
 755         (dot-negative-kern . 0.75)
 756         (font-encoding . fetaMusic)
 757         (non-musical . #t)
 758         (slash-negative-kern . 1.6)
 759         (slope . 1.0)
 760         (stencil . ,ly:percent-repeat-item-interface::double-percent)
 761         (Y-extent . ,grob::always-Y-extent-from-stencil)
 762         (thickness . 0.48)
 763         (meta . ((class . Item)
 764                  (interfaces . (break-aligned-interface
 765                                 font-interface
 766                                 percent-repeat-interface
 767                                 percent-repeat-item-interface))))))
 768
 769     (DoublePercentRepeatCounter
 770      . (
 771         (direction . ,UP)
 772         (font-encoding . fetaText)
 773         (font-size . -2)
 774         (padding . 0.2)
 775         (self-alignment-X . ,CENTER)
 776         (side-axis . ,Y)
 777         (staff-padding . 0.25)
 778         (stencil . ,ly:text-interface::print)
 779         (X-offset . ,(ly:make-simple-closure
 780                       `(,+
 781                         ,(ly:make-simple-closure
 782                           (list ly:self-alignment-interface::centered-on-y-parent))
 783                         ,(ly:make-simple-closure
 784                           (list ly:self-alignment-interface::x-aligned-on-self)))))
 785         (Y-offset . ,side-position-interface::y-aligned-side)
 786         (Y-extent . ,grob::always-Y-extent-from-stencil)
 787         (meta . ((class . Item)
 788                  (interfaces . (font-interface
 789                                 percent-repeat-interface
 790                                 percent-repeat-item-interface
 791                                 self-alignment-interface
 792                                 side-position-interface
 793                                 text-interface))))))
 794
 795     (DoubleRepeatSlash
 796      . (
 797         (dot-negative-kern . 0.75)
 798         (font-encoding . fetaMusic)
 799         (slash-negative-kern . 1.6)
 800         (slope . 1.0)
 801         (stencil . ,ly:percent-repeat-item-interface::beat-slash)
 802         (Y-extent . ,grob::always-Y-extent-from-stencil)
 803         (thickness . 0.48)
 804         (meta . ((class . Item)
 805                  (interfaces . (font-interface
 806                                 percent-repeat-interface
 807                                 percent-repeat-item-interface
 808                                 rhythmic-grob-interface))))))
 809
 810     (DynamicLineSpanner
 811      . (
 812         (axes . (,Y))
 813         (cross-staff . ,ly:side-position-interface::calc-cross-staff)
 814         (direction . ,DOWN)
 815         (minimum-space . 1.2)
 816         (outside-staff-priority . 250)
 817         (padding . 0.6)
 818         (side-axis . ,Y)
 819         (slur-padding . 0.3)
 820         (staff-padding . 0.1)
 821         (vertical-skylines . ,grob::always-vertical-skylines-from-element-stencils)
 822         (X-extent . ,ly:axis-group-interface::width)
 823         (Y-extent . ,axis-group-interface::height)
 824         (Y-offset . ,side-position-interface::y-aligned-side)
 825         (meta . ((class . Spanner)
 826                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
 827                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
 828                  (interfaces . (axis-group-interface
 829                                 dynamic-interface
 830                                 dynamic-line-spanner-interface
 831                                 side-position-interface))))))
 832
 833     (DynamicText
 834      . (
 835
 836         ;; todo.
 837
 838         (collision-bias . -2.0)
 839         (collision-padding . 0.5)
 840         (direction . ,ly:script-interface::calc-direction)
 841         (extra-spacing-width . (+inf.0 . -inf.0))
 842         (font-encoding . fetaText)
 843         (font-series . bold)
 844         (font-shape . italic)
 845         (positioning-done . ,ly:script-interface::calc-positioning-done)
 846         (right-padding . 0.5)
 847         (self-alignment-X . ,CENTER)
 848         (stencil . ,ly:text-interface::print)
 849         (vertical-skylines . ,grob::always-vertical-skylines-from-stencil)
 850         (Y-extent . ,grob::always-Y-extent-from-stencil)
 851         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
 852         (Y-offset . ,(scale-by-font-size -0.6)) ; center on an 'm'
 853         (meta . ((class . Item)
 854                  (interfaces . (dynamic-interface
 855                                 dynamic-text-interface
 856                                 font-interface
 857                                 script-interface
 858                                 self-alignment-interface
 859                                 text-interface))))))
 860
 861     (DynamicTextSpanner
 862      . (
 863         (before-line-breaking . ,dynamic-text-spanner::before-line-breaking)
 864         (bound-details . ((right . ((attach-dir .  ,LEFT)
 865                                     (Y . 0)
 866                                     (padding . 0.75)
 867                                     ))
 868                           (right-broken . ((attach-dir .  ,RIGHT)
 869                                            (padding . 0.0)
 870                                            ))
 871
 872                           (left . ((attach-dir .  ,LEFT)
 873                                    (Y . 0)
 874                                    (stencil-offset . (-0.75 . -0.5))
 875                                    (padding . 0.75)
 876                                    ))
 877                           (left-broken . ((attach-dir .  ,RIGHT)
 878                                           ))
 879                           ))
 880         (dash-fraction . 0.2)
 881         (dash-period . 3.0)
 882
 883         ;; rather ugh with NCSB
 884         ;; (font-series . bold)
 885         (font-shape . italic)
 886
 887         ;; need to blend with dynamic texts.
 888         (font-size . 1)
 889
 890         (left-bound-info . ,ly:line-spanner::calc-left-bound-info-and-text)
 891
 892         (minimum-length . 2.0)
 893         ;; make sure the spanner doesn't get too close to notes
 894         (minimum-Y-extent . (-1 . 1))
 895
 896         (right-bound-info . ,ly:line-spanner::calc-right-bound-info)
 897         (skyline-horizontal-padding . 0.2)
 898         (springs-and-rods . ,ly:spanner::set-spacing-rods)
 899         (stencil . ,ly:line-spanner::print)
 900         (style . dashed-line)
 901         (vertical-skylines . ,grob::unpure-vertical-skylines-from-stencil)
 902         (meta . ((class . Spanner)
 903                  (interfaces . (dynamic-interface
 904                                 dynamic-text-spanner-interface
 905                                 font-interface
 906                                 line-interface
 907                                 line-spanner-interface
 908                                 spanner-interface
 909                                 text-interface))))))
 910
 911
 912     (Episema
 913      . (
 914         (bound-details . ((left . ((Y . 0)
 915                                    (padding . 0)
 916                                    (attach-dir . ,LEFT)
 917                                    ))
 918                           (right . ((Y . 0)
 919                                     (padding . 0)
 920                                     (attach-dir . ,RIGHT)
 921                                     ))
 922                           ))
 923         (direction . ,UP)
 924         (left-bound-info . ,ly:line-spanner::calc-left-bound-info)
 925         (quantize-position . #t)
 926         (right-bound-info . ,ly:line-spanner::calc-right-bound-info)
 927         (side-axis . ,Y)
 928         (stencil . ,ly:line-spanner::print)
 929         (style . line)
 930         (Y-offset . ,side-position-interface::y-aligned-side)
 931         (meta . ((class . Spanner)
 932                  (interfaces . (episema-interface
 933                                 font-interface
 934                                 line-interface
 935                                 line-spanner-interface
 936                                 side-position-interface))))))
 937
 938
 939     (Fingering
 940      . (
 941
 942         ;; sync with TextScript (?)
 943         (add-stem-support . ,only-if-beamed)
 944         (avoid-slur . around)
 945         (cross-staff . ,script-or-side-position-cross-staff)
 946         (direction . ,ly:script-interface::calc-direction)
 947         (font-encoding . fetaText)
 948         (font-size . -5)                ; don't overlap when next to heads.
 949         (padding . 0.5)
 950         (positioning-done . ,ly:script-interface::calc-positioning-done)
 951         (script-priority . 100)
 952         (self-alignment-X . ,CENTER)
 953         (self-alignment-Y . ,CENTER)
 954         (slur-padding . 0.2)
 955         (staff-padding . 0.5)
 956         (stencil . ,ly:text-interface::print)
 957         (text . ,fingering::calc-text)
 958         (Y-extent . ,grob::always-Y-extent-from-stencil)
 959         (meta . ((class . Item)
 960                  (interfaces . (finger-interface
 961                                 font-interface
 962                                 self-alignment-interface
 963                                 side-position-interface
 964                                 text-interface
 965                                 text-script-interface))))))
 966
 967     (FingeringColumn
 968      . (
 969         (padding . 0.2)
 970         (positioning-done . ,ly:fingering-column::calc-positioning-done)
 971         (snap-radius . 0.3)
 972         (meta . ((class . Item)
 973                  (interfaces . (fingering-column-interface))))))
 974
 975     (Flag
 976      . (
 977         (glyph-name . ,ly:flag::glyph-name)
 978         (stencil . ,ly:flag::print)
 979         (transparent . ,(grob::inherit-parent-property
 980                          X 'transparent))
 981         (color . ,(grob::inherit-parent-property
 982                    X 'color))
 983         (X-extent . ,ly:flag::width)
 984         (X-offset . ,ly:flag::calc-x-offset)
 985         (Y-offset . ,(ly:make-unpure-pure-container ly:flag::calc-y-offset ly:flag::pure-calc-y-offset))
 986         (Y-extent . ,grob::always-Y-extent-from-stencil)
 987         (vertical-skylines . ,grob::always-vertical-skylines-from-stencil)
 988         (meta . ((class . Item)
 989                  (interfaces . (flag-interface
 990                                 font-interface))))))
 991
 992     (FootnoteItem
 993      . (
 994         (annotation-balloon . #f)
 995         (annotation-line . #t)
 996         (automatically-numbered . ,(grob::calc-property-by-copy 'automatically-numbered))
 997         (break-visibility . ,(grob::inherit-parent-property
 998                               X 'break-visibility))
 999         (footnote . #t)
1000         (footnote-text . ,(grob::calc-property-by-copy 'footnote-text))
1001         (stencil . ,ly:balloon-interface::print)
1002         (text . ,(grob::calc-property-by-copy 'text))
1003         (X-extent . #f)
1004         (Y-extent . #f)
1005         (X-offset . ,(grob::calc-property-by-copy 'X-offset))
1006         (Y-offset . ,(grob::calc-property-by-copy 'Y-offset))
1007         (meta . ((class . Item)
1008                  (interfaces . (balloon-interface
1009                                 footnote-interface
1010                                 font-interface
1011                                 text-interface))))))
1012
1013     (FootnoteSpanner
1014      . (
1015         (annotation-balloon . #f)
1016         (annotation-line . #t)
1017         (automatically-numbered . ,(grob::calc-property-by-copy 'automatically-numbered))
1018         (footnote . #t)
1019         (footnote-text . ,(grob::calc-property-by-copy 'footnote-text))
1020         (spanner-placement . ,LEFT)
1021         (stencil . ,ly:balloon-interface::print-spanner)
1022         (text . ,(grob::calc-property-by-copy 'text))
1023         (X-extent . #f)
1024         (Y-extent . #f)
1025         (X-offset . ,(grob::calc-property-by-copy 'X-offset))
1026         (Y-offset . ,(grob::calc-property-by-copy 'Y-offset))
1027         (meta . ((class . Spanner)
1028                  (interfaces . (balloon-interface
1029                                 footnote-interface
1030                                 footnote-spanner-interface
1031                                 font-interface
1032                                 text-interface))))))
1033
1034     (FretBoard
1035      . (
1036         (after-line-breaking . ,ly:chord-name::after-line-breaking)
1037         (fret-diagram-details . ((finger-code . below-string)))
1038         (stencil . ,fret-board::calc-stencil)
1039         (extra-spacing-height . (0.2 . -0.2))
1040         (extra-spacing-width . (-0.5 . 0.5))
1041         (Y-extent . ,grob::always-Y-extent-from-stencil)
1042         (meta . ((class . Item)
1043                  (interfaces . (chord-name-interface
1044                                 font-interface
1045                                 fret-diagram-interface
1046                                 rhythmic-grob-interface))))))
1047
1048
1049     (Glissando
1050      . (
1051         (after-line-breaking . ,ly:spanner::kill-zero-spanned-time)
1052         (bound-details . ((right . ((attach-dir .  ,LEFT)
1053                                     (end-on-accidental . #t)
1054                                     (padding . 0.5)
1055                                     ))
1056                           (left . ((attach-dir .  ,RIGHT)
1057                                    (padding . 0.5)
1058                                    ))
1059                           ))
1060         (cross-staff . ,ly:line-spanner::calc-cross-staff)
1061         (gap . 0.5)
1062         (left-bound-info . ,ly:line-spanner::calc-left-bound-info)
1063         (normalized-endpoints . ,ly:spanner::calc-normalized-endpoints)
1064         (right-bound-info . ,ly:line-spanner::calc-right-bound-info)
1065         (simple-Y . #t)
1066         (stencil . ,ly:line-spanner::print)
1067         (style . line)
1068         (vertical-skylines . ,grob::unpure-vertical-skylines-from-stencil)
1069         (X-extent . #f)
1070         (Y-extent . #f)
1071         (zigzag-width . 0.75)
1072         (meta . ((class . Spanner)
1073                  (interfaces . (glissando-interface
1074                                 line-interface
1075                                 line-spanner-interface
1076                                 unbreakable-spanner-interface))))))
1077
1078     (GraceSpacing
1079      . (
1080         (common-shortest-duration . ,grace-spacing::calc-shortest-duration)
1081         (shortest-duration-space . 1.6)
1082         (spacing-increment . 0.8)
1083         (meta . ((class . Spanner)
1084                  (interfaces . (grace-spacing-interface
1085                                 spacing-options-interface
1086                                 spanner-interface))))))
1087
1088     (GridLine
1089      . (
1090         (layer . 0)
1091         (self-alignment-X . ,CENTER)
1092         (stencil . ,ly:grid-line-interface::print)
1093         (X-extent  . ,ly:grid-line-interface::width)
1094         (X-offset . ,(ly:make-simple-closure
1095                       `(,+
1096                         ,(ly:make-simple-closure
1097                           (list ly:self-alignment-interface::centered-on-x-parent))
1098                         ,(ly:make-simple-closure
1099                           (list ly:self-alignment-interface::x-aligned-on-self)))))
1100         (meta . ((class . Item)
1101                  (interfaces . (grid-line-interface
1102                                 self-alignment-interface))))))
1103
1104     (GridPoint
1105      . (
1106         (X-extent . (0 . 0))
1107         (Y-extent . (0 . 0))
1108         (meta . ((class . Item)
1109                  (interfaces . (grid-point-interface))))))
1110
1111
1112     (Hairpin
1113      . (
1114         (after-line-breaking . ,ly:spanner::kill-zero-spanned-time)
1115         (bound-padding . 1.0)
1116         (broken-bound-padding . ,ly:hairpin::broken-bound-padding)
1117         (circled-tip . #f)
1118         (grow-direction . ,hairpin::calc-grow-direction)
1119         (height . 0.6666)
1120         (minimum-length . 2.0)
1121         (self-alignment-Y . ,CENTER)
1122         (springs-and-rods . ,ly:spanner::set-spacing-rods)
1123         (stencil . ,ly:hairpin::print)
1124         (thickness . 1.0)
1125         (to-barline . #t)
1126         (vertical-skylines . ,grob::unpure-vertical-skylines-from-stencil)
1127         (Y-extent . ,(grob::unpure-Y-extent-from-stencil ly:hairpin::pure-height))
1128         (Y-offset . ,self-alignment-interface::y-aligned-on-self)
1129         (meta . ((class . Spanner)
1130                  (interfaces . (dynamic-interface
1131                                 hairpin-interface
1132                                 line-interface
1133                                 self-alignment-interface
1134                                 spanner-interface))))))
1135
1136     (HorizontalBracket
1137      . (
1138         (bracket-flare . (0.5 . 0.5))
1139         (connect-to-neighbor . ,ly:tuplet-bracket::calc-connect-to-neighbors)
1140         (direction . ,DOWN)
1141         (padding . 0.2)
1142         (side-axis . ,Y)
1143         (staff-padding . 0.2)
1144         (stencil . ,ly:horizontal-bracket::print)
1145         (thickness . 1.0)
1146         (Y-offset . ,side-position-interface::y-aligned-side)
1147         (meta . ((class . Spanner)
1148                  (interfaces . (horizontal-bracket-interface
1149                                 line-interface
1150                                 side-position-interface
1151                                 spanner-interface))))))
1152
1153
1154     (InstrumentName
1155      . (
1156         (direction . ,LEFT)
1157         (padding . 0.3)
1158         (self-alignment-X . ,CENTER)
1159         (self-alignment-Y . ,CENTER)
1160         (stencil . ,system-start-text::print)
1161         (X-offset . ,system-start-text::calc-x-offset)
1162         (Y-offset . ,system-start-text::calc-y-offset)
1163         (meta . ((class . Spanner)
1164                  (interfaces . (font-interface
1165                                 self-alignment-interface
1166                                 side-position-interface
1167                                 system-start-text-interface))))))
1168
1169     (InstrumentSwitch
1170      . (
1171         (direction . ,UP)
1172         (extra-spacing-width . (+inf.0 . -inf.0))
1173         (outside-staff-priority . 500)
1174         (padding . 0.5)
1175         (self-alignment-X . ,LEFT)
1176         (side-axis . ,Y)
1177         (staff-padding . 0.5)
1178         (stencil . ,ly:text-interface::print)
1179         (Y-extent . ,grob::always-Y-extent-from-stencil)
1180         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
1181         (Y-offset . ,side-position-interface::y-aligned-side)
1182         (meta . ((class . Item)
1183                  (interfaces . (font-interface
1184                                 self-alignment-interface
1185                                 side-position-interface
1186                                 text-interface))))))
1187
1188
1189     (KeyCancellation
1190      . (
1191         (break-align-symbol . key-cancellation)
1192         (break-visibility . ,begin-of-line-invisible)
1193         (glyph-name-alist . ,cancellation-glyph-name-alist)
1194         (non-musical . #t)
1195         (flat-positions . (2 3 4 2 1 2 1))
1196         (sharp-positions . (4 5 4 2 3 2 3))
1197         (space-alist . (
1198                         (time-signature . (extra-space . 1.25))
1199                         (staff-bar . (extra-space . 0.6))
1200                         (key-signature . (extra-space . 0.5))
1201                         (cue-clef . (extra-space . 0.5))
1202                         (right-edge . (extra-space . 0.5))
1203                         (first-note . (fixed-space . 2.5))))
1204         (stencil . ,ly:key-signature-interface::print)
1205         (vertical-skylines . ,grob::always-vertical-skylines-from-stencil)
1206         (Y-extent . ,grob::always-Y-extent-from-stencil)
1207         (extra-spacing-width . (0.0 . 1.0))
1208         (extra-spacing-height . ,pure-from-neighbor-interface::extra-spacing-height-including-staff)
1209         (Y-offset . ,staff-symbol-referencer::callback)
1210         (meta . ((class . Item)
1211                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1212                                       (pure-relevant-grobs . ,ly:pure-from-neighbor-interface::calc-pure-relevant-grobs)))
1213                  (interfaces . (break-aligned-interface
1214                                 font-interface
1215                                 key-cancellation-interface
1216                                 key-signature-interface
1217                                 pure-from-neighbor-interface
1218                                 staff-symbol-referencer-interface))))))
1219
1220     (KeySignature
1221      . (
1222         (avoid-slur . inside)
1223         (break-align-anchor . ,ly:break-aligned-interface::calc-extent-aligned-anchor)
1224         (break-align-anchor-alignment . ,RIGHT)
1225         (break-align-symbol . key-signature)
1226         (break-visibility . ,begin-of-line-visible)
1227         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
1228         (non-musical . #t)
1229         (flat-positions . (2 3 4 2 1 2 1))
1230         (sharp-positions . (4 5 4 2 3 2 3))
1231         (space-alist . (
1232                         (time-signature . (extra-space . 1.15))
1233                         (staff-bar . (extra-space . 1.1))
1234                         (cue-clef . (extra-space . 0.5))
1235                         (right-edge . (extra-space . 0.5))
1236                         (first-note . (fixed-space . 2.5))))
1237         (stencil . ,ly:key-signature-interface::print)
1238         (Y-extent . ,grob::always-Y-extent-from-stencil)
1239         (extra-spacing-width . (0.0 . 1.0))
1240         (extra-spacing-height . ,pure-from-neighbor-interface::extra-spacing-height-including-staff)
1241         (vertical-skylines . ,grob::always-vertical-skylines-from-stencil)
1242         (Y-offset . ,staff-symbol-referencer::callback)
1243         (meta . ((class . Item)
1244                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1245                                       (pure-relevant-grobs . ,ly:pure-from-neighbor-interface::calc-pure-relevant-grobs)))
1246                  (interfaces . (break-aligned-interface
1247                                 font-interface
1248                                 key-signature-interface
1249                                 pure-from-neighbor-interface
1250                                 staff-symbol-referencer-interface))))))
1251
1252     (KievanLigature
1253      . (
1254         (springs-and-rods . ,ly:spanner::set-spacing-rods)
1255         (stencil . ,ly:kievan-ligature::print)
1256         (padding . 0.5)
1257         (meta . ((class . Spanner)
1258                  (interfaces . (font-interface
1259                                 kievan-ligature-interface))))))
1260
1261     (LaissezVibrerTie
1262      . (
1263         (control-points . ,ly:semi-tie::calc-control-points)
1264         (cross-staff . ,semi-tie::calc-cross-staff)
1265         (details . ((ratio . 0.333)
1266                     (height-limit . 1.0)))
1267         (direction . ,ly:tie::calc-direction)
1268         (head-direction . ,LEFT)
1269         (stencil  . ,laissez-vibrer::print)
1270         (thickness . 1.0)
1271         (extra-spacing-height . (-0.5 . 0.5))
1272         (vertical-skylines . ,grob::always-vertical-skylines-from-stencil)
1273         (Y-extent . ,grob::always-Y-extent-from-stencil)
1274         (meta . ((class . Item)
1275                  (interfaces . (semi-tie-interface))))))
1276
1277     (LaissezVibrerTieColumn
1278      . (
1279         (head-direction . ,ly:semi-tie-column::calc-head-direction)
1280         (positioning-done . ,ly:semi-tie-column::calc-positioning-done)
1281         (X-extent . #f)
1282         (Y-extent . #f)
1283         (meta . ((class . Item)
1284                  (interfaces . (semi-tie-column-interface))))))
1285
1286     (LedgerLineSpanner
1287      . (
1288         (layer . 0)
1289         (length-fraction . 0.25)
1290         (minimum-length-fraction . 0.25)
1291         (springs-and-rods . ,ly:ledger-line-spanner::set-spacing-rods)
1292         (stencil . ,ly:ledger-line-spanner::print)
1293         (vertical-skylines . ,grob::unpure-vertical-skylines-from-stencil)
1294         (X-extent . #f)
1295         (Y-extent . #f)
1296         (meta . ((class . Spanner)
1297                  (interfaces . (ledger-line-spanner-interface))))))
1298
1299     (LeftEdge
1300      . (
1301         (break-align-anchor . ,ly:break-aligned-interface::calc-extent-aligned-anchor)
1302         (break-align-symbol . left-edge)
1303         (break-visibility . ,center-invisible)
1304         (non-musical . #t)
1305         (extra-spacing-height . (+inf.0 . -inf.0))
1306         (space-alist . (
1307                         (ambitus . (extra-space . 2.0))
1308                         (breathing-sign . (minimum-space . 0.0))
1309                         (cue-end-clef . (extra-space . 0.8))
1310                         (clef . (extra-space . 0.8))
1311                         (cue-clef . (extra-space . 0.8))
1312                         (staff-bar . (extra-space . 0.0))
1313                         (key-cancellation . (extra-space . 0.0))
1314                         (key-signature . (extra-space . 0.8))
1315                         (time-signature . (extra-space . 1.0))
1316                         (custos . (extra-space . 0.0))
1317                         (first-note . (fixed-space . 2.0))
1318                         (right-edge . (extra-space . 0.0))
1319                         ))
1320         (X-extent . (0 . 0))
1321         (meta . ((class . Item)
1322                  (interfaces . (break-aligned-interface))))))
1323
1324     (LigatureBracket
1325      . (
1326         ;; ugh.  A ligature bracket is totally different from
1327         ;; a tuplet bracket.
1328
1329         (bracket-visibility . #t)
1330         (connect-to-neighbor . ,ly:tuplet-bracket::calc-connect-to-neighbors)
1331         (direction . ,UP)
1332         (edge-height . (0.7 . 0.7))
1333         (padding . 2.0)
1334         (positions . ,ly:tuplet-bracket::calc-positions)
1335         (shorten-pair . (-0.2 . -0.2))
1336         (staff-padding . 0.25)
1337         (stencil . ,ly:tuplet-bracket::print)
1338         (thickness . 1.6)
1339         (X-positions . ,ly:tuplet-bracket::calc-x-positions)
1340         (meta . ((class . Spanner)
1341                  (interfaces . (line-interface
1342                                 tuplet-bracket-interface))))))
1343
1344     (LyricExtender
1345      . (
1346         (minimum-length . 1.5)
1347         (stencil . ,ly:lyric-extender::print)
1348         (thickness . 0.8) ; line-thickness
1349         (Y-extent . (0 . 0))
1350         (meta . ((class . Spanner)
1351                  (interfaces . (lyric-extender-interface
1352                                 lyric-interface))))))
1353
1354     (LyricHyphen
1355      . (
1356         (after-line-breaking . ,ly:spanner::kill-zero-spanned-time)
1357         (dash-period . 10.0)
1358         (height . 0.42)
1359         (length . 0.66)
1360         (minimum-distance . 0.1)
1361         (minimum-length . 0.3)
1362         (padding . 0.07)
1363         (springs-and-rods . ,ly:lyric-hyphen::set-spacing-rods)
1364         (stencil . ,ly:lyric-hyphen::print)
1365         (vertical-skylines . ,grob::unpure-vertical-skylines-from-stencil)
1366         (thickness . 1.3)
1367         (Y-extent . (0 . 0))
1368         (meta . ((class . Spanner)
1369                  (interfaces . (font-interface
1370                                 lyric-hyphen-interface
1371                                 lyric-interface
1372                                 spanner-interface))))))
1373
1374     (LyricSpace
1375      . (
1376         (minimum-distance . 0.45)
1377         (padding . 0.0)
1378         (springs-and-rods . ,ly:lyric-hyphen::set-spacing-rods)
1379         (X-extent . #f)
1380         (Y-extent . #f)
1381         (meta . ((class . Spanner)
1382                  (interfaces . (lyric-hyphen-interface
1383                                 spanner-interface))))))
1384
1385     (LyricText
1386      . (
1387         (extra-spacing-width . (0.0 . 0.0))
1388         ;; Recede in height for purposes of note spacing,
1389         ;; so notes in melismata can be freely spaced above lyrics
1390         (extra-spacing-height . (0.2 . -0.2))
1391         (font-series . medium)
1392         (font-size . 1.0)
1393         (self-alignment-X . ,CENTER)
1394         (stencil . ,lyric-text::print)
1395         (text . ,(grob::calc-property-by-copy 'text))
1396         (word-space . 0.6)
1397         (skyline-horizontal-padding . 0.1)
1398         (vertical-skylines . ,grob::always-vertical-skylines-from-stencil)
1399         (X-offset . ,ly:self-alignment-interface::aligned-on-x-parent)
1400         (Y-extent . ,grob::always-Y-extent-from-stencil)
1401         (meta . ((class . Item)
1402                  (interfaces . (font-interface
1403                                 lyric-syllable-interface
1404                                 rhythmic-grob-interface
1405                                 self-alignment-interface
1406                                 text-interface))))))
1407
1408     (MeasureCounter
1409      . (
1410         (count-from . 1)
1411         (direction . ,UP)
1412         (font-encoding . fetaText)
1413         (font-size . -2)
1414         (outside-staff-horizontal-padding . 0.5)
1415         (outside-staff-priority . 750)
1416         (self-alignment-X . ,CENTER)
1417         (side-axis . ,Y)
1418         (staff-padding . 0.5)
1419         (stencil . ,measure-counter-stencil)
1420         (meta . ((class . Spanner)
1421                  (interfaces . (font-interface
1422                                 measure-counter-interface
1423                                 self-alignment-interface
1424                                 side-position-interface
1425                                 text-interface))))))
1426
1427     (MeasureGrouping
1428      . (
1429         (direction . ,UP)
1430         (height . 2.0)
1431         (padding . 2)
1432         (side-axis . ,Y)
1433         (staff-padding . 3)
1434         (stencil . ,ly:measure-grouping::print)
1435         (thickness . 1)
1436         (Y-offset . ,side-position-interface::y-aligned-side)
1437         (meta . ((class . Spanner)
1438                  (interfaces . (measure-grouping-interface
1439                                 side-position-interface))))))
1440
1441     (MelodyItem
1442      . (
1443         (neutral-direction . ,DOWN)
1444         (meta . ((class . Item)
1445                  (interfaces . (melody-spanner-interface))))))
1446
1447     (MensuralLigature
1448      . (
1449         (springs-and-rods . ,ly:spanner::set-spacing-rods)
1450         (stencil . ,ly:mensural-ligature::print)
1451         (thickness . 1.3)
1452         (meta . ((class . Spanner)
1453                  (interfaces . (font-interface
1454                                 mensural-ligature-interface))))))
1455
1456     (MetronomeMark
1457      . (
1458         (after-line-breaking . ,ly:side-position-interface::move-to-extremal-staff)
1459         (break-visibility . ,end-of-line-invisible)
1460         (direction . ,UP)
1461         (extra-spacing-width . (+inf.0 . -inf.0))
1462         (flag-style . default)
1463         (outside-staff-horizontal-padding . 0.2)
1464         (outside-staff-priority . 1000)
1465         (padding . 0.8)
1466         (side-axis . ,Y)
1467         (stencil . ,ly:text-interface::print)
1468         (vertical-skylines . ,grob::always-vertical-skylines-from-stencil)
1469         (Y-offset . ,side-position-interface::y-aligned-side)
1470         (X-offset . ,(ly:make-simple-closure
1471                       `(,+
1472                         ,(ly:make-simple-closure
1473                           (list ly:break-alignable-interface::self-align-callback))
1474                         ,(ly:make-simple-closure
1475                           (list ly:self-alignment-interface::x-aligned-on-self)))))
1476         (self-alignment-X . ,LEFT)
1477         (break-align-symbols . (time-signature))
1478         (non-break-align-symbols . (paper-column-interface))
1479         (Y-extent . ,grob::always-Y-extent-from-stencil)
1480         (meta . ((class . Item)
1481                  (interfaces . (break-alignable-interface
1482                                 font-interface
1483                                 metronome-mark-interface
1484                                 self-alignment-interface
1485                                 side-position-interface
1486                                 text-interface))))))
1487
1488     (MultiMeasureRest
1489      . (
1490         (expand-limit . 10)
1491         (hair-thickness . 2.0)
1492         (round-up-exceptions . ())
1493         (padding . 1)
1494         (spacing-pair . (break-alignment . break-alignment))
1495         (springs-and-rods . ,ly:multi-measure-rest::set-spacing-rods)
1496         (stencil . ,ly:multi-measure-rest::print)
1497         (thick-thickness . 6.6)
1498         ;; See Wanske pp. 125
1499         (usable-duration-logs . ,(iota 4 -3))
1500         (Y-extent . ,(ly:make-unpure-pure-container ly:multi-measure-rest::height))
1501         (Y-offset . ,staff-symbol-referencer::callback)
1502         (meta . ((class . Spanner)
1503                  (interfaces . (font-interface
1504                                 multi-measure-interface
1505                                 multi-measure-rest-interface
1506                                 rest-interface
1507                                 staff-symbol-referencer-interface))))))
1508
1509     (MultiMeasureRestNumber
1510      . (
1511         (bound-padding  . 2.0)
1512         (direction . ,UP)
1513         (font-encoding . fetaText)
1514         (padding . 0.4)
1515         (self-alignment-X . ,CENTER)
1516         (side-axis . ,Y)
1517         (springs-and-rods . ,ly:multi-measure-rest::set-text-rods)
1518         (staff-padding . 0.4)
1519         (stencil . ,ly:text-interface::print)
1520         (X-offset . ,(ly:make-simple-closure
1521                       `(,+
1522                         ,(ly:make-simple-closure
1523                           (list ly:self-alignment-interface::x-aligned-on-self))
1524                         ,(ly:make-simple-closure
1525                           (list ly:self-alignment-interface::x-centered-on-y-parent)))))
1526         (Y-offset . ,side-position-interface::y-aligned-side)
1527         (vertical-skylines . ,grob::unpure-vertical-skylines-from-stencil)
1528         (Y-extent . ,grob::always-Y-extent-from-stencil)
1529         (meta . ((class . Spanner)
1530                  (interfaces . (font-interface
1531                                 multi-measure-interface
1532                                 self-alignment-interface
1533                                 side-position-interface
1534                                 text-interface))))))
1535
1536     (MultiMeasureRestText
1537      . (
1538         (direction . ,UP)
1539         (outside-staff-priority . 450)
1540         (padding . 0.2)
1541         (self-alignment-X . ,CENTER)
1542         (skyline-horizontal-padding . 0.2)
1543         (staff-padding . 0.25)
1544         (stencil . ,ly:text-interface::print)
1545         (X-offset . ,(ly:make-simple-closure
1546                       `(,+
1547                         ,(ly:make-simple-closure
1548                           (list ly:self-alignment-interface::x-centered-on-y-parent))
1549                         ,(ly:make-simple-closure
1550                           (list ly:self-alignment-interface::x-aligned-on-self)))))
1551         (Y-offset . ,side-position-interface::y-aligned-side)
1552         (vertical-skylines . ,grob::unpure-vertical-skylines-from-stencil)
1553         (Y-extent . ,grob::always-Y-extent-from-stencil)
1554         (meta . ((class . Spanner)
1555                  (interfaces . (font-interface
1556                                 multi-measure-interface
1557                                 self-alignment-interface
1558                                 side-position-interface
1559                                 text-interface))))))
1560
1561
1562     (NonMusicalPaperColumn
1563      . (
1564         (allow-loose-spacing . #t)
1565         (axes . (,X))
1566         (before-line-breaking . ,ly:paper-column::before-line-breaking)
1567         (bound-alignment-interfaces . (break-alignment-interface))
1568         ;; used by Paper_column::print when debugging columns:
1569         (font-size . -7.5)
1570         (full-measure-extra-space . 1.0)
1571         (horizontal-skylines . ,ly:separation-item::calc-skylines)
1572         ;;                    (stencil . ,ly:paper-column::print)
1573
1574         (keep-inside-line . #t)
1575         ;; used by Paper_column::print when debugging columns:
1576         (layer . 1000)
1577         (line-break-permission . allow)
1578         (non-musical . #t)
1579         (page-break-permission . allow)
1580         (X-extent . ,ly:axis-group-interface::width)
1581         (meta . ((class . Paper_column)
1582                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1583                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
1584                  (interfaces . (axis-group-interface
1585                                 font-interface
1586                                 paper-column-interface
1587                                 separation-item-interface
1588                                 spaceable-grob-interface))))))
1589
1590     (NoteCollision
1591      . (
1592         (axes . (,X ,Y))
1593         (positioning-done . ,ly:note-collision-interface::calc-positioning-done)
1594         (prefer-dotted-right . #t)
1595         (X-extent . ,ly:axis-group-interface::width)
1596         (Y-extent . ,axis-group-interface::height)
1597         (meta . ((class . Item)
1598                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1599                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
1600                  (interfaces . (axis-group-interface
1601                                 note-collision-interface))))))
1602
1603     (NoteColumn
1604      . (
1605         (axes . (,X ,Y))
1606         (bound-alignment-interfaces . (rhythmic-head-interface stem-interface))
1607         (horizontal-skylines . ,ly:separation-item::calc-skylines)
1608         (skyline-vertical-padding . 0.15)
1609         (X-extent . ,ly:axis-group-interface::width)
1610         (Y-extent . ,axis-group-interface::height)
1611         (meta . ((class . Item)
1612                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1613                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
1614                  (interfaces . (axis-group-interface
1615                                 note-column-interface
1616                                 separation-item-interface))))))
1617
1618     (NoteHead
1619      . (
1620         (flexa-width . 2.0)
1621         (duration-log . ,note-head::calc-duration-log)
1622         (extra-spacing-height . ,ly:note-head::include-ledger-line-height)
1623         (glyph-name . ,note-head::calc-glyph-name)
1624         (ligature-flexa . #f)
1625         (stem-attachment . ,ly:note-head::calc-stem-attachment)
1626         (stencil . ,ly:note-head::print)
1627         (X-offset . ,ly:note-head::stem-x-shift)
1628         (Y-offset . ,staff-symbol-referencer::callback)
1629         (Y-extent . ,grob::always-Y-extent-from-stencil)
1630         (meta . ((class . Item)
1631                  (interfaces . (font-interface
1632                                 gregorian-ligature-interface
1633                                 ledgered-interface
1634                                 ligature-head-interface
1635                                 mensural-ligature-interface
1636                                 note-head-interface
1637                                 rhythmic-grob-interface
1638                                 rhythmic-head-interface
1639                                 staff-symbol-referencer-interface
1640                                 vaticana-ligature-interface))))))
1641
1642     (NoteName
1643      . (
1644         (stencil . ,ly:text-interface::print)
1645         (Y-extent . ,grob::always-Y-extent-from-stencil)
1646         (meta . ((class . Item)
1647                  (interfaces . (font-interface
1648                                 note-name-interface
1649                                 text-interface))))))
1650
1651     (NoteSpacing
1652      . (
1653         ;; Changed this from 0.75.
1654         ;; If you ever change this back, please document! --hwn
1655         (knee-spacing-correction . 1.0)
1656         (same-direction-correction . 0.25)
1657         (space-to-barline . #t)
1658         (stem-spacing-correction . 0.5)
1659         (meta . ((class . Item)
1660                  (interfaces . (note-spacing-interface
1661                                 spacing-interface))))))
1662
1663     (OttavaBracket
1664      . (
1665         (dash-fraction . 0.3)
1666         (direction . ,UP)
1667         (edge-height . (0 . 1.2))
1668         (font-shape . italic)
1669         (minimum-length . 1.0)
1670         (outside-staff-priority . 400)
1671         (padding . 0.5)
1672         (shorten-pair . (0.0 . -0.6))
1673         (staff-padding . 2.0)
1674         (stencil . ,ly:ottava-bracket::print)
1675         (style . dashed-line)
1676         (vertical-skylines . ,grob::unpure-vertical-skylines-from-stencil)
1677         (Y-offset . ,side-position-interface::y-aligned-side)
1678         (meta . ((class . Spanner)
1679                  (interfaces . (font-interface
1680                                 horizontal-bracket-interface
1681                                 line-interface
1682                                 ottava-bracket-interface
1683                                 side-position-interface
1684                                 text-interface))))))
1685
1686
1687     (PaperColumn
1688      . (
1689         (allow-loose-spacing . #t)
1690         (axes . (,X))
1691         (before-line-breaking . ,ly:paper-column::before-line-breaking)
1692         (bound-alignment-interfaces . (note-column-interface))
1693         ;; used by Paper_column::print when debugging columns:
1694         (font-size . -7.5)
1695         (horizontal-skylines . ,ly:separation-item::calc-skylines)
1696         (keep-inside-line . #t)
1697         ;; used by Paper_column::print when debugging columns:
1698         (layer . 1000)
1699         ;; 0.08 comes from spacing-horizontal-skyline.ly
1700         ;; allows double flat of F to be nestled over dots of C
1701         (skyline-vertical-padding . 0.08)
1702         ;; (stencil . ,ly:paper-column::print)
1703         (X-extent . ,ly:axis-group-interface::width)
1704         (meta . ((class . Paper_column)
1705                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1706                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
1707                  (interfaces . (axis-group-interface
1708                                 font-interface
1709                                 paper-column-interface
1710                                 separation-item-interface
1711                                 spaceable-grob-interface))))))
1712
1713     (ParenthesesItem
1714      . (
1715         (font-size . -6)
1716         (padding . 0.2)
1717         (stencil . ,parentheses-item::print)
1718         (stencils . ,parentheses-item::calc-parenthesis-stencils)
1719         ;; X-extent needs to be non-empty in order to allow proper
1720         ;; horizontal attachment.  ParenthesesItem does not reserve
1721         ;; space of its own, however.
1722         (X-extent . (0 . 0))
1723         (meta . ((class . Item)
1724                  (interfaces . (font-interface
1725                                 parentheses-interface))))))
1726
1727     (PercentRepeat
1728      . (
1729         (dot-negative-kern . 0.75)
1730         (font-encoding . fetaMusic)
1731         (slope . 1.0)
1732         (spacing-pair . (break-alignment . staff-bar))
1733         (springs-and-rods . ,ly:multi-measure-rest::set-spacing-rods)
1734         (stencil . ,ly:multi-measure-rest::percent)
1735         (thickness . 0.48)
1736         (meta . ((class . Spanner)
1737                  (interfaces . (font-interface
1738                                 multi-measure-rest-interface
1739                                 percent-repeat-interface))))))
1740
1741     (PercentRepeatCounter
1742      . (
1743         (direction . ,UP)
1744         (font-encoding . fetaText)
1745         (font-size . -2)
1746         (padding . 0.2)
1747         (self-alignment-X . ,CENTER)
1748         (staff-padding . 0.25)
1749         (stencil . ,ly:text-interface::print)
1750         (X-offset . ,(ly:make-simple-closure
1751                       `(,+
1752                         ,(ly:make-simple-closure
1753                           (list ly:self-alignment-interface::x-centered-on-y-parent))
1754                         ,(ly:make-simple-closure
1755                           (list ly:self-alignment-interface::x-aligned-on-self)))))
1756         (Y-offset . ,side-position-interface::y-aligned-side)
1757         (Y-extent . ,grob::always-Y-extent-from-stencil)
1758         (meta . ((class . Spanner)
1759                  (interfaces . (font-interface
1760                                 percent-repeat-interface
1761                                 self-alignment-interface
1762                                 side-position-interface
1763                                 text-interface))))))
1764
1765     (PhrasingSlur
1766      . (
1767         (control-points . ,ly:slur::calc-control-points)
1768         (cross-staff . ,ly:slur::calc-cross-staff)
1769         (details . ,default-slur-details)
1770         (direction . ,ly:slur::calc-direction)
1771         (height-limit . 2.0)
1772         (minimum-length . 1.5)
1773         (ratio . 0.333)
1774         (spanner-id . "")
1775         (springs-and-rods . ,ly:spanner::set-spacing-rods)
1776         (stencil . ,ly:slur::print)
1777         (thickness . 1.1)
1778         (vertical-skylines . ,(ly:make-unpure-pure-container ly:slur::vertical-skylines ly:grob::pure-simple-vertical-skylines-from-extents))
1779         (Y-extent . ,slur::height)
1780         (meta . ((class . Spanner)
1781                  (interfaces . (slur-interface))))))
1782
1783     ;; an example of a text spanner
1784     (PianoPedalBracket
1785      . (
1786         (bound-padding . 1.0)
1787         (bracket-flare . (0.5 . 0.5))
1788         (direction . ,DOWN)
1789         (edge-height . (1.0 . 1.0))
1790         (shorten-pair . (0.0 . 0.0))
1791         (stencil . ,ly:piano-pedal-bracket::print)
1792         (style . line)
1793         (thickness .  1.0)
1794         (vertical-skylines . ,grob::unpure-vertical-skylines-from-stencil)
1795         (meta . ((class . Spanner)
1796                  (interfaces . (line-interface
1797                                 piano-pedal-bracket-interface
1798                                 piano-pedal-interface))))))
1799
1800
1801     (RehearsalMark
1802      . (
1803         (after-line-breaking . ,ly:side-position-interface::move-to-extremal-staff)
1804         (baseline-skip . 2)
1805         (break-align-symbols . (staff-bar key-signature clef))
1806         (break-visibility . ,end-of-line-invisible)
1807         (direction . ,UP)
1808         (extra-spacing-width . (+inf.0 . -inf.0))
1809         (font-size . 2)
1810         (non-musical . #t)
1811         (outside-staff-horizontal-padding . 0.2)
1812         (outside-staff-priority . 1500)
1813         (padding . 0.8)
1814         (self-alignment-X . ,CENTER)
1815         (stencil . ,ly:text-interface::print)
1816         (vertical-skylines . ,grob::always-vertical-skylines-from-stencil)
1817         (X-offset . ,(ly:make-simple-closure
1818                       `(,+
1819                         ,(ly:make-simple-closure
1820                           (list ly:break-alignable-interface::self-align-callback))
1821                         ,(ly:make-simple-closure
1822                           (list ly:self-alignment-interface::x-aligned-on-self)))))
1823         (Y-offset . ,side-position-interface::y-aligned-side)
1824         (Y-extent . ,grob::always-Y-extent-from-stencil)
1825         (meta . ((class . Item)
1826                  (interfaces . (break-alignable-interface
1827                                 font-interface
1828                                 mark-interface
1829                                 self-alignment-interface
1830                                 side-position-interface
1831                                 text-interface))))))
1832
1833     (RepeatSlash
1834      . (
1835         (slash-negative-kern . 0.85)
1836         (slope . 1.7)
1837         (stencil . ,ly:percent-repeat-item-interface::beat-slash)
1838         (Y-extent . ,grob::always-Y-extent-from-stencil)
1839         (thickness . 0.48)
1840         (meta . ((class . Item)
1841                  (interfaces . (percent-repeat-interface
1842                                 percent-repeat-item-interface
1843                                 rhythmic-grob-interface))))))
1844
1845     (RepeatTie
1846      . (
1847         (cross-staff . ,semi-tie::calc-cross-staff)
1848         (control-points . ,ly:semi-tie::calc-control-points)
1849         (details . ((ratio . 0.333)
1850                     (height-limit . 1.0)))
1851         (direction . ,ly:tie::calc-direction)
1852         (head-direction . ,RIGHT)
1853         (stencil  . ,ly:tie::print)
1854         (thickness . 1.0)
1855         (extra-spacing-height . (-0.5 . 0.5))
1856         (Y-extent . ,grob::always-Y-extent-from-stencil)
1857         (vertical-skylines . ,grob::always-vertical-skylines-from-stencil)
1858         (meta . ((class . Item)
1859                  (interfaces . (semi-tie-interface))))))
1860
1861     (RepeatTieColumn
1862      . (
1863         (direction . ,ly:tie::calc-direction)
1864         (head-direction . ,ly:semi-tie-column::calc-head-direction)
1865         (positioning-done . ,ly:semi-tie-column::calc-positioning-done)
1866         (X-extent . #f)
1867         (Y-extent . #f)
1868         (meta . ((class . Item)
1869                  (interfaces . (semi-tie-column-interface))))))
1870
1871     (Rest
1872      . (
1873         (cross-staff . ,ly:rest::calc-cross-staff)
1874         (duration-log . ,stem::calc-duration-log)
1875         (minimum-distance . 0.25)
1876         (stencil . ,ly:rest::print)
1877         (X-extent . ,ly:rest::width)
1878         (Y-extent . ,(ly:make-unpure-pure-container ly:rest::height ly:rest::pure-height))
1879         (Y-offset . ,(ly:make-unpure-pure-container ly:rest::y-offset-callback))
1880         (vertical-skylines . ,grob::unpure-vertical-skylines-from-stencil)
1881         (meta . ((class . Item)
1882                  (interfaces . (font-interface
1883                                 rest-interface
1884                                 rhythmic-grob-interface
1885                                 rhythmic-head-interface
1886                                 staff-symbol-referencer-interface))))))
1887
1888     (RestCollision
1889      . (
1890         (minimum-distance . 0.75)
1891         (positioning-done . ,ly:rest-collision::calc-positioning-done)
1892         (meta . ((class . Item)
1893                  (interfaces . (rest-collision-interface))))))
1894
1895
1896     (Script
1897      . (
1898         (add-stem-support . #t)
1899         (cross-staff . ,ly:script-interface::calc-cross-staff)
1900         (direction . ,ly:script-interface::calc-direction)
1901         (font-encoding . fetaMusic)
1902         (positioning-done . ,ly:script-interface::calc-positioning-done)
1903         (side-axis . ,Y)
1904
1905         ;; padding set in script definitions.
1906         (slur-padding . 0.2)
1907         (staff-padding . 0.25)
1908
1909         (stencil . ,ly:script-interface::print)
1910         (vertical-skylines . ,grob::always-vertical-skylines-from-stencil)
1911         (Y-extent . ,grob::always-Y-extent-from-stencil)
1912         (X-offset . ,script-interface::calc-x-offset)
1913         (Y-offset . ,side-position-interface::y-aligned-side)
1914         (meta . ((class . Item)
1915                  (interfaces . (font-interface
1916                                 script-interface
1917                                 side-position-interface))))))
1918
1919     (ScriptColumn
1920      . (
1921         (before-line-breaking . ,ly:script-column::before-line-breaking)
1922         (meta . ((class . Item)
1923                  (interfaces . (script-column-interface))))))
1924
1925     (ScriptRow
1926      . (
1927         (before-line-breaking . ,ly:script-column::row-before-line-breaking)
1928         (meta . ((class . Item)
1929                  (interfaces . (script-column-interface))))))
1930
1931     (Slur
1932      . (
1933         (avoid-slur . inside)
1934         (control-points . ,ly:slur::calc-control-points)
1935         (cross-staff . ,ly:slur::calc-cross-staff)
1936         (details . ,default-slur-details)
1937         (direction . ,ly:slur::calc-direction)
1938         (height-limit . 2.0)
1939         (line-thickness . 0.8)
1940         (minimum-length . 1.5)
1941         (ratio . 0.25)
1942         (spanner-id . "")
1943         (springs-and-rods . ,ly:spanner::set-spacing-rods)
1944         (stencil . ,ly:slur::print)
1945         (thickness . 1.2)
1946         (vertical-skylines . ,(ly:make-unpure-pure-container ly:slur::vertical-skylines ly:grob::pure-simple-vertical-skylines-from-extents))
1947         (Y-extent . ,slur::height)
1948         (meta . ((class . Spanner)
1949                  (interfaces . (slur-interface))))))
1950
1951     (SostenutoPedal
1952      . (
1953         (direction . ,RIGHT)
1954         (extra-spacing-width . (+inf.0 . -inf.0))
1955         (font-shape . italic)
1956         (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
1957         (self-alignment-X . ,CENTER)
1958         (stencil . ,ly:text-interface::print)
1959         (vertical-skylines . ,grob::always-vertical-skylines-from-stencil)
1960         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
1961         (Y-extent . ,grob::always-Y-extent-from-stencil)
1962         (meta . ((class . Item)
1963                  (interfaces . (font-interface
1964                                 piano-pedal-script-interface
1965                                 self-alignment-interface
1966                                 text-interface))))))
1967
1968     (SostenutoPedalLineSpanner
1969      . (
1970         (axes . (,Y))
1971         (direction . ,DOWN)
1972         (minimum-space . 1.0)
1973         (outside-staff-priority . 1000)
1974         (padding . 1.2)
1975         (side-axis . ,Y)
1976         (staff-padding . 1.0)
1977         (vertical-skylines . ,grob::always-vertical-skylines-from-element-stencils)
1978         (X-extent . ,ly:axis-group-interface::width)
1979         (Y-extent . ,axis-group-interface::height)
1980         (Y-offset . ,side-position-interface::y-aligned-side)
1981         (meta . ((class . Spanner)
1982                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1983                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
1984                  (interfaces . (axis-group-interface
1985                                 piano-pedal-interface
1986                                 side-position-interface))))))
1987
1988     (SpacingSpanner
1989      . (
1990         (average-spacing-wishes . #t)
1991         (base-shortest-duration . ,(ly:make-moment 3 16))
1992         (common-shortest-duration . ,ly:spacing-spanner::calc-common-shortest-duration)
1993         (shortest-duration-space . 2.0)
1994         (spacing-increment . 1.2)
1995         (springs-and-rods . ,ly:spacing-spanner::set-springs)
1996         (meta . ((class . Spanner)
1997                  (interfaces . (spacing-options-interface
1998                                 spacing-spanner-interface))))))
1999
2000     (SpanBar
2001      . (
2002         (allow-span-bar . #t)
2003         (bar-extent . ,axis-group-interface::height)
2004         (before-line-breaking . ,ly:span-bar::before-line-breaking)
2005         (break-align-symbol . staff-bar)
2006         (cross-staff . #t)
2007         (glyph-name . ,ly:span-bar::calc-glyph-name)
2008         (layer . 0)
2009         (non-musical . #t)
2010         (stencil . ,ly:span-bar::print)
2011         (X-extent . ,ly:span-bar::width)
2012         (Y-extent . (+inf.0 . -inf.0))
2013         (meta . ((class . Item)
2014                  (interfaces . (bar-line-interface
2015                                 font-interface
2016                                 span-bar-interface))))))
2017
2018     (SpanBarStub
2019      . (
2020         (X-extent . ,(grob::inherit-parent-property
2021                       X 'X-extent))
2022         (extra-spacing-height . ,pure-from-neighbor-interface::extra-spacing-height)
2023         ;; we want this to be ignored, so empty, but the extra spacing height
2024         ;; should preserve the span bar's presence for horizontal spacing
2025         (Y-extent . ,pure-from-neighbor-interface::height-if-pure)
2026         (meta . ((class . Item)
2027                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
2028                                       (pure-relevant-grobs . ,ly:pure-from-neighbor-interface::calc-pure-relevant-grobs)))
2029                  (interfaces . (pure-from-neighbor-interface))))))
2030
2031     (StaffGrouper
2032      . (
2033         (staff-staff-spacing . ((basic-distance . 9)
2034                                 (minimum-distance . 7)
2035                                 (padding . 1)
2036                                 (stretchability . 5)))
2037         (staffgroup-staff-spacing . ((basic-distance . 10.5)
2038                                      (minimum-distance . 8)
2039                                      (padding . 1)
2040                                      (stretchability . 9)))
2041         (meta . ((class . Spanner)
2042                  (interfaces . (staff-grouper-interface))))))
2043
2044     (StaffSpacing
2045      . (
2046         (non-musical . #t)
2047         (stem-spacing-correction . 0.4)
2048         (meta . ((class . Item)
2049                  (interfaces . (spacing-interface
2050                                 staff-spacing-interface))))))
2051
2052     (StaffSymbol
2053      . (
2054         (layer . 0)
2055         (ledger-line-thickness . (1.0 . 0.1))
2056         (line-count . 5)
2057         (stencil . ,ly:staff-symbol::print)
2058         (Y-extent . ,(ly:make-unpure-pure-container ly:staff-symbol::height))
2059         (meta . ((class . Spanner)
2060                  (interfaces . (staff-symbol-interface))))))
2061
2062     (StanzaNumber
2063      . (
2064         (direction . ,LEFT)
2065         (font-series . bold)
2066         (padding . 1.0)
2067         (side-axis . ,X)
2068         (stencil . ,ly:text-interface::print)
2069         (X-offset . ,ly:side-position-interface::x-aligned-side)
2070         (Y-extent . ,grob::always-Y-extent-from-stencil)
2071         (meta . ((class . Item)
2072                  (interfaces . (font-interface
2073                                 side-position-interface
2074                                 stanza-number-interface
2075                                 text-interface))))))
2076
2077     (Stem
2078      . (
2079         (beamlet-default-length . (1.1 . 1.1))
2080         (beamlet-max-length-proportion . (0.75 . 0.75))
2081         (cross-staff . ,ly:stem::calc-cross-staff)
2082         (default-direction . ,ly:stem::calc-default-direction)
2083         (details
2084          . (
2085             ;; 3.5 (or 3 measured from note head) is standard length
2086             ;; 32nd, 64th, 128th flagged stems should be longer
2087             (lengths . (3.5 3.5 3.5 4.25 5.0 6.0))
2088
2089             ;; FIXME.  3.5 yields too long beams (according to Ross and
2090             ;; looking at Baerenreiter examples) for a number of common
2091             ;; boundary cases.  Subtracting half a beam thickness fixes
2092             ;; this, but the bug may well be somewhere else.
2093
2094             ;; FIXME this should come from 'lengths
2095             (beamed-lengths . (3.26 3.5 3.6))
2096
2097             ;; The 'normal' minima
2098             (beamed-minimum-free-lengths . (1.83 1.5 1.25))
2099             ;;(beamed-minimum-free-lengths . (2.0 1.83 1.25))
2100
2101             ;; The 'extreme case' minima
2102             (beamed-extreme-minimum-free-lengths . (2.0 1.25))
2103
2104             ;; Stems in unnatural (forced) direction should be shortened by
2105             ;; one staff space, according to [Roush & Gourlay].
2106             ;; Flagged stems we shorten only half a staff space.
2107             (stem-shorten . (1.0 0.5))
2108
2109             ))
2110
2111         ;; We use the normal minima as minimum for the ideal lengths,
2112         ;; and the extreme minima as abolute minimum length.
2113
2114         (direction . ,ly:stem::calc-direction)
2115         (duration-log . ,stem::calc-duration-log)
2116         (length . ,(ly:make-unpure-pure-container ly:stem::calc-length ly:stem::pure-calc-length))
2117         (neutral-direction . ,DOWN)
2118         (positioning-done . ,ly:stem::calc-positioning-done)
2119         (stem-info . ,ly:stem::calc-stem-info)
2120         (stem-begin-position . ,(ly:make-unpure-pure-container ly:stem::calc-stem-begin-position ly:stem::pure-calc-stem-begin-position))
2121         (stencil . ,ly:stem::print)
2122         (thickness . 1.3)
2123         (X-extent . ,ly:stem::width)
2124         (X-offset . ,ly:stem::offset-callback)
2125         (Y-extent . ,(ly:make-unpure-pure-container ly:stem::height ly:stem::pure-height))
2126         (Y-offset . ,staff-symbol-referencer::callback)
2127         (meta . ((class . Item)
2128                  (interfaces . (stem-interface))))))
2129
2130     (StemStub
2131      . (
2132         (X-extent . ,stem-stub::width)
2133         (extra-spacing-height . ,stem-stub::extra-spacing-height)
2134         (Y-extent . ,(ly:make-unpure-pure-container #f stem-stub::pure-height))
2135         (meta . ((class . Item)
2136                  (interfaces . ())))))
2137
2138     (StemTremolo
2139      . (
2140         (beam-thickness . 0.48) ; staff-space
2141         (beam-width . ,ly:stem-tremolo::calc-width) ; staff-space
2142         (direction . ,ly:stem-tremolo::calc-direction)
2143         (slope . ,ly:stem-tremolo::calc-slope)
2144         (stencil . ,ly:stem-tremolo::print)
2145         (style . ,ly:stem-tremolo::calc-style)
2146         (X-extent . ,ly:stem-tremolo::width)
2147         (Y-extent . ,(grob::unpure-Y-extent-from-stencil ly:stem-tremolo::pure-height))
2148         (X-offset . ,(ly:make-simple-closure
2149                       `(,+
2150                         ,(ly:make-simple-closure
2151                           (list ly:self-alignment-interface::centered-on-x-parent))
2152                         ,(ly:make-simple-closure
2153                           (list ly:self-alignment-interface::x-aligned-on-self)))))
2154         (Y-offset . ,(ly:make-unpure-pure-container ly:stem-tremolo::calc-y-offset ly:stem-tremolo::pure-calc-y-offset))
2155         (meta . ((class . Item)
2156                  (interfaces . (self-alignment-interface
2157                                 stem-tremolo-interface))))))
2158
2159     (StringNumber
2160      . (
2161         (avoid-slur . around)
2162         (cross-staff . ,script-or-side-position-cross-staff)
2163         (font-encoding . fetaText)
2164         (font-size . -5)                ; don't overlap when next to heads.
2165         (padding . 0.5)
2166         (script-priority . 100)
2167         (self-alignment-X . ,CENTER)
2168         (self-alignment-Y . ,CENTER)
2169         (staff-padding . 0.5)
2170         (stencil . ,print-circled-text-callback)
2171         (text . ,string-number::calc-text)
2172         (Y-extent . ,grob::always-Y-extent-from-stencil)
2173         (meta . ((class . Item)
2174                  (interfaces . (font-interface
2175                                 self-alignment-interface
2176                                 side-position-interface
2177                                 string-number-interface
2178                                 text-interface
2179                                 text-script-interface))))))
2180
2181     (StrokeFinger
2182      . (
2183         (digit-names . #("p" "i" "m" "a" "x"))
2184         (font-shape . italic)
2185         (font-size . -4)                ; don't overlap when next to heads.
2186         (padding . 0.5)
2187         (script-priority . 100)
2188         (self-alignment-X . ,CENTER)
2189         (self-alignment-Y . ,CENTER)
2190         (staff-padding . 0.5)
2191         (stencil . ,ly:text-interface::print)
2192         (text . ,stroke-finger::calc-text)
2193         (Y-extent . ,grob::always-Y-extent-from-stencil)
2194         (meta . ((class . Item)
2195                  (interfaces . (font-interface
2196                                 self-alignment-interface
2197                                 side-position-interface
2198                                 stroke-finger-interface
2199                                 text-interface
2200                                 text-script-interface))))))
2201
2202     (SustainPedal
2203      . (
2204         (extra-spacing-width . (+inf.0 . -inf.0))
2205         (padding . 0.0)  ;; padding relative to SustainPedalLineSpanner
2206         (self-alignment-X . ,CENTER)
2207         (stencil . ,ly:sustain-pedal::print)
2208         (vertical-skylines . ,grob::always-vertical-skylines-from-stencil)
2209         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
2210         (Y-extent . ,grob::always-Y-extent-from-stencil)
2211         (meta . ((class . Item)
2212                  (interfaces . (font-interface
2213                                 piano-pedal-interface
2214                                 piano-pedal-script-interface
2215                                 self-alignment-interface
2216                                 text-interface))))))
2217
2218     (SustainPedalLineSpanner
2219      . (
2220         (axes . (,Y))
2221         (direction . ,DOWN)
2222         (minimum-space . 1.0)
2223         (outside-staff-priority . 1000)
2224         (padding . 1.2)
2225         (side-axis . ,Y)
2226         (staff-padding . 1.2)
2227         (vertical-skylines . ,grob::always-vertical-skylines-from-element-stencils)
2228         (X-extent . ,ly:axis-group-interface::width)
2229         (Y-extent . ,axis-group-interface::height)
2230         (Y-offset . ,side-position-interface::y-aligned-side)
2231         (meta . ((class . Spanner)
2232                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
2233                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
2234                  (interfaces . (axis-group-interface
2235                                 piano-pedal-interface
2236                                 side-position-interface))))))
2237
2238     (System
2239      . (
2240         (adjacent-pure-heights . ,ly:axis-group-interface::adjacent-pure-heights)
2241         (axes . (,X ,Y))
2242         (outside-staff-placement-directive . left-to-right-polite)
2243         (skyline-horizontal-padding . 1.0)
2244         (vertical-skylines . ,ly:axis-group-interface::calc-skylines)
2245         (X-extent . ,ly:axis-group-interface::width)
2246         (Y-extent . ,(ly:make-unpure-pure-container ly:system::height ly:system::calc-pure-height))
2247         (meta . ((class . System)
2248                  (object-callbacks . ((footnotes-before-line-breaking . ,ly:system::footnotes-before-line-breaking)
2249                                       (footnotes-after-line-breaking . ,ly:system::footnotes-after-line-breaking)
2250                                       (pure-relevant-grobs . ,ly:system::calc-pure-relevant-grobs)
2251                                       (pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
2252                                       (vertical-skyline-elements . ,ly:system::vertical-skyline-elements)
2253                                       (vertical-alignment . ,ly:system::get-vertical-alignment)))
2254                  (interfaces . (axis-group-interface
2255                                 system-interface))))))
2256
2257     (SystemStartBar
2258      . (
2259         (collapse-height . 5.0)
2260         (direction . ,LEFT)
2261
2262         ;; ugh--hardcoded.
2263         (padding . -0.1)  ;; bar must cover rounded ending of staff line.
2264         (stencil . ,ly:system-start-delimiter::print)
2265         (style . bar-line)
2266         (thickness . 1.6)
2267         (X-offset . ,ly:side-position-interface::x-aligned-side)
2268         (meta . ((class . Spanner)
2269                  (interfaces . (side-position-interface
2270                                 system-start-delimiter-interface))))))
2271
2272     (SystemStartBrace
2273      . (
2274         (collapse-height . 5.0)
2275         (direction . ,LEFT)
2276         (font-encoding . fetaBraces)
2277         (padding . 0.3)
2278         (stencil . ,ly:system-start-delimiter::print)
2279         (style . brace)
2280         (X-offset . ,ly:side-position-interface::x-aligned-side)
2281         (meta . ((class . Spanner)
2282                  (interfaces . (font-interface
2283                                 side-position-interface
2284                                 system-start-delimiter-interface))))))
2285
2286     (SystemStartBracket
2287      . (
2288         (collapse-height . 5.0)
2289         (direction . ,LEFT)
2290         (padding . 0.8)
2291         (stencil . ,ly:system-start-delimiter::print)
2292         (style . bracket)
2293         (thickness . 0.45)
2294         (X-offset . ,ly:side-position-interface::x-aligned-side)
2295         (meta . ((class . Spanner)
2296                  (interfaces . (font-interface
2297                                 side-position-interface
2298                                 system-start-delimiter-interface))))))
2299
2300     (SystemStartSquare
2301      . (
2302         (direction . ,LEFT)
2303         (stencil . ,ly:system-start-delimiter::print)
2304         (style . line-bracket)
2305         (thickness . 1.0)
2306         (X-offset . ,ly:side-position-interface::x-aligned-side)
2307         (meta . ((class . Spanner)
2308                  (interfaces . (font-interface
2309                                 side-position-interface
2310                                 system-start-delimiter-interface))))))
2311
2312
2313     (TabNoteHead
2314      . (
2315         (details . ((cautionary-properties . ((angularity . 0.4)
2316                                               (half-thickness . 0.075)
2317                                               (padding . 0)
2318                                               (procedure . ,parenthesize-stencil)
2319                                               (width . 0.25)))
2320                     (head-offset . 3/5)
2321                     (harmonic-properties . ((angularity . 2)
2322                                             (half-thickness . 0.075)
2323                                             (padding . 0)
2324                                             (procedure . ,parenthesize-stencil)
2325                                             (width . 0.25)))
2326                     (repeat-tied-properties . ((note-head-visible . #t)
2327                                                (parenthesize . #t)))
2328                     (tied-properties . ((break-visibility . ,begin-of-line-visible)
2329                                         (parenthesize . #t)))))
2330
2331         (direction . ,CENTER)
2332         (duration-log . ,note-head::calc-duration-log)
2333         (font-series . bold)
2334         (font-size . -2)
2335         (stem-attachment . (0.0 . 1.35))
2336         (stencil . ,tab-note-head::print)
2337         (whiteout . #t)
2338         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
2339         (Y-offset . ,staff-symbol-referencer::callback)
2340         (Y-extent . ,grob::always-Y-extent-from-stencil)
2341         (meta . ((class . Item)
2342                  (interfaces  . (font-interface
2343                                  note-head-interface
2344                                  rhythmic-grob-interface
2345                                  rhythmic-head-interface
2346                                  staff-symbol-referencer-interface
2347                                  tab-note-head-interface
2348                                  text-interface))))))
2349
2350     (TextScript
2351      . (
2352         (avoid-slur . around)
2353         (cross-staff . ,script-or-side-position-cross-staff)
2354         (direction . ,DOWN)
2355         (extra-spacing-width . (+inf.0 . -inf.0))
2356         (outside-staff-horizontal-padding . 0.2)
2357         (outside-staff-priority . 450)
2358
2359         ;; sync with Fingering ?
2360         (padding . 0.3)
2361
2362         (script-priority . 200)
2363         (side-axis . ,Y)
2364         (slur-padding . 0.5)
2365         (staff-padding . 0.5)
2366         (stencil . ,ly:text-interface::print)
2367         (vertical-skylines . ,grob::always-vertical-skylines-from-stencil)
2368         ;; todo: add X self alignment?
2369         (Y-extent . ,grob::always-Y-extent-from-stencil)
2370         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
2371         (Y-offset . ,side-position-interface::y-aligned-side)
2372         (meta . ((class . Item)
2373                  (interfaces . (font-interface
2374                                 instrument-specific-markup-interface
2375                                 self-alignment-interface
2376                                 side-position-interface
2377                                 text-interface
2378                                 text-script-interface))))))
2379
2380     (TextSpanner
2381      . (
2382         (bound-details . ((left . ((Y . 0)
2383                                    (padding . 0.25)
2384                                    (attach-dir . ,LEFT)
2385                                    ))
2386                           (left-broken . ((attach-dir . ,RIGHT)))
2387                           (right . ((Y . 0)
2388                                     (padding . 0.25)
2389                                     ))
2390                           ))
2391         (dash-fraction . 0.2)
2392         (dash-period . 3.0)
2393         (direction . ,UP)
2394         (font-shape . italic)
2395         (left-bound-info . ,ly:line-spanner::calc-left-bound-info)
2396         (outside-staff-priority . 350)
2397         (right-bound-info . ,ly:line-spanner::calc-right-bound-info)
2398         (side-axis . ,Y)
2399         (staff-padding . 0.8)
2400         (stencil . ,ly:line-spanner::print)
2401         (style . dashed-line)
2402         (Y-offset . ,side-position-interface::y-aligned-side)
2403
2404         (meta . ((class . Spanner)
2405                  (interfaces . (font-interface
2406                                 line-interface
2407                                 line-spanner-interface
2408                                 side-position-interface))))))
2409
2410     (Tie
2411      . (
2412         (avoid-slur . inside)
2413         (control-points . ,ly:tie::calc-control-points)
2414         (details . (
2415                     ;; for a full list, see tie-details.cc
2416                     (ratio . 0.333)
2417                     (center-staff-line-clearance . 0.6)
2418                     (tip-staff-line-clearance . 0.45)
2419                     (note-head-gap . 0.2)
2420                     (stem-gap . 0.35)
2421                     (height-limit . 1.0)
2422                     (horizontal-distance-penalty-factor . 10)
2423                     (same-dir-as-stem-penalty . 8)
2424                     (min-length-penalty-factor . 26)
2425                     (tie-tie-collision-distance . 0.45)
2426                     (tie-tie-collision-penalty . 25.0)
2427                     (intra-space-threshold . 1.25)
2428                     (outer-tie-vertical-distance-symmetry-penalty-factor . 10)
2429                     (outer-tie-length-symmetry-penalty-factor . 10)
2430                     (vertical-distance-penalty-factor . 7)
2431                     (outer-tie-vertical-gap . 0.25)
2432                     (multi-tie-region-size . 3)
2433                     (single-tie-region-size . 4)
2434                     (between-length-limit . 1.0)))
2435
2436         (direction . ,ly:tie::calc-direction)
2437         (font-size . -6)
2438         (line-thickness . 0.8)
2439         (neutral-direction . ,UP)
2440         (springs-and-rods . ,ly:spanner::set-spacing-rods)
2441         (stencil . ,ly:tie::print)
2442         (vertical-skylines . ,grob::unpure-vertical-skylines-from-stencil)
2443         (thickness . 1.2)
2444         (meta . ((class . Spanner)
2445                  (interfaces . (tie-interface))))))
2446
2447     (TieColumn
2448      . (
2449         (before-line-breaking . ,ly:tie-column::before-line-breaking)
2450         (positioning-done . ,ly:tie-column::calc-positioning-done)
2451         (X-extent . #f)
2452         (Y-extent . #f)
2453         (meta . ((class . Spanner)
2454                  (interfaces . (tie-column-interface))))))
2455
2456     (TimeSignature
2457      . (
2458         (avoid-slur . inside)
2459         (break-align-anchor
2460          . ,ly:break-aligned-interface::calc-extent-aligned-anchor)
2461         (break-align-symbol . time-signature)
2462         (break-align-anchor-alignment . ,LEFT)
2463         (break-visibility . ,all-visible)
2464         (extra-spacing-height . ,pure-from-neighbor-interface::extra-spacing-height-including-staff)
2465         (extra-spacing-width . (0.0 . 0.8))
2466         (non-musical . #t)
2467         (space-alist . (
2468                         (cue-clef . (extra-space . 1.5))
2469                         (first-note . (fixed-space . 2.0))
2470                         (right-edge . (extra-space . 0.5))
2471                         (staff-bar . (extra-space . 1.0))))
2472         (stencil . ,ly:time-signature::print)
2473         (Y-extent . ,grob::always-Y-extent-from-stencil)
2474         (style . C)
2475         (meta . ((class . Item)
2476                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
2477                                       (pure-relevant-grobs . ,ly:pure-from-neighbor-interface::calc-pure-relevant-grobs)))
2478                  (interfaces . (break-aligned-interface
2479                                 font-interface
2480                                 pure-from-neighbor-interface
2481                                 time-signature-interface))))))
2482
2483     (TrillPitchAccidental
2484      . (
2485         (direction . ,LEFT)
2486         (font-size . -4)
2487         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
2488         (padding . 0.2)
2489         (side-axis . ,X)
2490         (stencil . ,ly:accidental-interface::print)
2491         (X-offset . ,ly:side-position-interface::x-aligned-side)
2492         (Y-extent . ,accidental-interface::height)
2493         (meta . ((class . Item)
2494                  (interfaces . (accidental-interface
2495                                 font-interface
2496                                 inline-accidental-interface
2497                                 side-position-interface
2498                                 trill-pitch-accidental-interface))))))
2499
2500     (TrillPitchGroup
2501      . (
2502         (axes . (,X))
2503         (direction . ,RIGHT)
2504         (font-size . -4)
2505         (padding . 0.3)
2506         (side-axis . ,X)
2507         (stencil . ,parenthesize-elements)
2508         (stencils . ,parentheses-item::calc-parenthesis-stencils)
2509         ;; offset a bit to the right, further if needed to clear the main note
2510         (X-offset . ,(lambda (grob)
2511                        (ly:side-position-interface::x-aligned-side grob 2.5)))
2512         (Y-extent . ,grob::always-Y-extent-from-stencil)
2513         (meta . ((class . Item)
2514                  (interfaces . (axis-group-interface
2515                                 font-interface
2516                                 note-head-interface
2517                                 parentheses-interface
2518                                 side-position-interface))))))
2519
2520     (TrillPitchHead
2521      . (
2522         (duration-log . 2)
2523         (font-size . -4)
2524         (stencil . ,ly:note-head::print)
2525         (Y-offset . ,staff-symbol-referencer::callback)
2526         (Y-extent . ,grob::always-Y-extent-from-stencil)
2527         (meta . ((class . Item)
2528                  (interfaces . (font-interface
2529                                 ledgered-interface
2530                                 pitched-trill-interface
2531                                 rhythmic-head-interface
2532                                 staff-symbol-referencer-interface))))))
2533
2534     (TrillSpanner
2535      . (
2536         (after-line-breaking . ,ly:spanner::kill-zero-spanned-time)
2537         (bound-details . ((left . ((text . ,(make-musicglyph-markup "scripts.trill"))
2538                                    (Y . 0)
2539                                    (stencil-offset . (-0.5 . -1))
2540                                    (padding . 0.5)
2541                                    (attach-dir . ,CENTER)
2542                                    ))
2543                           (left-broken . ((end-on-note . #t)))
2544                           (right . ((Y . 0)))
2545                           ))
2546         (direction . ,UP)
2547         (left-bound-info . ,ly:line-spanner::calc-left-bound-info)
2548         (outside-staff-priority . 50)
2549         (padding . 0.5)
2550         (right-bound-info . ,ly:line-spanner::calc-right-bound-info)
2551         (side-axis . ,Y)
2552         (staff-padding . 1.0)
2553         (stencil . ,ly:line-spanner::print)
2554         (style . trill)
2555         (Y-offset . ,side-position-interface::y-aligned-side)
2556         (meta . ((class . Spanner)
2557                  (interfaces . (font-interface
2558                                 line-interface
2559                                 line-spanner-interface
2560                                 side-position-interface
2561                                 trill-spanner-interface))))))
2562
2563     (TupletBracket
2564      . (
2565         (avoid-scripts . #t)
2566         (connect-to-neighbor . ,ly:tuplet-bracket::calc-connect-to-neighbors)
2567         (cross-staff . ,ly:tuplet-bracket::calc-cross-staff)
2568         (direction  . ,ly:tuplet-bracket::calc-direction)
2569         (edge-height . (0.7 . 0.7))
2570         (full-length-to-extent . #t)
2571         (padding . 1.1)
2572         (positions . ,ly:tuplet-bracket::calc-positions)
2573         (shorten-pair . (-0.2 . -0.2))
2574         (staff-padding . 0.25)
2575         (stencil . ,ly:tuplet-bracket::print)
2576         (thickness . 1.6)
2577         (vertical-skylines . ,grob::unpure-vertical-skylines-from-stencil)
2578         (X-positions . ,ly:tuplet-bracket::calc-x-positions)
2579
2580         (meta . ((class . Spanner)
2581                  (interfaces . (line-interface
2582                                 tuplet-bracket-interface))))))
2583
2584     (TupletNumber
2585      . (
2586         (avoid-slur . inside)
2587         (cross-staff . ,ly:tuplet-number::calc-cross-staff)
2588         (direction . ,tuplet-number::calc-direction)
2589         (font-shape . italic)
2590         (font-size . -2)
2591         (stencil . ,ly:tuplet-number::print)
2592         (text . ,tuplet-number::calc-denominator-text)
2593         (X-offset . ,ly:tuplet-number::calc-x-offset)
2594         (Y-offset . ,ly:tuplet-number::calc-y-offset)
2595         (meta . ((class . Spanner)
2596                  (interfaces . (font-interface
2597                                 text-interface
2598                                 tuplet-number-interface))))))
2599
2600
2601     (UnaCordaPedal
2602      . (
2603         (direction . ,RIGHT)
2604         (extra-spacing-width . (+inf.0 . -inf.0))
2605         (font-shape . italic)
2606         (padding . 0.0)  ;; padding relative to UnaCordaPedalLineSpanner
2607         (self-alignment-X . ,CENTER)
2608         (stencil . ,ly:text-interface::print)
2609         (vertical-skylines . ,grob::always-vertical-skylines-from-stencil)
2610         (Y-extent . ,grob::always-Y-extent-from-stencil)
2611         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
2612         (meta . ((class . Item)
2613                  (interfaces . (font-interface
2614                                 piano-pedal-script-interface
2615                                 self-alignment-interface
2616                                 text-interface))))))
2617
2618     (UnaCordaPedalLineSpanner
2619      . (
2620         (axes . (,Y))
2621         (direction . ,DOWN)
2622         (minimum-space . 1.0)
2623         (outside-staff-priority . 1000)
2624         (padding . 1.2)
2625         (side-axis . ,Y)
2626         (staff-padding . 1.2)
2627         (vertical-skylines . ,grob::always-vertical-skylines-from-element-stencils)
2628         (X-extent . ,ly:axis-group-interface::width)
2629         (Y-extent . ,axis-group-interface::height)
2630         (Y-offset . ,side-position-interface::y-aligned-side)
2631         (meta . ((class . Spanner)
2632                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
2633                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
2634                  (interfaces . (axis-group-interface
2635                                 piano-pedal-interface
2636                                 side-position-interface))))))
2637
2638
2639     (VaticanaLigature
2640      . (
2641         (flexa-width . 2.0)
2642         (stencil . ,ly:vaticana-ligature::print)
2643         (thickness . 0.6)
2644         (meta . ((class . Spanner)
2645                  (interfaces . (font-interface
2646                                 vaticana-ligature-interface))))))
2647
2648     (VerticalAlignment
2649      . (
2650         (axes . (,Y))
2651         (positioning-done . ,ly:align-interface::align-to-ideal-distances)
2652         (stacking-dir . -1)
2653         (vertical-skylines . ,ly:axis-group-interface::combine-skylines)
2654         (X-extent . ,ly:axis-group-interface::width)
2655         (Y-extent . ,axis-group-interface::height)
2656         (meta . ((class . Spanner)
2657                  (object-callbacks . ((Y-common . ,ly:axis-group-interface::calc-y-common)
2658                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)
2659                                       (pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)))
2660                  (interfaces . (align-interface
2661                                 axis-group-interface))))))
2662
2663     (VerticalAxisGroup
2664      . (
2665         (adjacent-pure-heights . ,ly:axis-group-interface::adjacent-pure-heights)
2666         (axes . (,Y))
2667         (default-staff-staff-spacing . ((basic-distance . 9)
2668                                         (minimum-distance . 8)
2669                                         (padding . 1)))
2670         (nonstaff-unrelatedstaff-spacing . ((padding . 0.5)))
2671         (outside-staff-placement-directive . left-to-right-polite)
2672         (staff-staff-spacing . ,(ly:make-unpure-pure-container ly:axis-group-interface::calc-staff-staff-spacing ly:axis-group-interface::calc-pure-staff-staff-spacing))
2673         (stencil . ,ly:axis-group-interface::print)
2674         (skyline-horizontal-padding . 0.1)
2675         (vertical-skylines . ,ly:hara-kiri-group-spanner::calc-skylines)
2676         (X-extent . ,ly:axis-group-interface::width)
2677         (Y-extent . ,(ly:make-unpure-pure-container ly:hara-kiri-group-spanner::y-extent ly:hara-kiri-group-spanner::pure-height))
2678         (Y-offset . ,ly:hara-kiri-group-spanner::force-hara-kiri-callback)
2679         (meta . ((class . Spanner)
2680                  (object-callbacks . (
2681                                       (X-common . ,ly:axis-group-interface::calc-x-common)
2682                                       (pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
2683                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
2684
2685                  (interfaces . (axis-group-interface
2686                                 hara-kiri-group-spanner-interface))))))
2687
2688     (VoiceFollower
2689      . (
2690         (after-line-breaking . ,ly:spanner::kill-zero-spanned-time)
2691         (bound-details . ((right . ((attach-dir .  ,CENTER)
2692                                     (padding . 1.5)
2693                                     ))
2694                           (left . ((attach-dir .  ,CENTER)
2695                                    (padding . 1.5)
2696                                    ))
2697                           ))
2698         (cross-staff . #t)
2699         (gap . 0.5)
2700         (left-bound-info . ,ly:line-spanner::calc-left-bound-info)
2701         (non-musical . #t)
2702         (right-bound-info . ,ly:line-spanner::calc-right-bound-info)
2703         (stencil . ,ly:line-spanner::print)
2704         (style . line)
2705         (X-extent . #f)
2706         (Y-extent . #f)
2707         (meta . ((class . Spanner)
2708                  (interfaces . (line-interface
2709                                 line-spanner-interface))))))
2710
2711     (VoltaBracket
2712      . (
2713         (direction . ,UP)
2714         (edge-height . (2.0 . 2.0)) ;; staff-space;
2715         (font-encoding . fetaText)
2716         (font-size . -4)
2717         (shorten-pair . ,ly:volta-bracket::calc-shorten-pair)
2718         (stencil . ,ly:volta-bracket-interface::print)
2719         (thickness . 1.6) ;; line-thickness
2720         (word-space . 0.6)
2721         (vertical-skylines . ,grob::unpure-vertical-skylines-from-stencil)
2722         (Y-extent . ,(grob::unpure-Y-extent-from-stencil volta-bracket-interface::pure-height))
2723         (meta . ((class . Spanner)
2724                  (interfaces . (font-interface
2725                                 horizontal-bracket-interface
2726                                 line-interface
2727                                 side-position-interface
2728                                 text-interface
2729                                 volta-bracket-interface
2730                                 volta-interface))))))
2731
2732     (VoltaBracketSpanner
2733      . (
2734         (after-line-breaking . ,ly:side-position-interface::move-to-extremal-staff)
2735         (axes . (,Y))
2736         (direction . ,UP)
2737         (no-alignment . #t)
2738         (outside-staff-priority . 600)
2739         (padding . 1)
2740         (side-axis . ,Y)
2741         (vertical-skylines . ,grob::always-vertical-skylines-from-element-stencils)
2742         (X-extent . ,ly:axis-group-interface::width)
2743         (Y-extent . ,axis-group-interface::height)
2744         (Y-offset . ,side-position-interface::y-aligned-side)
2745         (meta . ((class . Spanner)
2746                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
2747                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
2748                  (interfaces . (axis-group-interface
2749                                 side-position-interface
2750                                 volta-interface))))))
2751
2752     ))
2753
2754 (define (completize-grob-entry x)
2755   "Transplant assoc key into 'name entry of 'meta of X.  Set interfaces for Item, Spanner etc.
2756 "
2757   ;;  (display (car x))
2758   ;;  (newline)
2759   (let* ((name-sym  (car x))
2760          (grob-entry (cdr x))
2761          (meta-entry (assoc-get 'meta grob-entry))
2762          (class (assoc-get 'class meta-entry))
2763          (ifaces-entry
2764           (assoc-get 'interfaces meta-entry)))
2765
2766     (cond
2767      ((eq? 'Item class)
2768       (set! ifaces-entry (cons 'item-interface ifaces-entry)))
2769      ((eq? 'Spanner class)
2770       (set! ifaces-entry (cons 'spanner-interface ifaces-entry)))
2771      ((eq? 'Paper_column class)
2772       (set! ifaces-entry (cons 'item-interface
2773                                (cons 'paper-column-interface ifaces-entry))))
2774      ((eq? 'System class)
2775       (set! ifaces-entry (cons 'system-interface
2776                                (cons 'spanner-interface ifaces-entry))))
2777      (else
2778       (ly:warning "Unknown class ~a" class)))
2779
2780     (set! ifaces-entry (uniq-list (sort ifaces-entry symbol<?)))
2781     (set! ifaces-entry (cons 'grob-interface ifaces-entry))
2782
2783     (set! meta-entry (assoc-set! meta-entry 'name name-sym))
2784     (set! meta-entry (assoc-set! meta-entry 'interfaces
2785                                  ifaces-entry))
2786     (set! grob-entry (assoc-set! grob-entry 'meta meta-entry))
2787     (cons name-sym grob-entry)))
2788
2789 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
2790
2791 ;;  (display (map pair? all-grob-descriptions))
2792
2793 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
2794
2795 (for-each (lambda (x)
2796             ;; (display (car x)) (newline)
2797
2798             (set-object-property! (car x) 'translation-type? list?)
2799             (set-object-property! (car x) 'is-grob? #t))
2800           all-grob-descriptions)
2801
2802 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))