]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/snippets/fret-diagrams-explained-and-developed.ly
Rerun scripts/auxiliar/update-with-convert-ly.sh
[lilypond.git] / Documentation / snippets / fret-diagrams-explained-and-developed.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.17.6"
8
9 \header {
10   lsrtags = "fretted-strings, tweaks-and-overrides"
11
12   texidoc = "
13 This snippet shows many possibilities for obtaining and tweaking fret
14 diagrams.
15
16 "
17   doctitle = "Fret diagrams explained and developed"
18 } % begin verbatim
19
20
21 <<
22   \chords {
23     a2 a
24     \repeat unfold 3 {
25       c c c d d
26     }
27   }
28
29   \new Voice = "mel" {
30     \textLengthOn
31     % Set global properties of fret diagram
32     \override TextScript.size = #1.2
33     \override TextScript.fret-diagram-details.finger-code = #'below-string
34     \override TextScript.fret-diagram-details.dot-color = #'black
35
36     %% A chord for ukulele
37     a'2^\markup {
38       \override #'(fret-diagram-details . (
39                    (string-count . 4)
40                    (dot-color . white)
41                    (finger-code . in-dot))) {
42         \fret-diagram #"4-2-2;3-1-1;2-o;1-o;"
43       }
44     }
45
46     %% A chord for ukulele, with formatting defined in definition string
47     %  1.2 * size, 4 strings, 4 frets, fingerings below string
48     %  dot radius .35 of fret spacing, dot position 0.55 of fret spacing
49     a'2^\markup {
50       \override #'(fret-diagram-details . (
51                    (dot-color . white)
52                    (open-string . "o"))) {
53         \fret-diagram #"s:1.2;w:4;h:3;f:2;d:0.35;p:0.55;4-2-2;3-1-1;2-o;1-o;"
54       }
55     }
56
57       %% These chords will be in normal orientation
58
59     %% C major for guitar, barred on third fret
60     %  verbose style
61     %  roman fret label, finger labels below string, straight barre
62     c'2^\markup {
63       % 110% of default size
64       \override #'(size . 1.1) {
65         \override #'(fret-diagram-details . (
66                      (number-type . roman-lower)
67                      (finger-code . below-string)
68                      (barre-type . straight))) {
69           \fret-diagram-verbose #'((mute 6)
70                                    (place-fret 5 3 1)
71                                    (place-fret 4 5 2)
72                                    (place-fret 3 5 3)
73                                    (place-fret 2 5 4)
74                                    (place-fret 1 3 1)
75                                    (barre 5 1 3))
76         }
77       }
78     }
79
80     %% C major for guitar, barred on third fret
81     %% Double barre used to test barre function
82     %  verbose style
83     c'2^\markup {
84       % 110% of default size
85       \override #'(size . 1.1) {
86         \override #'(fret-diagram-details . (
87                      (number-type . arabic)
88                      (dot-label-font-mag . 0.9)
89                      (finger-code . in-dot)
90                      (fret-label-font-mag . 0.6)
91                      (fret-label-vertical-offset . 0)
92                      (label-dir . -1)
93                      (mute-string . "M")
94                      (xo-font-magnification . 0.4)
95                      (xo-padding . 0.3))) {
96           \fret-diagram-verbose #'((mute 6)
97                                    (place-fret 5 3 1)
98                                    (place-fret 4 5 2)
99                                    (place-fret 3 5 3)
100                                    (place-fret 2 5 4)
101                                    (place-fret 1 3 1)
102                                    (barre 4 2 5)
103                                    (barre 5 1 3))
104         }
105       }
106     }
107
108     %% C major for guitar, with capo on third fret
109     %  verbose style
110     c'2^\markup {
111       % 110% of default size
112       \override #'(size . 1.1) {
113         \override #'(fret-diagram-details . (
114                      (number-type . roman-upper)
115                      (dot-label-font-mag . 0.9)
116                      (finger-code . none)
117                      (fret-label-vertical-offset . 0.5)
118                      (xo-font-magnification . 0.4)
119                      (xo-padding . 0.3))) {
120           \fret-diagram-verbose #'((mute 6)
121                                    (capo 3)
122                                    (open 5)
123                                    (place-fret 4 5 1)
124                                    (place-fret 3 5 2)
125                                    (place-fret 2 5 3)
126                                    (open 1))
127         }
128       }
129     }
130
131     %% simple D chord
132     d'2^\markup {
133       \override #'(fret-diagram-details . (
134                    (finger-code . below-string)
135                    (dot-radius . 0.35)
136                    (string-thickness-factor . 0.3)
137                    (dot-position . 0.5)
138                    (fret-count . 3))) {
139         \fret-diagram-terse #"x;x;o;2-1;3-2;2-3;"
140       }
141     }
142
143     %% simple D chord, large top fret thickness
144     d'2^\markup  {
145       \override #'(fret-diagram-details . (
146                    (finger-code . below-string)
147                    (dot-radius . 0.35)
148                    (dot-position . 0.5)
149                    (top-fret-thickness . 7)
150                    (fret-count . 3))) {
151         \fret-diagram-terse #"x;x;o;2-1;3-2;2-3;"
152       }
153     }
154
155       % These chords will be in landscape orientation
156     \override TextScript.fret-diagram-details.orientation = #'landscape
157
158     %% C major for guitar, barred on third fret
159     %  verbose style
160     %  roman fret label, finger labels below string, straight barre
161     c'2^\markup {
162       % 110% of default size
163       \override #'(size . 1.1) {
164         \override #'(fret-diagram-details . (
165                      (number-type . roman-lower)
166                      (finger-code . below-string)
167                      (barre-type . straight))) {
168           \fret-diagram-verbose #'((mute 6)
169                                    (place-fret 5 3 1)
170                                    (place-fret 4 5 2)
171                                    (place-fret 3 5 3)
172                                    (place-fret 2 5 4)
173                                    (place-fret 1 3 1)
174                                    (barre 5 1 3))
175         }
176       }
177     }
178
179     %% C major for guitar, barred on third fret
180     %% Double barre used to test barre function
181     %  verbose style
182     c'2^\markup {
183       % 110% of default size
184       \override #'(size . 1.1) {
185         \override #'(fret-diagram-details . (
186                      (number-type . arabic)
187                      (dot-label-font-mag . 0.9)
188                      (finger-code . in-dot)
189                      (fret-label-font-mag . 0.6)
190                      (fret-label-vertical-offset . 0)
191                      (label-dir . -1)
192                      (mute-string . "M")
193                      (xo-font-magnification . 0.4)
194                      (xo-padding . 0.3))) {
195           \fret-diagram-verbose #'((mute 6)
196                                    (place-fret 5 3 1)
197                                    (place-fret 4 5 2)
198                                    (place-fret 3 5 3)
199                                    (place-fret 2 5 4)
200                                    (place-fret 1 3 1)
201                                    (barre 4 2 5)
202                                    (barre 5 1 3))
203         }
204       }
205     }
206
207     %% C major for guitar, with capo on third fret
208     %  verbose style
209     c'2^\markup {
210       % 110% of default size
211       \override #'(size . 1.1) {
212         \override #'(fret-diagram-details . (
213                      (number-type . roman-upper)
214                      (dot-label-font-mag . 0.9)
215                      (finger-code . none)
216                      (fret-label-vertical-offset . 0.5)
217                      (xo-font-magnification . 0.4)
218                      (xo-padding . 0.3))) {
219           \fret-diagram-verbose #'((mute 6)
220                                    (capo 3)
221                                    (open 5)
222                                    (place-fret 4 5 1)
223                                    (place-fret 3 5 2)
224                                    (place-fret 2 5 3)
225                                    (open 1))
226         }
227       }
228     }
229
230     %% simple D chord
231     d'2^\markup {
232       \override #'(fret-diagram-details . (
233                    (finger-code . below-string)
234                    (dot-radius . 0.35)
235                    (dot-position . 0.5)
236                    (fret-count . 3))) {
237         \fret-diagram-terse #"x;x;o;2-1;3-2;2-3;"
238       }
239     }
240
241     %% simple D chord, large top fret thickness
242     d'2^\markup {
243       \override #'(fret-diagram-details . (
244                    (finger-code . below-string)
245                    (dot-radius . 0.35)
246                    (dot-position . 0.5)
247                    (top-fret-thickness . 7)
248                    (fret-count . 3))) {
249         \fret-diagram-terse #"x;x;o;2-1;3-2;2-3;"
250       }
251     }
252
253       % These chords will be in opposing-landscape orientation
254     \override TextScript.fret-diagram-details.orientation = #'opposing-landscape
255
256     %% C major for guitar, barred on third fret
257     %  verbose style
258     %  roman fret label, finger labels below string, straight barre
259     c'2^\markup {
260       % 110% of default size
261       \override #'(size . 1.1) {
262         \override #'(fret-diagram-details . (
263                      (number-type . roman-lower)
264                      (finger-code . below-string)
265                      (barre-type . straight))) {
266           \fret-diagram-verbose #'((mute 6)
267                                    (place-fret 5 3 1)
268                                    (place-fret 4 5 2)
269                                    (place-fret 3 5 3)
270                                    (place-fret 2 5 4)
271                                    (place-fret 1 3 1)
272                                    (barre 5 1 3))
273         }
274       }
275     }
276
277     %% C major for guitar, barred on third fret
278     %% Double barre used to test barre function
279     %  verbose style
280     c'2^\markup {
281       % 110% of default size
282       \override #'(size . 1.1) {
283         \override #'(fret-diagram-details . (
284                      (number-type . arabic)
285                      (dot-label-font-mag . 0.9)
286                      (finger-code . in-dot)
287                      (fret-label-font-mag . 0.6)
288                      (fret-label-vertical-offset . 0)
289                      (label-dir . -1)
290                      (mute-string . "M")
291                      (xo-font-magnification . 0.4)
292                      (xo-padding . 0.3))) {
293           \fret-diagram-verbose #'((mute 6)
294                                    (place-fret 5 3 1)
295                                    (place-fret 4 5 2)
296                                    (place-fret 3 5 3)
297                                    (place-fret 2 5 4)
298                                    (place-fret 1 3 1)
299                                    (barre 4 2 5)
300                                    (barre 5 1 3))
301         }
302       }
303     }
304
305     %% C major for guitar, with capo on third fret
306     %  verbose style
307     c'2^\markup {
308       % 110% of default size
309       \override #'(size . 1.1) {
310         \override #'(fret-diagram-details . (
311                      (number-type . roman-upper)
312                      (dot-label-font-mag . 0.9)
313                      (finger-code . none)
314                      (fret-label-vertical-offset . 0.5)
315                      (xo-font-magnification . 0.4)
316                      (xo-padding . 0.3))) {
317           \fret-diagram-verbose #'((mute 6)
318                                    (capo 3)
319                                    (open 5)
320                                    (place-fret 4 5 1)
321                                    (place-fret 3 5 2)
322                                    (place-fret 2 5 3)
323                                    (open 1))
324         }
325       }
326     }
327
328     %% simple D chord
329     d'2^\markup {
330       \override #'(fret-diagram-details . (
331                    (finger-code . below-string)
332                    (dot-radius . 0.35)
333                    (dot-position . 0.5)
334                    (fret-count . 3))) {
335         \fret-diagram-terse #"x;x;o;2-1;3-2;2-3;"
336       }
337     }
338
339     %% simple D chord, large top fret thickness
340     d'2^\markup {
341       \override #'(fret-diagram-details . (
342                    (finger-code . below-string)
343                    (dot-radius . 0.35)
344                    (dot-position . 0.5)
345                    (top-fret-thickness . 7)
346                    (fret-count . 3))) {
347         \fret-diagram-terse #"x;x;o;2-1;3-2;2-3;"
348       }
349     }
350   }
351 >>