scm/define-grobs.scm

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