Documentation/snippets/engravers-one-by-one.ly

   1 %% DO NOT EDIT this file manually; it is automatically
   2 %% generated from LSR http://lsr.dsi.unimi.it
   3 %% Make any changes in LSR itself, or in Documentation/snippets/new/ ,
   4 %% and then run scripts/auxiliar/makelsr.py
   5 %%
   6 %% This file is in the public domain.
   7 \version "2.14.2"
   8
   9 \header {
  10 %% Translation of GIT committish: 30339cb3706f6399c84607426988b25f79b4998c
  11   texidocfr = "
  12 Pour appréhender la notation, nous l'avons disséquée en éléments
  13 simples : chaque type de symbole est géré par un module différent.
  14 Chaque module est appelé @qq{graveur}.  Dans cet exemple, chaque graveur
  15 est appelé à son tour, dans l'ordre suivant :
  16
  17 -- têtes de note,
  18
  19 -- symboles de la portée,
  20
  21 -- clef,
  22
  23 -- hampes,
  24
  25 -- ligatures, liaisons, accents,
  26
  27 -- altérations, barres de mesure, métrique et armure.
  28
  29 Les graveurs se regroupent.  Par exemple, têtes de note, liaisons,
  30 ligature etc. forment un contexte de voix (@code{Voice}).  Les graveurs
  31 chargés de la métrique, des altérations, des barres de mesure etc.
  32 forment un contexte de portée (@code{Staff}).
  33
  34 "
  35   doctitlefr = "Les graveurs un par un"
  36
  37   lsrtags = "specific-notation, contexts-and-engravers"
  38
  39
  40 %% Translation of GIT committish: b482c3e5b56c3841a88d957e0ca12964bd3e64fa
  41   texidoces = "
  42 Del problema central de la notación, esto es, crear un determinado
  43 símbolo, se encargan los «plugins» o complementos añadidos.  Cada
  44 uno de los complementos se conoce como un grabador. En este
  45 ejemplo, los grabadores se van activando uno por uno, en el orden
  46 siguiente:
  47
  48 - cabeza de las notas,
  49
  50 - el símbolo del pentagrama,
  51
  52 - clave,
  53
  54 - plicas,
  55
  56 - barras, ligaduras de expresión, acentos,
  57
  58 - alteraciones, líneas divisorias, indicación del compás, y armadura.
  59
  60 Los grabadores se encuentran agrupados. Por ejemplo, las cabezas de
  61 nota, ligaduras de expresión, barras de corchea, etc. forman un
  62 contexto de voz, @code{Voice}. Los grabadores de la armadura,
  63 alteraciones, líneas de compás, etc. forman un contexto de pentagrama,
  64 @code{Staff}.
  65
  66 "
  67   doctitlees = "Los grabadores uno por uno"
  68
  69   texidoc = "
  70 The notation problem, creating a certain symbol, is handled by plugins.
  71  Each plugin is called an Engraver. In this example, engravers are
  72 switched on one by one, in the following order:
  73
  74 - note heads,
  75
  76
  77 - staff symbol,
  78
  79
  80 - clef,
  81
  82
  83 - stem,
  84
  85
  86 - beams, slurs, accents,
  87
  88
  89 - accidentals, bar lines, time signature and key signature.
  90
  91
  92
  93 Engravers are grouped. For example, note heads, slurs, beams etc. form
  94 a @code{Voice} context. Engravers for key signature, accidentals, bar
  95 line, etc. form a @code{Staff} context.
  96
  97 "
  98   doctitle = "Engravers one-by-one"
  99 } % begin verbatim
 100
 101
 102 %% sample music
 103 topVoice = \relative c' {
 104   \key d \major
 105   es8([ g] a[ fis])
 106   b4
 107   b16[-. b-. b-. cis-.]
 108   d4->
 109 }
 110
 111 botVoice = \relative c' {
 112   \key d \major
 113   c8[( f] b[ a)]
 114   es4
 115   es16[-. es-. es-. fis-.]
 116   b4->
 117 }
 118
 119 hoom = \relative c {
 120   \key d \major
 121   \clef bass
 122   g8-. r
 123   r4
 124   fis8-.
 125   r8
 126   r4
 127   b'4->
 128 }
 129
 130 pah = \relative c' {
 131   r8 b-.
 132   r4
 133   r8 g8-.
 134   r16 g-. r8
 135   \clef treble
 136   fis'4->
 137 }
 138
 139 %
 140 % setup for Request->Element conversion. Guru-only
 141 %
 142
 143 MyStaff = \context {
 144   \type "Engraver_group"
 145   \name Staff
 146
 147   \description "Handles clefs, bar lines, keys, accidentals.  It can contain
 148 @code{Voice} contexts."
 149
 150   \consists "Output_property_engraver"
 151
 152   \consists "Font_size_engraver"
 153
 154   \consists "Volta_engraver"
 155   \consists "Separating_line_group_engraver"
 156   \consists "Dot_column_engraver"
 157
 158   \consists "Ottava_spanner_engraver"
 159   \consists "Rest_collision_engraver"
 160   \consists "Piano_pedal_engraver"
 161   \consists "Piano_pedal_align_engraver"
 162   \consists "Instrument_name_engraver"
 163   \consists "Grob_pq_engraver"
 164   \consists "Forbid_line_break_engraver"
 165   \consists "Axis_group_engraver"
 166
 167   \consists "Pitch_squash_engraver"
 168
 169   localKeySignature = #'()
 170
 171   % explicitly set instrumentName, so we don't get
 172   % weird effects when doing instrument names for
 173   % piano staves
 174
 175   instrumentName = #'()
 176   shortInstrumentName = #'()
 177
 178   \accepts "Voice"
 179 }
 180
 181
 182 MyVoice = \context {
 183   \type "Engraver_group"
 184   \name Voice
 185
 186   \description "
 187     Corresponds to a voice on a staff.  This context handles the
 188     conversion of dynamic signs, stems, beams, super- and subscripts,
 189     slurs, ties, and rests.
 190
 191     You have to instantiate this explicitly if you want to have
 192     multiple voices on the same staff."
 193
 194   localKeySignature = #'()
 195   \consists "Font_size_engraver"
 196
 197   % must come before all
 198   \consists "Output_property_engraver"
 199   \consists "Arpeggio_engraver"
 200   \consists "Multi_measure_rest_engraver"
 201   \consists "Text_spanner_engraver"
 202   \consists "Grob_pq_engraver"
 203   \consists "Note_head_line_engraver"
 204   \consists "Glissando_engraver"
 205   \consists "Ligature_bracket_engraver"
 206   \consists "Breathing_sign_engraver"
 207   % \consists "Rest_engraver"
 208   \consists "Grace_beam_engraver"
 209   \consists "New_fingering_engraver"
 210   \consists "Chord_tremolo_engraver"
 211   \consists "Percent_repeat_engraver"
 212   \consists "Slash_repeat_engraver"
 213
 214   %{
 215     Must come before text_engraver, but after note_column engraver.
 216   %}
 217   \consists "Text_engraver"
 218   \consists "Dynamic_engraver"
 219   \consists "Fingering_engraver"
 220
 221   \consists "Script_column_engraver"
 222   \consists "Rhythmic_column_engraver"
 223   \consists "Cluster_spanner_engraver"
 224   \consists "Tie_engraver"
 225   \consists "Tie_engraver"
 226   \consists "Tuplet_engraver"
 227   \consists "Note_heads_engraver"
 228   \consists "Rest_engraver"
 229 }
 230
 231
 232 \score {
 233   \topVoice
 234   \layout {
 235     \context { \MyStaff }
 236     \context { \MyVoice }
 237   }
 238 }
 239
 240
 241 MyStaff = \context {
 242   \MyStaff
 243   \consists "Staff_symbol_engraver"
 244 }
 245
 246 \score {
 247   \topVoice
 248   \layout {
 249     \context { \MyStaff }
 250     \context { \MyVoice }
 251   }
 252 }
 253
 254 MyStaff = \context {
 255   \MyStaff
 256   \consists "Clef_engraver"
 257   \remove "Pitch_squash_engraver"
 258 }
 259
 260 \score {
 261   \topVoice
 262   \layout {
 263     \context { \MyStaff }
 264     \context { \MyVoice }
 265   }
 266 }
 267
 268 MyVoice = \context {
 269   \MyVoice
 270   \consists "Stem_engraver"
 271 }
 272
 273 \score {
 274   \topVoice
 275   \layout {
 276     \context { \MyStaff }
 277     \context { \MyVoice }
 278   }
 279 }
 280
 281 MyVoice = \context {
 282   \MyVoice
 283   \consists "Beam_engraver"
 284 }
 285
 286 \score {
 287   \topVoice
 288   \layout {
 289     \context { \MyStaff }
 290     \context { \MyVoice }
 291   }
 292 }
 293
 294 MyVoice = \context {
 295   \MyVoice
 296   \consists "Phrasing_slur_engraver"
 297   \consists "Slur_engraver"
 298   \consists "Script_engraver"
 299 }
 300
 301
 302 \score {
 303   \topVoice
 304   \layout {
 305     \context { \MyStaff }
 306     \context { \MyVoice }
 307   }
 308 }
 309
 310 MyStaff = \context {
 311   \MyStaff
 312   \consists "Bar_engraver"
 313   \consists "Time_signature_engraver"
 314 }
 315
 316 \score {
 317   \topVoice
 318   \layout {
 319     \context { \MyStaff }
 320     \context { \MyVoice }
 321   }
 322 }
 323
 324 MyStaff = \context {
 325   \MyStaff
 326   \consists "Accidental_engraver"
 327   \consists "Key_engraver"
 328 }
 329 \score {
 330   \topVoice
 331   \layout {
 332     \context { \MyStaff }
 333     \context { \MyVoice }
 334   }
 335 }
 336