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