scm/define-grob-interfaces.scm

   1 ;;;; This file is part of LilyPond, the GNU music typesetter.
   2 ;;;;
   3 ;;;; Copyright (C) 1998--2010  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
  20 ;; The interfaces defined here generally have no code (e.g.,
  21 ;; dynamic-interface), or have callbacks defined entirely in
  22 ;; scheme.  Others interfaces are defined in lily/*.cc with the
  23 ;; ADD_INTERFACE function.
  24
  25 ;; should include default value?
  26
  27
  28 (ly:add-interface
  29  'accidental-suggestion-interface
  30  "An accidental, printed as a suggestion (typically: vertically over a
  31 note)."
  32  '())
  33
  34 (ly:add-interface
  35  'ambitus-interface
  36  "The line between note heads for a pitch range."
  37  '(gap note-heads thickness))
  38
  39 (ly:add-interface
  40  'bass-figure-interface
  41  "A bass figure text."
  42  '(implicit))
  43
  44 (ly:add-interface
  45  'bass-figure-alignment-interface
  46  "Align a bass figure."
  47  '())
  48
  49 (ly:add-interface
  50  'bend-after-interface
  51  "A doit or drop."
  52  '(thickness delta-position))
  53
  54 (ly:add-interface
  55  'dynamic-interface
  56  "Any kind of loudness sign."
  57  '())
  58
  59 (ly:add-interface
  60  'dynamic-line-spanner-interface
  61  "Dynamic line spanner."
  62  '(avoid-slur))
  63
  64 (ly:add-interface
  65  'dynamic-text-interface
  66  "An absolute text dynamic."
  67  '(right-padding))
  68
  69 (ly:add-interface
  70  'dynamic-text-spanner-interface
  71  "Dynamic text spanner."
  72  '(text))
  73
  74 (ly:add-interface
  75  'episema-interface
  76  "An episema line."
  77  '())
  78
  79 (ly:add-interface
  80  'finger-interface
  81  "A fingering instruction."
  82  '())
  83
  84 (ly:add-interface
  85  'fret-diagram-interface
  86  "A fret diagram"
  87  '(align-dir fret-diagram-details size dot-placement-list
  88    thickness))
  89
  90 (ly:add-interface
  91  'grace-spacing-interface
  92  "Keep track of durations in a run of grace notes."
  93  '(columns common-shortest-duration))
  94
  95 (ly:add-interface
  96  'instrument-specific-markup-interface
  97  "Instrument-specific markup (like fret boards or harp pedal diagrams)."
  98  '(fret-diagram-details graphical harp-pedal-details size thickness))
  99
 100 (ly:add-interface
 101  'key-cancellation-interface
 102  "A key cancellation."
 103  '())
 104
 105 (ly:add-interface
 106  'ligature-bracket-interface
 107  "A bracket indicating a ligature in the original edition."
 108  '(width thickness height))
 109
 110 (ly:add-interface
 111  'ligature-interface
 112  "A ligature."
 113  '())
 114
 115 (ly:add-interface
 116  'lyric-interface
 117  "Any object that is related to lyrics."
 118  '())
 119
 120 (ly:add-interface
 121  'lyric-syllable-interface
 122  "A single piece of lyrics."
 123  '())
 124
 125 (ly:add-interface
 126  'mark-interface
 127  "A rehearsal mark."
 128  '())
 129
 130 (ly:add-interface
 131  'metronome-mark-interface
 132  "A metronome mark."
 133  '())
 134
 135 (ly:add-interface
 136  'multi-measure-interface
 137  "Multi measure rest, and the text or number that is printed over it."
 138  '(bound-padding))
 139
 140 (ly:add-interface
 141  'note-name-interface
 142  "Note names."
 143  '())
 144
 145 (ly:add-interface
 146  'only-prebreak-interface
 147  "Kill this grob after the line breaking process."
 148  '())
 149
 150 (ly:add-interface
 151  'parentheses-interface
 152  "Parentheses for other objects."
 153  '(padding stencils))
 154
 155 (ly:add-interface
 156  'percent-repeat-interface
 157  "Beat, Double and single measure repeats."
 158  '(dot-negative-kern slash-negative-kern slope thickness))
 159
 160 (ly:add-interface
 161  'piano-pedal-interface
 162  "A piano pedal sign."
 163  '())
 164
 165 (ly:add-interface
 166  'piano-pedal-script-interface
 167  "A piano pedal sign, fixed size."
 168  '())
 169
 170 (ly:add-interface
 171  'pitched-trill-interface
 172  "A note head to indicate trill pitches."
 173  '(accidental-grob))
 174
 175 (ly:add-interface
 176  'rhythmic-grob-interface
 177  "Any object with a duration.  Used to determine which grobs are
 178 interesting enough to maintain a hara-kiri staff."
 179  '())
 180
 181 (ly:add-interface
 182  'spacing-options-interface
 183  "Supports setting of spacing variables."
 184  '(spacing-increment shortest-duration-space))
 185
 186 (ly:add-interface
 187  'stanza-number-interface
 188  "A stanza number, to be put in from of a lyrics line."
 189  '())
 190
 191 (ly:add-interface
 192  'string-number-interface
 193  "A string number instruction."
 194  '())
 195
 196 (ly:add-interface
 197  'stroke-finger-interface
 198  "A right hand finger instruction."
 199  '(digit-names))
 200
 201 (ly:add-interface
 202  'system-start-text-interface
 203  "Text in front of the system."
 204  '(long-text self-alignment-X self-alignment-Y text))
 205
 206 (ly:add-interface
 207  'tab-note-head-interface
 208  "A note head in tablature."
 209  '(details))
 210
 211 (ly:add-interface
 212  'trill-spanner-interface
 213  "A trill spanner."
 214  '())
 215
 216 (ly:add-interface
 217  'trill-pitch-accidental-interface
 218  "An accidental for trill pitch."
 219  '())
 220
 221 (ly:add-interface
 222  'unbreakable-spanner-interface
 223  "A spanner that should not be broken across line breaks.  Override
 224 with @code{breakable=##t}."
 225  '(breakable))
 226
 227 (ly:add-interface
 228  'volta-interface
 229  "A volta repeat."
 230  '())