]> git.donarmstrong.com Git - lilypond.git/blob - scm/element-descriptions.scm
patch::: 1.3.99.jcn3
[lilypond.git] / scm / element-descriptions.scm
1
2 ; distances are given in stafflinethickness (thicknesses) and
3 ; staffspace (distances)
4
5 (define all-element-descriptions
6   `((Arpeggio . (
7                (X-extent-callback . ,Arpeggio::width_callback)
8                (molecule-callback . ,Arpeggio::brew_molecule)
9                (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
10                (X-offset-callbacks . (,Side_position::aligned_side))
11                (direction . -1)
12                (staff-position . 0.0)
13                (meta . ,(element-description "Arpeggio" arpeggio-interface side-position-interface font-interface))
14                ))
15   
16         (BarLine . (
17                 (break-align-symbol . Staff_bar)
18                 (glyph . "|")
19                 (break-glyph-function . ,default-break-barline)
20                 (barsize-procedure . ,Bar::get_staff_bar_size)
21                 (molecule-callback . ,Bar::brew_molecule)          
22                 (visibility-lambda . ,all-visible)
23                 (breakable . #t)
24                 (before-line-breaking-callback . ,Bar::before_line_breaking)
25                 ;;
26                 ;; Ross. page 151 lists other values, we opt for a leaner look
27                 ;; 
28                 (kern . 3.0)
29                 (thin-kern . 3.0)
30                 (hair-thickness . 1.6)
31                 (thick-thickness . 6.0)
32                 (meta . ,(element-description  "BarLine" bar-line-interface font-interface))
33         ))
34
35         (BarNumber . (
36                 (molecule-callback . ,Text_item::brew_molecule)
37                 (breakable . #t)
38                 (visibility-lambda . ,begin-of-line-visible)
39                 (padding . 1.0)
40                 (direction . 1)
41                 (font-family . roman)
42                 (font-relative-size . -1)
43                 (meta . ,(element-description "BarNumber"
44                         text-interface  font-interface break-aligned-interface))
45         ))
46
47         (Beam . ,basic-beam-properties)
48          
49         (BreakAlignment . (
50                 (breakable . #t)
51                 (stacking-dir . 1)
52                 (axes 0)
53                 (X-offset-callbacks . (,Break_align_interface::self_align_callback))
54                 (space-alist . ,default-break-align-space-alist) 
55                 (meta . ,(element-description "BreakAlignment"
56                         axis-group-interface align-interface
57                         )
58                 )
59         ))
60
61         (BreakAlignGroup . (
62                 (axes  . (0))
63                 (X-offset-callbacks . (,Break_align_interface::alignment_callback))
64                 
65                 (meta . ,(element-description "BreakAlignGroup" axis-group-interface))
66         ))
67
68         (BreathingSign . (
69                 (break-align-symbol . Breathing_sign)
70                 (breakable . #t )
71                 (molecule-callback . ,Breathing_sign::brew_molecule)
72                 (Y-offset-callbacks . (,Breathing_sign::offset_callback))
73                 (visibility-lambda . ,begin-of-line-invisible)
74                 (meta . ,(element-description "BreathingSign"  break-aligned-interface))
75         ))
76
77         (Clef . (
78            (molecule-callback . ,Clef::brew_molecule)
79            (before-line-breaking-callback . ,Clef::before_line_breaking)
80            (breakable . #t)
81            (font-family . music)           
82            (break-align-symbol . Clef_item)
83            (visibility-lambda . ,begin-of-line-visible)
84            (Y-offset-callbacks  . (,Staff_symbol_referencer::callback)) 
85            (meta . ,(element-description "Clef" clef-interface font-interface break-aligned-interface ))
86         ))
87
88         (ChordNames . (
89                 (molecule-callback . ,Chord_name::brew_molecule)
90                 (after-line-breaking-callback . ,Chord_name::after_line_breaking)
91                 (chord-name-function . ,default-chord-name-function)
92                 (font-family . roman)
93                 (meta . ,(element-description "ChordNames"  font-interface text-interface chord-name-interface))
94         ))
95
96         (NoteCollision . (
97                 (axes 0 1)
98                 (note-width . 1.65)
99                 (meta . ,(element-description "NoteCollision"
100                    note-collision-interface axis-group-interface
101                 ))
102         ))
103
104         (Crescendo . (
105                 (molecule-callback . ,Crescendo::brew_molecule)
106                 (thickness . 1.0)
107                 (shorten-for-letter  .  4.0)
108                 (height . 0.6666)
109                 (dash-thickness . 1.2)
110                 (dash-length . 4.0)
111                 (self-alignment-Y . 0)
112                 (Y-offset-callbacks . (,Side_position::aligned_on_self))
113                 (meta . ,(element-description "Crescendo" hairpin-interface))
114         ))
115
116         (DotColumn . (
117                 (axes 0 )
118                 (meta . ,(element-description "DotColumn" dot-column-interface  axis-group-interface))
119         ))
120
121         (Dots . (
122                 (molecule-callback . ,Dots::brew_molecule)
123                 (dot-count . 1)
124                (font-family . music)            
125                 (staff-position . 0.0)
126                 (Y-offset-callbacks  . (,Dots::quantised_position_callback ,Staff_symbol_referencer::callback))
127                 (meta . ,(element-description "Dots"  font-interface dot-interface ))
128         ))
129         
130         (DynamicText . (
131                 (Y-offset-callbacks . (,Side_position::aligned_on_self))
132                 (molecule-callback . ,Text_item::brew_molecule)
133                 (script-priority . 100)
134                 (font-series . bold)
135                 (font-family . dynamic)
136                 (self-alignment-Y . 0)
137                 (meta . ,(element-description "DynamicText" font-interface  text-interface ))
138         ))
139         
140         (DynamicLineSpanner . (
141                 (axes . ( 1))
142                 (padding . 3)
143                 (minimum-space . 6)
144                 (meta . ,(element-description "DynamicLineSpanner" dynamic-interface axis-group-interface side-position-interface))
145         ))
146         
147         (LeftEdge . (
148                 (break-align-symbol . Left_edge_item)
149                 (X-offset-callbacks . (,Break_align_interface::alignment_callback))
150                 (breakable . #t)
151                 (meta . ,(element-description "LeftEdge" break-aligned-interface))
152         ))
153         
154         (Fingering . (
155                 (molecule-callback . ,Text_item::brew_molecule)
156                 (X-offset-callbacks . (,Side_position::centered_on_parent ,Side_position::aligned_on_self))
157                 (padding .      3.0)
158                 (self-alignment-X . 0)
159                 (font-family . number)
160                 (font-relative-size . -3)
161                 (meta . ,(element-description "Fingering" finger-interface  font-interface text-script-interface text-interface side-position-interface))
162         ))
163
164         (GraceAlignment . (
165                 (axes . (0))
166                 (horizontal-space . 1.2)
167                 (padding . 1.0)
168                 (before-line-breaking-callback . ,Grace_align_item::before_line_breaking)
169                 (meta . ,(element-description "GraceAlignment" axis-group-interface align-interface grace-alignment-interface))
170         ))
171         
172         (HaraKiriVerticalGroup . (
173                 (Y-offset-callbacks . (,Hara_kiri_group_spanner::force_hara_kiri_callback))
174                 (Y-extent-callback . ,Hara_kiri_group_spanner::y_extent)
175                 (axes 1)
176                 (meta . ,(element-description "HaraKiriVerticalGroup" axis-group-interface hara-kiri-group-interface))
177         ))
178
179         (LyricHyphen . (
180                 (thickness . 1.0)
181                 (height . 0.4)
182                 (minimum-length .  0.5) 
183                 (molecule-callback . ,Hyphen_spanner::brew_molecule)
184                 (Y-extent-callback . ,Score_element::point_dimension_callback)
185                 (meta . ,(element-description "LyricHyphen" lyric-hyphen-interface ))
186         ))
187         
188         (InstrumentName . (
189                 (breakable . #t)
190                 (Y-offset-callbacks . (,Side_position::centered_on_parent
191                                        ,Side_position::aligned_on_self))
192                 (self-alignment-Y . 0)
193                 (molecule-callback . ,Text_item::brew_molecule)         
194                 (break-align-symbol . Instrument_name)
195                 (visibility-lambda . ,begin-of-line-visible)
196                 (font-family . roman)
197                 (meta . ,(element-description "InstrumentName"  font-interface  text-interface break-aligned-interface))
198         ))
199         
200         (KeySignature . (
201           (molecule-callback . ,Key_item::brew_molecule)
202           (break-align-symbol . Key_item)
203           (visibility-lambda . ,begin-of-line-visible)
204           (breakable . #t)
205           (meta . ,(element-description "KeySignature" key-signature-interface  font-interface  break-aligned-interface))
206         ))
207         
208         (Accidentals . (
209                 (molecule-callback . ,Local_key_item::brew_molecule)
210                 (X-offset-callbacks . (,Side_position::aligned_side))
211                 (direction . -1)
212                 (left-padding . 0.2)
213                 (right-padding . 0.4)
214                 (meta . ,(element-description "Accidentals"  accidentals-interface font-interface ))
215         ))
216         
217         (LineOfScore . (
218                 (axes . (0 1))
219                 (meta . ,(element-description "LineOfScore"  line-of-score-interface axis-group-interface))
220         ))
221         
222         (LyricExtender . (
223                 (molecule-callback . ,Lyric_extender::brew_molecule)
224                 (height . 0.8) ; stafflinethickness;
225                 (right-trim-amount . 0.5)
226                 (Y-extent-callback . ,Score_element::point_dimension_callback)
227                 (meta . ,(element-description "LyricExtender"  lyric-extender-interface))
228         ))
229         
230         (LyricText . (
231                 (molecule-callback . ,Text_item::brew_molecule)
232                 (X-offset-callbacks . (,Side_position::aligned_on_self))
233                 (self-alignment-X . 0)
234                 (non-rhythmic . #t)
235                 (word-space . 0.6)
236                 (font-family . roman)
237                 (font-shape . upright)
238                 (font-relative-size . 0)
239                 (meta . ,(element-description "LyricText" lyric-syllable-interface text-interface font-interface ))
240         ))
241         
242         (RehearsalMark . (
243                 (molecule-callback . ,Text_item::brew_molecule) 
244                 (breakable . #t)
245                 (font-family . number)
246                 (font-relative-size . 1)
247                 (visibility-lambda . ,end-of-line-invisible)
248                 (padding . 4.0)
249                 (meta . ,(element-description "RehearsalMark"  mark-interface side-position-interface))
250         ))
251         
252         (MultiMeasureRest . (
253                 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
254                 (molecule-callback . ,Multi_measure_rest::brew_molecule)
255                 (staff-position . 0)
256                 (expand-limit . 10)
257                 (padding . 2.0) ; staffspace
258                 (minimum-width . 12.5) ; staffspace
259                 (font-family . number)
260                 (font-relative-size . 1)
261                 (meta . ,(element-description "MultiMeasureRest" multi-measure-rest-interface  font-interface ))
262         ))
263         
264         (NoteColumn . (
265                 (axes . (0 1))
266                 (meta . ,(element-description "NoteColumn"  axis-group-interface note-column-interface))
267         ))
268
269         (NoteHead . (
270                 (style . default)
271                 (molecule-callback . ,Note_head::brew_molecule)
272                 (Y-offset-callbacks  . (,Staff_symbol_referencer::callback)) 
273                 (meta . ,(element-description  "NoteHead"
274                         rhythmic-head-interface font-interface 
275                         note-head-interface ))
276         ))
277
278         (NoteName . (
279                 (style . default)
280                 (molecule-callback . ,Text_item::brew_molecule)
281                 (meta . ,(element-description  "NoteName"
282                                                note-name-interface font-interface
283                                                general-element-interface))
284                 ))
285
286         (OctavateEight . (
287                 (self-alignment-X . 0)
288                 (text . "8")
289                 (visibility-lambda . ,begin-of-line-visible)
290                 (X-offset-callbacks . (,Side_position::centered_on_parent ,Side_position::aligned_on_self))
291                 (Y-offset-callbacks . (,Side_position::aligned_side))
292                 (molecule-callback . ,Text_item::brew_molecule)
293                 (font-shape . italic)
294                 (meta . ,(element-description "OctavateEight" text-interface font-interface ))
295         ))
296         
297         (PaperColumn . (
298                 (axes 0)
299                 (before-grace-spacing-factor . 1.2)
300                 (before-musical-spacing-factor . 0.4)
301                 (meta . ,(element-description "PaperColumn" paper-column-interface axis-group-interface spaceable-element-interface))
302         ))
303         (NonMusicalPaperColumn . (
304                 (axes 0)
305                 (before-musical-spacing-factor . 1.0)
306                 (column-space-strength . 2.0)
307                 (meta . ,(element-description "NonMusicalPaperColumn" paper-column-interface axis-group-interface spaceable-element-interface))
308         ))
309         
310         (Rest . (
311                 (after-line-breaking-callback . ,Rest::after_line_breaking)
312                 (molecule-callback . ,Rest::brew_molecule)
313                 (minimum-beam-collision-distance . 1.5)
314                 (meta . ,(element-description  "Rest"
315                         rhythmic-head-interface
316                         rest-interface ))
317         ))
318         (RestCollision . (
319                 (minimum-distance . 0.75)
320                 (meta . ,(element-description "RestCollision" rest-collision-interface ))
321         ))
322
323         (Script . (
324                 (molecule-callback . ,Script::brew_molecule)
325                 (X-offset-callbacks . (,Side_position::centered_on_parent))
326                 (meta . ,(element-description "Script" script-interface side-position-interface font-interface))
327         ))
328         
329         (ScriptColumn . (
330                 (before-line-breaking-callback . ,Script_column::before_line_breaking)
331                 (meta . ,(element-description "ScriptColumn" script-column-interface))
332         ))
333         
334         (Slur . ,default-basic-slur-properties)
335         (SpacingSpanner . (
336                 (spacing-procedure . ,Spacing_spanner::set_springs)
337                 (stem-spacing-correction . 0.5)
338                 (arithmetic-basicspace . 2.0)
339                 (arithmetic-multiplier . ,(* 0.9 1.32))
340                 ;; assume that notes at least this long are present.
341                 (maximum-duration-for-spacing . ,(make-moment 1 8))
342                 (meta . ,(element-description "SpacingSpanner"  spacing-spanner-interface))
343         ))
344         (SpanBar . (
345
346                 (break-align-symbol . Staff_bar)
347                 (barsize-procedure . ,Span_bar::get_bar_size) 
348                 (molecule-callback . ,Bar::brew_molecule)
349                 (visibility-lambda . ,begin-of-line-invisible)
350                 (X-extent-callback . ,Span_bar::width_callback)
351                 (Y-offset-callbacks . (,Span_bar::center_on_spanned_callback))
352                 
353                 (breakable . #t)
354                 (glyph . "|")
355                 (before-line-breaking-callback . ,Span_bar::before_line_breaking)
356                 ;; ugh duplication! 
357                 
358                 ;;
359                 ;; Ross. page 151 lists other values, we opt for a leaner look
360                 ;; 
361                 (kern . 3.0)
362                 (thin-kern . 3.0)
363                 (hair-thickness . 1.6)
364                 (thick-thickness . 6.0)
365                 (meta . ,(element-description "SpanBar" span-bar-interface bar-line-interface ))
366         ))
367
368         (StanzaNumber . (
369                 (breakable . #t)
370                 (molecule-callback . ,Text_item::brew_molecule)         
371                 (break-align-symbol . Clef_item)
372                 (visibility-lambda . ,begin-of-line-visible)
373                 (font-family . roman)
374                 (meta . ,(element-description "StanzaNumber" break-aligned-interface text-interface font-interface))
375         ))
376
377         (StaffSymbol . (
378                 (molecule-callback . ,Staff_symbol::brew_molecule)
379                 (staff-space . 1.0)
380                 (line-count . 5 )
381                 (meta . ,(element-description "StaffSymbol" staff-symbol-interface ))
382         ))
383         (SostenutoPedal . (
384                 (molecule-callback . ,Text_item::brew_molecule)
385                 (X-offset-callbacks . (,Side_position::aligned_on_self))
386                 (Y-offset-callbacks .
387                  (,Side_position::aligned_side
388                   ,Side_position::centered_on_parent))
389                 (no-spacing-rods . #t)
390                 (font-shape . italic)
391                 (self-alignment-X . 0)
392                 (meta . ,(element-description "SostenutoPedal" text-interface  font-interface))
393         ))
394
395         (Stem . (
396                 (before-line-breaking-callback . ,Stem::before_line_breaking)
397                 (molecule-callback . ,Stem::brew_molecule)
398                 (thickness . 0.8)
399                 (beamed-lengths . (0.0 2.5 2.0 1.5))
400                 (beamed-minimum-lengths . (0.0 1.5 1.25 1.0))
401                 
402 ;;  Stems in unnatural (forced) direction should be shortened,
403 ;;  according to [Roush & Gourlay].  Their suggestion to knock off
404 ;;  a whole staffspace seems a bit drastical: we'll do half.
405
406                 (lengths . (3.5 3.5 3.5 4.5 5.0))
407                 (stem-shorten . (0.5))
408                 ; if stem is on middle line, choose this direction.
409                 (default-neutral-direction . 1)
410                 (X-offset-callbacks . (,Stem::off_callback))            
411                 (meta . ,(element-description  "Stem" stem-interface  font-interface))
412         ))
413
414         (StemTremolo . (
415                 (molecule-callback . ,Stem_tremolo::brew_molecule)
416                 (beam-width . 2.0) ; staff-space
417                 (beam-thickness . 0.42) ; staff-space
418                 (beam-space-function . ,default-beam-space-function)
419                 (meta . ,(element-description "StemTremolo" stem-tremolo-interface ))
420         ))
421
422         (SeparationItem . (
423                 (meta . ,(element-description "SeparationItem" separation-item-interface ))
424         ))
425         (SeparatingGroupSpanner . (
426                 (spacing-procedure . ,Separating_group_spanner::set_spacing_rods)
427                 (meta . ,(element-description "SeparatingGroupSpanner" separation-spanner-interface))
428         ))
429
430         (SustainPedal . (
431                 (no-spacing-rods . #t)
432                 (molecule-callback . ,Sustain_pedal::brew_molecule)
433                 (self-alignment-X . 0)
434                 (X-offset-callbacks . (,Side_position::aligned_on_self))
435                 (Y-offset-callbacks .
436                                     (,Side_position::aligned_side
437                                      ,Side_position::centered_on_parent))
438
439                 (meta . ,(element-description "SustainPedal" sustain-pedal-interface side-position-interface font-interface))
440         ))
441
442         (SystemStartDelimiter . (
443                 (molecule-callback . ,System_start_delimiter::brew_molecule)
444                 (after-line-breaking-callback . ,System_start_delimiter::after_line_breaking)
445                 (collapse-height . 1.0)
446                 (thickness . 1.6)
447                 (arch-height . 1.5)
448                 (arch-angle . 50.0)
449                 (arch-thick . 0.25)
450                 (glyph . bar-line)
451                 (arch-width . 1.5)
452                 (bracket-thick . 0.25)
453                 (bracket-width . 2.0)
454                 (Y-extent-callback . #f)
455                 (meta . ,(element-description "SystemStartDelimiter" system-start-delimiter ))
456         ))
457
458         (TextScript . (
459                 (molecule-callback . ,Text_item::brew_molecule)
460                 (no-spacing-rods . #t)
461                 (padding . 0.5)
462                 (font-family . roman)
463                 (font-shape . italic)
464                 (font-relative-size . 0)
465                 (meta . ,(element-description "TextScript" text-script-interface text-interface side-position-interface font-interface ))
466         ))
467         (TextSpanner . (
468                 (molecule-callback . ,Text_spanner::brew_molecule)
469                 (font-shape . italic)
470                 (type . "line")
471                 (direction . 1)
472                 (meta . ,(element-description "TextSpanner" text-spanner-interface  font-interface))            
473         ))
474         (Tie . (
475                 (molecule-callback . ,Tie::brew_molecule)
476                 (spacing-procedure . ,Tie::set_spacing_rods)
477                 (staffline-clearance . 0.35)
478                 (details . ((ratio . 0.333) (height-limit . 1.0)))
479                 (thickness . 1.2)
480                 (x-gap . 0.2)
481                 (minimum-length  . 2.5)
482                 (meta . ,(element-description "Tie" tie-interface ))
483         ))
484
485         (TieColumn . (
486                 (after-line-breaking-callback . ,Tie_column::after_line_breaking)
487                 (meta . ,(element-description "TieColumn" tie-column-interface ))
488         ))
489
490         (TimeSignature . (
491                 (molecule-callback . ,Time_signature::brew_molecule)
492                 (break-align-symbol . Time_signature)
493                 (visibility-lambda . ,all-visible)
494                 (breakable . #t)
495                 (font-family . number)
496                 (font-relative-size . 0)
497                 (meta . ,(element-description "TimeSignature" time-signature-interface  font-interface))
498         ))
499
500         (TupletBracket . (
501                 (number-gap . 2.0)   
502                 (delta-y . 0)
503                 (thick . 1.0)
504                 (after-line-breaking-callback . ,Tuplet_spanner::after_line_breaking)
505                 (molecule-callback . ,Tuplet_spanner::brew_molecule)
506                 (font-shape . italic)
507                 (font-relative-size . -1)
508                 (meta .  ,(element-description "TupletBracket" text-interface
509                            tuplet-bracket-interface font-interface))
510         ))
511
512         (UnaChordaPedal . (
513                 (molecule-callback . ,Text_item::brew_molecule)
514                 (font-shape . italic)
515                 (no-spacing-rods . #t)
516                 (self-alignment-X . 0)
517                 (X-offset-callbacks . (,Side_position::aligned_on_self))
518                 (Y-offset-callbacks .
519                  (,Side_position::aligned_side
520                   ,Side_position::centered_on_parent))
521                 (meta . ,(element-description "UnaChordaPedal" text-interface font-interface))
522         ))
523
524         (VoltaBracket . (
525                 (molecule-callback . ,Volta_spanner::brew_molecule)
526                 (direction . 1)
527                 (padding . 5)
528                 (font-family . number)
529                 (font-relative-size . -2)
530                 (thickness . 1.6)  ;  stafflinethickness
531                 (height . 2.0) ; staffspace;
532                 (minimum-space . 25)
533                 (meta . ,(element-description "VoltaBracket" volta-bracket-interface side-position-interface font-interface))
534         ))
535
536         (VerticalAlignment . (
537                 (axes 1)
538                 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
539                 (X-extent-callback . #f)
540                 (stacking-dir . -1)
541                 (meta . ,(element-description "VerticalAlignment" align-interface axis-group-interface))
542         ))
543
544         (VerticalAxisGroup . (
545                 (axes 1)
546                 (meta . ,(element-description "VerticalAxisGroup" axis-group-interface))
547         ))
548 ))
549
550
551
552 ;  (display  (map pair? all-element-descriptions))
553