Rietveld Code Review Tool
Help | Bug tracker | Discussion group | Source code | Sign in
(113)

Side by Side Diff: Documentation/notation/fretted-strings.itely

Issue 1242044: Doc: NR: Reformat ly code. (Closed)
Patch Set: Make changes requested by Graham. Created 13 years, 10 months ago
Left:
Right:
Use n/p to move between diff chunks; N/P to move between comments. Please Sign in to add in-line comments.
Jump to:
View unified diff | Download patch
OLDNEW
1 @c -*- coding: utf-8; mode: texinfo; -*- 1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @ignore 2 @ignore
3 Translation of GIT committish: FILL-IN-HEAD-COMMITTISH 3 Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
4 4
5 When revising a translation, copy the HEAD committish of the 5 When revising a translation, copy the HEAD committish of the
6 version that you are working on. For details, see the Contributors' 6 version that you are working on. For details, see the Contributors'
7 Guide, node Updating translation committishes.. 7 Guide, node Updating translation committishes..
8 @end ignore 8 @end ignore
9 9
10 @c \version "2.12.0" 10 @c \version "2.12.0"
(...skipping 87 matching lines...) Expand 10 before | Expand all | Expand 10 after
98 98
99 The string on which a note should be played may be indicated by 99 The string on which a note should be played may be indicated by
100 appending @code{\@var{number}} to a note inside a chord construct 100 appending @code{\@var{number}} to a note inside a chord construct
101 @code{<>}. 101 @code{<>}.
102 102
103 @warning{String numbers @strong{must} be defined inside a chord 103 @warning{String numbers @strong{must} be defined inside a chord
104 construct even if there is only a single note.} 104 construct even if there is only a single note.}
105 105
106 @lilypond[verbatim,quote,relative=0] 106 @lilypond[verbatim,quote,relative=0]
107 \clef "treble_8" 107 \clef "treble_8"
108 <c\5>4 <e\4> <g\3>2 108 <c\5>4 <e\4> <g\3>2 |
109 <c,\5 e\4 g\3>1 109 <c,\5 e\4 g\3>1 |
110 @end lilypond 110 @end lilypond
111 111
112 When fingerings and string indications are used together, their 112 When fingerings and string indications are used together, their
113 placement is controlled by the order in which the two items appear 113 placement is controlled by the order in which the two items appear
114 in the code: 114 in the code:
115 115
116 @lilypond[verbatim,quote,relative=1] 116 @lilypond[verbatim,quote,relative=1]
117 \clef "treble_8" 117 \clef "treble_8"
118 <g\3-0>2 118 <g\3-0>2 <g-0\3>
119 <g-0\3>
120 @end lilypond 119 @end lilypond
121 120
122 @snippets 121 @snippets
123 122
124 @lilypondfile[verbatim,lilyquote,texidoc,doctitle] 123 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
125 {controlling-the-placement-of-chord-fingerings.ly} 124 {controlling-the-placement-of-chord-fingerings.ly}
126 125
127 @lilypondfile[verbatim,lilyquote,texidoc,doctitle] 126 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
128 {allowing-fingerings-to-be-printed-inside-the-staff.ly} 127 {allowing-fingerings-to-be-printed-inside-the-staff.ly}
129 128
(...skipping 27 matching lines...) Expand all
157 are printed on top of each other if they are to be played 156 are printed on top of each other if they are to be played
158 simultaneously. 157 simultaneously.
159 158
160 By default, string 1 is the highest, and the tuning defaults to the 159 By default, string 1 is the highest, and the tuning defaults to the
161 standard guitar tuning (with 6 strings). The notes are printed as 160 standard guitar tuning (with 6 strings). The notes are printed as
162 tablature, by using @code{TabStaff} and @code{TabVoice} contexts. A 161 tablature, by using @code{TabStaff} and @code{TabVoice} contexts. A
163 calligraphic tablature clef is added automatically. 162 calligraphic tablature clef is added automatically.
164 163
165 @lilypond[quote,ragged-right,verbatim] 164 @lilypond[quote,ragged-right,verbatim]
166 \new TabStaff \relative c' { 165 \new TabStaff \relative c' {
167 a,8 a' <c e> a 166 a,8 a' <c e> a d, a' <d f> a
168 d, a' <d f> a
169 } 167 }
170 @end lilypond 168 @end lilypond
171 169
172 Default tablatures do not contain any symbols for tone duration nor any 170 Default tablatures do not contain any symbols for tone duration nor any
173 other musical symbols such as e.g. expressive marks. 171 other musical symbols such as e.g. expressive marks.
174 172
175 @lilypond[quote,ragged-right,verbatim] 173 @lilypond[quote,ragged-right,verbatim]
176 symbols = { 174 symbols = {
177 \time 3/4 175 \time 3/4
178 c4-.^"Allegro" d( e) 176 c4-.^"Allegro" d( e) |
179 f4-.\f g a^\fermata 177 f4-.\f g a^\fermata |
180 \mark \default 178 \mark \default
181 c8_.\<\( c16 c ~ c2\! 179 c8_.\<\( c16 c~ c2\! |
182 c'2.\prall\) 180 c'2.\prall\) |
183 } 181 }
184 182
185 \score { 183 \score {
186 << 184 <<
187 \new Staff { \clef "G_8" \symbols } 185 \new Staff { \clef "G_8" \symbols }
188 \new TabStaff { \symbols } 186 \new TabStaff { \symbols }
189 >> 187 >>
190 } 188 }
191 @end lilypond 189 @end lilypond
192 190
193 @funindex \tabFullNotation 191 @funindex \tabFullNotation
194 192
195 If all musical symbols used in traditional notation should also show up 193 If all musical symbols used in traditional notation should also show up
196 in tablature one has to apply the command @code{\tabFullNotation} in a 194 in tablature one has to apply the command @code{\tabFullNotation} in a
197 @code{TabStaff}-context. Please bear in mind that half notes are 195 @code{TabStaff}-context. Please bear in mind that half notes are
198 double-stemmed in tablature in order to distinguish them from quarter 196 double-stemmed in tablature in order to distinguish them from quarter
199 notes. 197 notes.
200 198
201 @lilypond[quote,ragged-right,verbatim] 199 @lilypond[quote,ragged-right,verbatim]
202 symbols = { 200 symbols = {
203 \time 3/4 201 \time 3/4
204 c4-.^"Allegro" d( e) 202 c4-.^"Allegro" d( e) |
205 f4-.\f g a^\fermata 203 f4-.\f g a^\fermata |
206 \mark \default 204 \mark \default
207 c8_.\<\( c16 c ~ c2\! 205 c8_.\<\( c16 c~ c2\! |
208 c'2.\prall\) 206 c'2.\prall\) |
209 } 207 }
210 208
211 \score { 209 \score {
212 \new TabStaff { 210 \new TabStaff {
213 \tabFullNotation 211 \tabFullNotation
214 \symbols 212 \symbols
215 } 213 }
216 } 214 }
217 @end lilypond 215 @end lilypond
218 216
(...skipping 10 matching lines...) Expand all
229 notation. It is much more comfortable to define the playing position 227 notation. It is much more comfortable to define the playing position
230 by using the value of @code{minimumFret}. The default value for 228 by using the value of @code{minimumFret}. The default value for
231 minimumFret is 0. 229 minimumFret is 0.
232 230
233 231
234 @lilypond[quote,ragged-right,verbatim] 232 @lilypond[quote,ragged-right,verbatim]
235 \new StaffGroup << 233 \new StaffGroup <<
236 \new Staff \relative c { 234 \new Staff \relative c {
237 \clef "treble_8" 235 \clef "treble_8"
238 \time 2/4 236 \time 2/4
239 c16 d e f g4 237 c16 d e f g4 |
240 c,16\5 d\5 e\4 f\4 g4\4 238 c,16\5 d\5 e\4 f\4 g4\4 |
241 c,16 d e f g4 239 c,16 d e f g4 |
242 } 240 }
243 \new TabStaff \relative c { 241 \new TabStaff \relative c {
244 c16 d e f g4 242 c16 d e f g4 |
245 c,16\5 d\5 e\4 f\4 g4\4 243 c,16\5 d\5 e\4 f\4 g4\4 |
246 \set TabStaff.minimumFret = #5 244 \set TabStaff.minimumFret = #5
247 c,16 d e f g4 245 c,16 d e f g4 |
248 } 246 }
249 >> 247 >>
250 @end lilypond 248 @end lilypond
251 249
252 @funindex \tabChordRepetition 250 @funindex \tabChordRepetition
253 251
254 Chord constructs can be repeated by the chord repetition symbol @code{q}. 252 Chord constructs can be repeated by the chord repetition symbol @code{q}.
255 To use this feature in combination with tablature, @code{\tabChordRepetition} 253 To use this feature in combination with tablature, @code{\tabChordRepetition}
256 is provided. It preserves the string information explicitly given within 254 is provided. It preserves the string information explicitly given within
257 chord constructs so repeated chords get identical tablature representations. 255 chord constructs so repeated chords get identical tablature representations.
258 256
259 @lilypond[quote,verbatim] 257 @lilypond[quote,verbatim]
260 \tabChordRepetition 258 \tabChordRepetition
261 259
262 guitar = \relative c' { 260 guitar = \relative c' {
263 r8 < gis\4 cis\3 b\2 > ~ q4 q8 ~ q q4 261 r8 <gis\4 cis\3 b\2>~ q4 q8~ q q4
264 } 262 }
265 263
266 \new StaffGroup << 264 \new StaffGroup <<
267 \new Staff { 265 \new Staff {
268 \clef "treble_8" 266 \clef "treble_8"
269 \override Voice.StringNumber #'transparent = ##t 267 \override Voice.StringNumber #'transparent = ##t
270 \guitar 268 \guitar
271 } 269 }
272 \new TabStaff { 270 \new TabStaff { \guitar }
273 \guitar
274 }
275 >> 271 >>
276 @end lilypond 272 @end lilypond
277 273
278 274
279 Ties over a line break are parenthesized by default. The same holds for 275 Ties over a line break are parenthesized by default. The same holds for
280 the second alternative of a repeat. 276 the second alternative of a repeat.
281 277
282 @lilypond[quote,ragged-right,verbatim] 278 @lilypond[quote,ragged-right,verbatim]
283 ties = \relative c' { 279 ties = \relative c' {
284 \repeat volta 2 { 280 \repeat volta 2 {
285 e2. f4~ 281 e2. f4~ |
286 f2 g2~ 282 f2 g2~ |
287 } 283 }
288 \alternative { 284 \alternative {
289 { g4 f2. } 285 { g4 f2. | }
290 { g4\repeatTie c,2. } 286 { g4\repeatTie c,2. | }
291 } 287 }
292 b1~ 288 b1~ |
293 \break 289 \break
294 b1 290 b1 |
295 \bar "|." 291 \bar "|."
296 } 292 }
297 293
298 \score { 294 \score {
299 << 295 <<
300 \new StaffGroup << 296 \new StaffGroup <<
301 \context Staff { 297 \context Staff { \clef "treble_8" \ties }
302 \clef "treble_8" 298 \context TabStaff { \ties }
303 \ties
304 }
305 \context TabStaff {
306 \ties
307 }
308 >> 299 >>
309 >> 300 >>
310 \layout { 301 \layout {
311 indent = #0 302 indent = #0
312 ragged-right = ##t 303 ragged-right = ##t
313 } 304 }
314 } 305 }
315 @end lilypond 306 @end lilypond
316 307
317 @funindex \hideSplitTiedTabNotes 308 @funindex \hideSplitTiedTabNotes
318 309
319 The command @code{\hideSplitTiedTabNotes} cancels the behavior of 310 The command @code{\hideSplitTiedTabNotes} cancels the behavior of
320 engraving fret numbers in parentheses: 311 engraving fret numbers in parentheses:
321 312
322 @lilypond[quote,ragged-right,verbatim] 313 @lilypond[quote,ragged-right,verbatim]
323 ties = \relative c' { 314 ties =
324 \repeat volta 2 { 315 \relative c' {
Graham Percival (old account) 2010/05/25 18:52:02 the \relative should be on the same line as the "t
325 e2. f4~ 316 \repeat volta 2 { e2. f4~ | f2 g2~ | }
326 f2 g2~ }
327 \alternative { 317 \alternative {
328 { g4 f2. } 318 { g4 f2. | }
329 { g4\repeatTie c,2. } 319 { g4\repeatTie c,2. | }
330 } 320 }
331 b1~ 321 b1~ | \break
332 \break 322 b1 | \bar "|."
333 b1
334 \bar "|."
335 } 323 }
336 324
337 \score { 325 \score {
338 << 326 <<
339 \new StaffGroup << 327 \new StaffGroup <<
340 \context Staff { 328 \context Staff { \clef "treble_8" \ties }
341 \clef "treble_8" 329 \context TabStaff {
342 \ties 330 \hideSplitTiedTabNotes
343 }
344 \context TabStaff {
345 \hideSplitTiedTabNotes
346 \ties 331 \ties
347 } 332 }
348 >> 333 >>
349 >> 334 >>
350 \layout { 335 \layout {
351 indent = #0 336 indent = #0
352 ragged-right = ##t 337 ragged-right = ##t
353 } 338 }
354 } 339 }
355 @end lilypond 340 @end lilypond
356 341
357 @cindex harmonic indications in tablature notation 342 @cindex harmonic indications in tablature notation
358 @cindex tablature and harmonic indications 343 @cindex tablature and harmonic indications
359 @cindex slides in tablature notation 344 @cindex slides in tablature notation
360 @cindex tablature and slides 345 @cindex tablature and slides
361 346
362 Harmonic indications and slides can be added to tablature 347 Harmonic indications and slides can be added to tablature
363 notation. 348 notation.
364 349
365 @lilypond[verbatim, quote, relative=1] 350 @lilypond[verbatim, quote, relative=1]
366 \new TabStaff { 351 \new TabStaff {
367 \new TabVoice { 352 \new TabVoice {
368 <c g'\harmonic> d\2\glissando e\2 353 <c g'\harmonic>4 d\2\glissando e\2
369 } 354 }
370 } 355 }
371 @end lilypond 356 @end lilypond
372 357
373 358
374 @snippets 359 @snippets
375 360
376 @lilypondfile[verbatim,lilyquote,texidoc,doctitle] 361 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
377 {stem-and-beam-behavior-in-tablature.ly} 362 {stem-and-beam-behavior-in-tablature.ly}
378 363
(...skipping 18 matching lines...) Expand all
397 @knownissues 382 @knownissues
398 383
399 Chords are not handled in a special way, and hence the automatic 384 Chords are not handled in a special way, and hence the automatic
400 string selector may easily select the same string for two notes in 385 string selector may easily select the same string for two notes in
401 a chord. 386 a chord.
402 387
403 In order to handle @code{\partcombine}, a @code{TabStaff} must use 388 In order to handle @code{\partcombine}, a @code{TabStaff} must use
404 specially-created voices: 389 specially-created voices:
405 390
406 @lilypond[quote,ragged-right,verbatim] 391 @lilypond[quote,ragged-right,verbatim]
407 melodia = \partcombine { e4 g g g }{ e4 e e e } 392 melodia = \partcombine { e4 g g g } { e4 e e e }
408 << 393 <<
409 \new TabStaff << 394 \new TabStaff <<
410 \new TabVoice = "one" s1 395 \new TabVoice = "one" s1
411 \new TabVoice = "two" s1 396 \new TabVoice = "two" s1
412 \new TabVoice = "shared" s1 397 \new TabVoice = "shared" s1
413 \new TabVoice = "solo" s1 398 \new TabVoice = "solo" s1
414 { \melodia } 399 { \melodia }
415 >> 400 >>
416 >> 401 >>
417 @end lilypond 402 @end lilypond
(...skipping 22 matching lines...) Expand all
440 LilyPond comes with predefined string tunings for banjo, mandolin, 425 LilyPond comes with predefined string tunings for banjo, mandolin,
441 guitar, bass guitar and ukulele. LilyPond automatically sets 426 guitar, bass guitar and ukulele. LilyPond automatically sets
442 the correct transposition for predefined tunings. The following 427 the correct transposition for predefined tunings. The following
443 example is for bass guitar, which sounds an octave lower than 428 example is for bass guitar, which sounds an octave lower than
444 written. 429 written.
445 430
446 @lilypond[quote,ragged-right,verbatim] 431 @lilypond[quote,ragged-right,verbatim]
447 << 432 <<
448 \new Staff { 433 \new Staff {
449 \clef "bass_8" 434 \clef "bass_8"
450 \relative c, { 435 \relative c, { c4 d e f }
451 c4 d e f
452 }
453 } 436 }
454 \new TabStaff { 437 \new TabStaff {
455 \set TabStaff.stringTunings = #bass-tuning 438 \set TabStaff.stringTunings = #bass-tuning
456 \relative c, { 439 \relative c, { c4 d e f }
457 c4 d e f
458 }
459 } 440 }
460 >> 441 >>
461 @end lilypond 442 @end lilypond
462 443
463 The default string tuning is @code{guitar-tuning}, which 444 The default string tuning is @code{guitar-tuning}, which
464 is the standard EADGBE tuning. Some other predefined tunings are 445 is the standard EADGBE tuning. Some other predefined tunings are
465 @code{guitar-open-g-tuning}, @code{mandolin-tuning} and 446 @code{guitar-open-g-tuning}, @code{mandolin-tuning} and
466 @code{banjo-open-g-tuning}. The predefined string tunings 447 @code{banjo-open-g-tuning}. The predefined string tunings
467 are found in @code{scm/tablature.scm}. 448 are found in @code{scm/tablature.scm}.
468 449
(...skipping 12 matching lines...) Expand all
481 462
482 LilyPond automatically calculates the number of strings in the 463 LilyPond automatically calculates the number of strings in the
483 @code{TabStaff} as the number of elements in @code{stringTunings}. 464 @code{TabStaff} as the number of elements in @code{stringTunings}.
484 465
485 Any desired string tuning can be created. For example, we can 466 Any desired string tuning can be created. For example, we can
486 define a string tuning for a four-string instrument with pitches 467 define a string tuning for a four-string instrument with pitches
487 of @code{a''}, @code{d''}, @code{g'}, and @code{c'}: 468 of @code{a''}, @code{d''}, @code{g'}, and @code{c'}:
488 469
489 470
490 @lilypond[quote,verbatim] 471 @lilypond[quote,verbatim]
491 mynotes = { 472 mynotes = \relative c' {
492 c'4 e' g' c'' | 473 c4 e g c | e4 g b c |
493 e'' g'' b'' c'''
494 } 474 }
495 475
496 << 476 <<
497 \new Staff { 477 \new Staff {
498 \clef treble 478 \clef "treble"
499 \mynotes 479 \mynotes
500 } 480 }
501 \new TabStaff { 481 \new TabStaff {
502 \set TabStaff.stringTunings = #'(21 14 7 0) 482 \set TabStaff.stringTunings = #'(21 14 7 0)
503 \mynotes 483 \mynotes
504 } 484 }
505 >> 485 >>
506 @end lilypond 486 @end lilypond
507 487
508 @cindex moderntab clef 488 @cindex moderntab clef
509 @cindex clef, moderntab 489 @cindex clef, moderntab
510 @cindex clef, tab 490 @cindex clef, tab
511 @cindex tab clef 491 @cindex tab clef
512 492
513 A modern tab clef can also be used. 493 A modern tab clef can also be used.
514 494
515 @lilypond[quote,ragged-right,verbatim] 495 @lilypond[quote,ragged-right,verbatim]
516 \new TabStaff { 496 \new TabStaff {
517 \clef moderntab 497 \clef "moderntab" <a, e a>1 | \break
518 <a, e a>1 498 \clef "tab" <a, e a>1 |
519 \break
520 \clef tab
521 <a, e a>1
522 } 499 }
523 @end lilypond 500 @end lilypond
524 501
525 The modern tab clef supports tablatures from 4 to 7 strings. 502 The modern tab clef supports tablatures from 4 to 7 strings.
526 503
527 @seealso 504 @seealso
528 Installed Files: 505 Installed Files:
529 @file{scm/@/tablature@/.scm}. 506 @file{scm/@/tablature@/.scm}.
530 507
531 Snippets: 508 Snippets:
(...skipping 25 matching lines...) Expand all
557 information in the markup string. Details about the markup 534 information in the markup string. Details about the markup
558 interfaces are found at @ref{Text markup commands}. 535 interfaces are found at @ref{Text markup commands}.
559 536
560 The standard fret diagram markup string indicates the string 537 The standard fret diagram markup string indicates the string
561 number and the fret number for each dot to be placed on the string. 538 number and the fret number for each dot to be placed on the string.
562 In addition, open and unplayed (muted) strings can be indicated. 539 In addition, open and unplayed (muted) strings can be indicated.
563 540
564 @lilypond[quote, verbatim] 541 @lilypond[quote, verbatim]
565 << 542 <<
566 \context ChordNames { 543 \context ChordNames {
567 \chordmode { 544 \chordmode { c1 | d1:m | }
568 c1 d:m
569 }
570 } 545 }
571 \context Staff { 546 \context Staff {
572 \clef "treble_8" 547 \clef "treble_8"
573 < c e g c' e' > 1 ^\markup 548 <c e g c' e'>1^\markup
574 \fret-diagram #"6-x;5-3;4-2;3-o;2-1;1-o;" 549 \fret-diagram #"6-x;5-3;4-2;3-o;2-1;1-o;" |
575 < d a d' f'> ^\markup 550 <d a d' f'>1^\markup
576 \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-1;" 551 \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-1;" |
577 } 552 }
578 >> 553 >>
579 @end lilypond 554 @end lilypond
580 555
581 @cindex barre indications 556 @cindex barre indications
582 557
583 Barre indications can be added to the diagram from 558 Barre indications can be added to the diagram from
584 the fret-diagram markup string. 559 the fret-diagram markup string.
585 560
586 @lilypond[quote, verbatim] 561 @lilypond[quote, verbatim]
587 << 562 <<
588 \context ChordNames { 563 \context ChordNames {
589 \chordmode { 564 \chordmode { f1 | g1 | }
590 f1 g
591 }
592 } 565 }
593 \context Staff { 566 \context Staff {
594 \clef "treble_8" 567 \clef "treble_8"
595 < f, c f a c' f'>1 ^\markup 568 <f, c f a c' f'>1^\markup
596 \fret-diagram #"c:6-1-1;6-1;5-3;4-3;3-2;2-1;1-1;" 569 \fret-diagram #"c:6-1-1;6-1;5-3;4-3;3-2;2-1;1-1;" |
597 < g, d g b d' g'> ^\markup 570 <g, d g b d' g'>1^\markup
598 \fret-diagram #"c:6-1-3;6-3;5-5;4-5;3-4;2-3;1-3;" 571 \fret-diagram #"c:6-1-3;6-3;5-5;4-5;3-4;2-3;1-3;" |
599 } 572 }
600 >> 573 >>
601 @end lilypond 574 @end lilypond
602 575
603 @cindex fret-diagram markup 576 @cindex fret-diagram markup
604 577
605 @funindex fret-diagram 578 @funindex fret-diagram
606 @funindex \fret-diagram 579 @funindex \fret-diagram
607 580
608 The size of the fret diagram, and the number of frets in the diagram 581 The size of the fret diagram, and the number of frets in the diagram
609 can be changed in the fret-diagram markup string. 582 can be changed in the fret-diagram markup string.
610 583
611 @lilypond[quote, verbatim] 584 @lilypond[quote, verbatim]
612 << 585 <<
613 \context ChordNames { 586 \context ChordNames {
614 \chordmode { 587 \chordmode { f1 | g1 | }
615 f1 g
616 }
617 } 588 }
618 \context Staff { 589 \context Staff {
619 \clef "treble_8" 590 \clef "treble_8"
620 < f, c f a c' f'>1 ^\markup 591 <f, c f a c' f'>1^\markup
621 \fret-diagram #"s:1.5;c:6-1-1;6-1;5-3;4-3;3-2;2-1;1-1;" 592 \fret-diagram #"s:1.5;c:6-1-1;6-1;5-3;4-3;3-2;2-1;1-1;" |
622 < g, b, d g b g'> ^\markup 593 <g, b, d g b g'>1^\markup
623 \fret-diagram #"h:6;6-3;5-2;4-o;3-o;2-o;1-3;" 594 \fret-diagram #"h:6;6-3;5-2;4-o;3-o;2-o;1-3;" |
624 } 595 }
625 >> 596 >>
626 @end lilypond 597 @end lilypond
627 598
628 The number of strings in a fret diagram can be changed to accomodate 599 The number of strings in a fret diagram can be changed to accomodate
629 different instruments such as banjos and ukuleles with the fret-diagram 600 different instruments such as banjos and ukuleles with the fret-diagram
630 markup string. 601 markup string.
631 602
632 @lilypond[quote, verbatim] 603 @lilypond[quote, verbatim]
633 << 604 <<
634 \context ChordNames { 605 \context ChordNames {
635 \chordmode { 606 \chordmode { a1 }
636 a1
637 }
638 } 607 }
639 \context Staff { 608 \context Staff {
640 %% An A chord for ukulele 609 %% An A chord for ukulele
641 a'1 ^\markup \fret-diagram #"w:4;4-2-2;3-1-1;2-o;1-o;" 610 a'1^\markup \fret-diagram #"w:4;4-2-2;3-1-1;2-o;1-o;"
642 } 611 }
643 >> 612 >>
644 @end lilypond 613 @end lilypond
645 614
646 Fingering indications can be added, and the location of fingering labels 615 Fingering indications can be added, and the location of fingering labels
647 can be controlled by the fret-diagram markup string. 616 can be controlled by the fret-diagram markup string.
648 617
649 @lilypond[quote, verbatim] 618 @lilypond[quote, verbatim]
650 << 619 <<
651 \context ChordNames { 620 \context ChordNames {
652 \chordmode { 621 \chordmode { c1 | d1:m | }
653 c1 d:m
654 }
655 } 622 }
656 \context Staff { 623 \context Staff {
657 \clef "treble_8" 624 \clef "treble_8"
658 < c e g c' e' > 1 ^\markup 625 <c e g c' e'>1^\markup
659 \fret-diagram #"f:1;6-x;5-3-3;4-2-2;3-o;2-1-1;1-o;" 626 \fret-diagram #"f:1;6-x;5-3-3;4-2-2;3-o;2-1-1;1-o;" |
660 < d a d' f'> ^\markup 627 <d a d' f'>1^\markup
661 \fret-diagram #"f:2;6-x;5-x;4-o;3-2-2;2-3-3;1-1-1;" 628 \fret-diagram #"f:2;6-x;5-x;4-o;3-2-2;2-3-3;1-1-1;" |
662 } 629 }
663 >> 630 >>
664 @end lilypond 631 @end lilypond
665 632
666 Dot radius and dot position can be controlled with the fret-diagram 633 Dot radius and dot position can be controlled with the fret-diagram
667 markup string. 634 markup string.
668 635
669 @lilypond[quote, verbatim] 636 @lilypond[quote, verbatim]
670 << 637 <<
671 \context ChordNames { 638 \context ChordNames {
672 \chordmode { 639 \chordmode { c1 | d1:m | }
673 c1 d:m
674 }
675 } 640 }
676 \context Staff { 641 \context Staff {
677 \clef "treble_8" 642 \clef "treble_8"
678 < c e g c' e' > 1 ^\markup 643 <c e g c' e'>1^\markup
679 \fret-diagram #"d:0.35;6-x;5-3;4-2;3-o;2-1;1-o;" 644 \fret-diagram #"d:0.35;6-x;5-3;4-2;3-o;2-1;1-o;" |
680 < d a d' f'> ^\markup 645 <d a d' f'>1^\markup
681 \fret-diagram #"p:0.2;6-x;5-x;4-o;3-2;2-3;1-1;" 646 \fret-diagram #"p:0.2;6-x;5-x;4-o;3-2;2-3;1-1;" |
682 } 647 }
683 >> 648 >>
684 @end lilypond 649 @end lilypond
685 650
686 @cindex fret-diagram-terse markup 651 @cindex fret-diagram-terse markup
687 652
688 @funindex fret-diagram-terse 653 @funindex fret-diagram-terse
689 @funindex \fret-diagram-terse 654 @funindex \fret-diagram-terse
690 655
691 The fret-diagram-terse markup string omits string numbers; the string 656 The fret-diagram-terse markup string omits string numbers; the string
692 number is implied by the presence of semicolons. There is one semicolon 657 number is implied by the presence of semicolons. There is one semicolon
693 for each string in the diagram. The first semicolon corresponds to the 658 for each string in the diagram. The first semicolon corresponds to the
694 highest string number and the last semicolon corresponds to the first string. 659 highest string number and the last semicolon corresponds to the first string.
695 Mute strings, open strings, and fret numbers can be indicated. 660 Mute strings, open strings, and fret numbers can be indicated.
696 661
697 @lilypond[quote, verbatim] 662 @lilypond[quote, verbatim]
698 << 663 <<
699 \context ChordNames { 664 \context ChordNames {
700 \chordmode { 665 \chordmode { c1 | d1:m | }
701 c1 d:m
702 }
703 } 666 }
704 \context Staff { 667 \context Staff {
705 \clef "treble_8" 668 \clef "treble_8"
706 < c e g c' e' > 1 ^\markup 669 <c e g c' e'>1^\markup
707 \fret-diagram-terse #"x;3;2;o;1;o;" 670 \fret-diagram-terse #"x;3;2;o;1;o;" |
708 < d a d' f'> ^\markup 671 <d a d' f'>1^\markup
709 \fret-diagram-terse #"x;x;o;2;3;1;" 672 \fret-diagram-terse #"x;x;o;2;3;1;" |
710 } 673 }
711 >> 674 >>
712 @end lilypond 675 @end lilypond
713 676
714 Barre indicators can be included in the fret-diagram-terse markup string. 677 Barre indicators can be included in the fret-diagram-terse markup string.
715 678
716 @lilypond[quote, verbatim] 679 @lilypond[quote, verbatim]
717 << 680 <<
718 \context ChordNames { 681 \context ChordNames {
719 \chordmode { 682 \chordmode { f1 | g1 | }
720 f1 g
721 }
722 } 683 }
723 \context Staff { 684 \context Staff {
724 \clef "treble_8" 685 \clef "treble_8"
725 < f, c f a c' f'>1 ^\markup 686 <f, c f a c' f'>1^\markup
726 \fret-diagram-terse #"1-(;3;3;2;1;1-);" 687 \fret-diagram-terse #"1-(;3;3;2;1;1-);" |
727 < g, d g b d' g'> ^\markup 688 <g, d g b d' g'>1^\markup
728 \fret-diagram-terse #"3-(;5;5;4;3;3-);" 689 \fret-diagram-terse #"3-(;5;5;4;3;3-);" |
729 } 690 }
730 >> 691 >>
731 @end lilypond 692 @end lilypond
732 693
733 Fingering indications can be included in the fret-diagram-terse markup string. 694 Fingering indications can be included in the fret-diagram-terse markup string.
734 695
735 @c Need to use override to enable fingerings to show this -- can we do so? 696 @c Need to use override to enable fingerings to show this -- can we do so?
736 @lilypond[quote, verbatim] 697 @lilypond[quote, verbatim]
737 << 698 <<
738 \context ChordNames { 699 \context ChordNames {
739 \chordmode { 700 \chordmode { c1 | d1:m | }
740 c1 d:m
741 }
742 } 701 }
743 \context Staff { 702 \context Staff {
744 \override Voice.TextScript 703 \override Voice.TextScript
745 #'(fret-diagram-details finger-code) = #'below-string 704 #'(fret-diagram-details finger-code) = #'below-string
746 \clef "treble_8" 705 \clef "treble_8"
747 < c e g c' e' > 1 ^\markup 706 <c e g c' e'>1^\markup
748 \fret-diagram-terse #"x;3-3;2-2;o;1-1;o;" 707 \fret-diagram-terse #"x;3-3;2-2;o;1-1;o;" |
749 < d a d' f'> ^\markup 708 <d a d' f'>1^\markup
750 \fret-diagram-terse #"x;x;o;2-2;3-3;1-1;" 709 \fret-diagram-terse #"x;x;o;2-2;3-3;1-1;" |
751 } 710 }
752 >> 711 >>
753 @end lilypond 712 @end lilypond
754 713
755 Other fret diagram properties must be adjusted using @code{\override} when using 714 Other fret diagram properties must be adjusted using @code{\override} when using
756 the fret-diagram-terse markup. 715 the fret-diagram-terse markup.
757 716
758 @cindex fret-diagram-verbose markup 717 @cindex fret-diagram-verbose markup
759 718
760 @funindex fret-diagram-verbose 719 @funindex fret-diagram-verbose
761 @funindex \fret-diagram-verbose 720 @funindex \fret-diagram-verbose
762 721
763 The fret-diagram-verbose markup string is in the format of a Scheme list. Each 722 The fret-diagram-verbose markup string is in the format of a Scheme list. Each
764 element of the list indicates an item to be placed on the fret diagram. 723 element of the list indicates an item to be placed on the fret diagram.
765 724
766 @lilypond[quote, verbatim] 725 @lilypond[quote, verbatim]
767 << \context ChordNames { 726 <<
768 \chordmode { 727 \context ChordNames {
769 c1 d:m 728 \chordmode { c1 | d1:m | }
770 }
771 } 729 }
772 \context Staff { 730 \context Staff {
773 \clef "treble_8" 731 \clef "treble_8"
774 < c e g c' e' > 1 ^\markup 732 <c e g c' e'>1^\markup
775 \fret-diagram-verbose #'( 733 \fret-diagram-verbose #'((mute 6)
776 (mute 6) 734 (place-fret 5 3)
777 (place-fret 5 3) 735 (place-fret 4 2)
778 (place-fret 4 2) 736 (open 3)
779 (open 3) 737 (place-fret 2 1)
780 (place-fret 2 1) 738 (open 1)) |
781 (open 1) 739 <d a d' f'>1^\markup
782 ) 740 \fret-diagram-verbose #'((mute 6)
783 < d a d' f'> ^\markup 741 (mute 5)
784 \fret-diagram-verbose #'( 742 (open 4)
785 (mute 6) 743 (place-fret 3 2)
786 (mute 5) 744 (place-fret 2 3)
787 (open 4) 745 (place-fret 1 1)) |
788 (place-fret 3 2)
789 (place-fret 2 3)
790 (place-fret 1 1)
791 )
792 } 746 }
793 >> 747 >>
794 @end lilypond 748 @end lilypond
795 749
796 Fingering indications and barres can be included in a 750 Fingering indications and barres can be included in a
797 fret-diagram-verbose markup string. Unique to the 751 fret-diagram-verbose markup string. Unique to the
798 fret-diagram-verbose interface is a capo indication that 752 fret-diagram-verbose interface is a capo indication that
799 can be placed on the fret diagram. The capo indication is 753 can be placed on the fret diagram. The capo indication is
800 a thick bar that covers all strings. The fret with the 754 a thick bar that covers all strings. The fret with the
801 capo will be the lowest fret in the fret diagram. 755 capo will be the lowest fret in the fret diagram.
802 756
803 @c \override is necessary to make fingering visible 757 @c \override is necessary to make fingering visible
804 @lilypond[quote, verbatim] 758 @lilypond[quote, verbatim]
805 << 759 <<
806 \context ChordNames { 760 \context ChordNames {
807 \chordmode { 761 \chordmode { f1 | g1 | c1 | }
808 f1 g c
809 }
810 } 762 }
811 \context Staff { 763 \context Staff {
812 \clef "treble_8" 764 \clef "treble_8"
813 \override Voice.TextScript 765 \override Voice.TextScript
814 #'(fret-diagram-details finger-code) = #'below-string 766 #'(fret-diagram-details finger-code) = #'below-string
815 767
816 < f, c f a c' f'>1 ^\markup 768 <f, c f a c' f'>1^\markup
817 \fret-diagram-verbose #'( 769 \fret-diagram-verbose #'((place-fret 6 1)
818 (place-fret 6 1) 770 (place-fret 5 3)
819 (place-fret 5 3) 771 (place-fret 4 3)
820 (place-fret 4 3) 772 (place-fret 3 2)
821 (place-fret 3 2) 773 (place-fret 2 1)
822 (place-fret 2 1) 774 (place-fret 1 1)
823 (place-fret 1 1) 775 (barre 6 1 1)) |
824 (barre 6 1 1) 776 <g, b, d g b g'>1^\markup
825 ) 777 \fret-diagram-verbose #'((place-fret 6 3 2)
826 < g, b, d g b g'> ^\markup 778 (place-fret 5 2 1)
827 \fret-diagram-verbose #'( 779 (open 4)
828 (place-fret 6 3 2) 780 (open 3)
829 (place-fret 5 2 1) 781 (open 2)
830 (open 4) 782 (place-fret 1 3 3)) |
831 (open 3) 783 <c e g c' e'>1^\markup
832 (open 2) 784 \fret-diagram-verbose #'((capo 3)
833 (place-fret 1 3 3) 785 (mute 6)
834 ) 786 (place-fret 4 5 1)
835 < c e g c' e'> ^\markup 787 (place-fret 3 5 2)
836 \fret-diagram-verbose #'( 788 (place-fret 2 5 3)) |
837 (capo 3)
838 (mute 6)
839 (place-fret 4 5 1)
840 (place-fret 3 5 2)
841 (place-fret 2 5 3)
842 )
843 } 789 }
844 >> 790 >>
845 @end lilypond 791 @end lilypond
846 792
847 All other fret diagram properties must be adjusted using @code{\override} 793 All other fret diagram properties must be adjusted using @code{\override}
848 when using the fret-diagram-verbose markup. 794 when using the fret-diagram-verbose markup.
849 795
850 @ignore 796 @ignore
851 The following example shows the three fret-diagram markup 797 The following example shows the three fret-diagram markup
852 interfaces, along with examples of common tweaks. For example, 798 interfaces, along with examples of common tweaks. For example,
853 the size of the verbose fret diagram is reduced to 0.75, and the 799 the size of the verbose fret diagram is reduced to 0.75, and the
854 finger indications are specified to appear below the diagram. The 800 finger indications are specified to appear below the diagram. The
855 terse diagram includes tweaks to specify placement of finger code 801 terse diagram includes tweaks to specify placement of finger code
856 and color of dots. 802 and color of dots.
857 803
858 @lilypond[verbatim,ragged-right,quote] 804 @lilypond[verbatim,ragged-right,quote]
859 \new Voice { 805 \new Voice {
860 \clef "treble_8" 806 \clef "treble_8"
861 d^\markup \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-2;" 807 d4^\markup \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-2;"
862 d d d 808 d4 d d |
863 fis^\markup \override #'(size . 0.75) { 809 fis4^\markup \override #'(size . 0.75) {
864 \override #'(finger-code . below-string) { 810 \override #'(finger-code . below-string) {
865 \fret-diagram-verbose #'((place-fret 6 2 1) (barre 6 1 2) 811 \fret-diagram-verbose #'((place-fret 6 2 1) (barre 6 1 2)
866 (place-fret 5 4 3) 812 (place-fret 5 4 3)
867 (place-fret 4 4 4) 813 (place-fret 4 4 4)
868 (place-fret 3 3 2) 814 (place-fret 3 3 2)
869 (place-fret 2 2 1) 815 (place-fret 2 2 1)
870 (place-fret 1 2 1)) 816 (place-fret 1 2 1))
871 } 817 }
872 } 818 }
873 fis fis fis 819 fis4 fis fis |
874 c^\markup \override #'(dot-radius . 0.35) { 820 c4^\markup \override #'(dot-radius . 0.35) {
875 \override #'(finger-code . in-dot) { 821 \override #'(finger-code . in-dot) {
876 \override #'(dot-color . white) { 822 \override #'(dot-color . white) {
877 \fret-diagram-terse #"x;3-1-(;5-2;5-3;5-4;3-1-);" 823 \fret-diagram-terse #"x;3-1-(;5-2;5-3;5-4;3-1-);"
878 } 824 }
879 } 825 }
880 } 826 }
881 c c c 827 c4 c c |
882 } 828 }
883 @end lilypond 829 @end lilypond
884 @end ignore 830 @end ignore
885 831
886 @cindex customized fret diagram 832 @cindex customized fret diagram
887 @cindex fret diagram, customized 833 @cindex fret diagram, customized
888 @cindex diagram, fret, customized 834 @cindex diagram, fret, customized
889 835
890 @funindex fret-diagram-interface 836 @funindex fret-diagram-interface
891 837
(...skipping 29 matching lines...) Expand all
921 @funindex FretBoards 867 @funindex FretBoards
922 @funindex stringTunings 868 @funindex stringTunings
923 869
924 Fret diagrams can be displayed using the @code{FretBoards} context. By 870 Fret diagrams can be displayed using the @code{FretBoards} context. By
925 default, the @code{FretBoards} context will display fret diagrams that 871 default, the @code{FretBoards} context will display fret diagrams that
926 are stored in a lookup table: 872 are stored in a lookup table:
927 873
928 @lilypond[verbatim, ragged-right, quote] 874 @lilypond[verbatim, ragged-right, quote]
929 \include "predefined-guitar-fretboards.ly" 875 \include "predefined-guitar-fretboards.ly"
930 \context FretBoards { 876 \context FretBoards {
931 \chordmode { 877 \chordmode { c1 | d1 | }
932 c1 d
933 }
934 } 878 }
935 @end lilypond 879 @end lilypond
936 880
937 The default predefined fret diagrams are contained in the file 881 The default predefined fret diagrams are contained in the file
938 @code{predefined-guitar-fretboards.ly}. Fret diagrams are 882 @code{predefined-guitar-fretboards.ly}. Fret diagrams are
939 stored based on the pitches of a chord and the value of 883 stored based on the pitches of a chord and the value of
940 @code{stringTunings} that is currently in use. 884 @code{stringTunings} that is currently in use.
941 @code{predefined-guitar-fretboards.ly} contains predefined 885 @code{predefined-guitar-fretboards.ly} contains predefined
942 fret diagrams only for @code{guitar-tuning}. Predefined fret 886 fret diagrams only for @code{guitar-tuning}. Predefined fret
943 diagrams can be added for other instruments or other tunings 887 diagrams can be added for other instruments or other tunings
944 by following the examples found in 888 by following the examples found in
945 @code{predefined-guitar-fretboards.ly}. 889 @code{predefined-guitar-fretboards.ly}.
946 890
947 Fret diagrams for the ukulele are contained in the file 891 Fret diagrams for the ukulele are contained in the file
948 @code{predefined-ukulele-fretboards.ly}. 892 @code{predefined-ukulele-fretboards.ly}.
949 893
950 @lilypond[verbatim, ragged-right, quote] 894 @lilypond[verbatim, ragged-right, quote]
951 \include "predefined-ukulele-fretboards.ly" 895 \include "predefined-ukulele-fretboards.ly"
952 896
953 myChords = \chordmode { a1 a:m a:aug } 897 myChords = \chordmode { a1 | a1:m | a1:aug | }
954 898
955 \new ChordNames { 899 \new ChordNames {
956 \myChords 900 \myChords
957 } 901 }
958 902
959 \new FretBoards { 903 \new FretBoards {
960 \set stringTunings = #ukulele-tuning 904 \set stringTunings = #ukulele-tuning
961 \myChords 905 \myChords
962 } 906 }
963 @end lilypond 907 @end lilypond
964 908
965 Chord pitches can be entered 909 Chord pitches can be entered
966 either as simultaneous music or using chord mode (see 910 either as simultaneous music or using chord mode (see
967 @ref{Chord mode overview}). 911 @ref{Chord mode overview}).
968 912
969 @lilypond[verbatim, ragged-right,quote] 913 @lilypond[verbatim, ragged-right,quote]
970 \include "predefined-guitar-fretboards.ly" 914 \include "predefined-guitar-fretboards.ly"
971 \context FretBoards { 915 \context FretBoards {
972 \chordmode {c1} 916 \chordmode { c1 }
973 <c' e' g'>1 917 <c' e' g'>1
974 } 918 }
975 @end lilypond 919 @end lilypond
976 920
977 @cindex chord names with fret diagrams 921 @cindex chord names with fret diagrams
978 @cindex fret diagrams with chord names 922 @cindex fret diagrams with chord names
979 923
980 @funindex ChordNames 924 @funindex ChordNames
981 @funindex chordmode 925 @funindex chordmode
982 @funindex \chordmode 926 @funindex \chordmode
983 927
984 It is common that both chord names and fret diagrams are displayed together. 928 It is common that both chord names and fret diagrams are displayed together.
985 This is achieved by putting a @code{ChordNames} context in parallel with 929 This is achieved by putting a @code{ChordNames} context in parallel with
986 a @code{FretBoards} context and giving both contexts the same music. 930 a @code{FretBoards} context and giving both contexts the same music.
987 931
988 @lilypond[verbatim, ragged-right, quote] 932 @lilypond[verbatim, ragged-right, quote]
989 \include "predefined-guitar-fretboards.ly" 933 \include "predefined-guitar-fretboards.ly"
990 mychords = \chordmode{ 934 mychords = \chordmode { c1 | f1 | g1 | }
991 c1 f g
992 }
993 935
994 << 936 <<
995 \context ChordNames { 937 \context ChordNames { \mychords }
996 \mychords 938 \context FretBoards { \mychords }
997 }
998 \context FretBoards {
999 \mychords
1000 }
1001 >> 939 >>
1002 @end lilypond 940 @end lilypond
1003 941
1004 @cindex transposing fret diagrams 942 @cindex transposing fret diagrams
1005 @cindex fret diagrams, transposing 943 @cindex fret diagrams, transposing
1006 @cindex diagrams, fret, transposing 944 @cindex diagrams, fret, transposing
1007 945
1008 Predefined fret diagrams are transposable, as long as a diagram for the 946 Predefined fret diagrams are transposable, as long as a diagram for the
1009 transposed chord is stored in the fret diagram table. 947 transposed chord is stored in the fret diagram table.
1010 948
1011 @lilypond[verbatim, ragged-right, quote] 949 @lilypond[verbatim, ragged-right, quote]
1012 \include "predefined-guitar-fretboards.ly" 950 \include "predefined-guitar-fretboards.ly"
1013 mychords = \chordmode{ 951 mychords = \chordmode { c1 | f1 | g1 | }
1014 c1 f g
1015 }
1016 952
1017 mychordlist = { 953 mychordlist = {
1018 \mychords 954 \mychords
1019 \transpose c e { \mychords} 955 \transpose c e { \mychords }
1020 } 956 }
1021 << 957 <<
1022 \context ChordNames { 958 \context ChordNames { \mychordlist }
1023 \mychordlist 959 \context FretBoards { \mychordlist }
1024 }
1025 \context FretBoards {
1026 \mychordlist
1027 }
1028 >> 960 >>
1029 @end lilypond 961 @end lilypond
1030 962
1031 963
1032 The predefined fret diagram table for guitar contains eight chords (major, minor , 964 The predefined fret diagram table for guitar contains eight chords (major, minor ,
1033 augmented, diminished, dominant seventh, major seventh, minor seventh, dominant ninth) 965 augmented, diminished, dominant seventh, major seventh, minor seventh, dominant ninth)
1034 for each of 17 keys. 966 for each of 17 keys.
1035 The predefined fret diagram table for ukulele contains these chords 967 The predefined fret diagram table for ukulele contains these chords
1036 plus an additional three chords (major sixth, suspended second, and 968 plus an additional three chords (major sixth, suspended second, and
1037 suspended fourth). 969 suspended fourth).
1038 A complete list of the predefined fret diagrams is 970 A complete list of the predefined fret diagrams is
1039 shown in @ref{Predefined fretboard diagrams}. If there is no entry in 971 shown in @ref{Predefined fretboard diagrams}. If there is no entry in
1040 the table for a chord, the FretBoards engraver will calculate a 972 the table for a chord, the FretBoards engraver will calculate a
1041 fret-diagram using the automatic fret diagram functionality described in 973 fret-diagram using the automatic fret diagram functionality described in
1042 @ref{Automatic fret diagrams}. 974 @ref{Automatic fret diagrams}.
1043 975
1044 @lilypond[verbatim, ragged-right, quote] 976 @lilypond[verbatim, ragged-right, quote]
1045 \include "predefined-guitar-fretboards.ly" 977 \include "predefined-guitar-fretboards.ly"
1046 mychords = \chordmode{ 978 mychords = \chordmode { c1 | c1:maj9 | }
1047 c1 c:maj9
1048 }
1049 979
1050 << 980 <<
1051 \context ChordNames { 981 \context ChordNames { \mychords }
1052 \mychords 982 \context FretBoards { \mychords }
1053 }
1054 \context FretBoards {
1055 \mychords
1056 }
1057 >> 983 >>
1058 @end lilypond 984 @end lilypond
1059 985
1060 @cindex fret diagrams, adding custom 986 @cindex fret diagrams, adding custom
1061 @cindex custom fret diagrams, adding 987 @cindex custom fret diagrams, adding
1062 @cindex adding custom fret diagrams 988 @cindex adding custom fret diagrams
1063 989
1064 Fret diagrams can be added to the fret diagram table. To add a diagram, 990 Fret diagrams can be added to the fret diagram table. To add a diagram,
1065 you must specify the chord for the diagram, the tuning to be used, and 991 you must specify the chord for the diagram, the tuning to be used, and
1066 a definition for the diagram. The diagram definition can be either a 992 a definition for the diagram. The diagram definition can be either a
1067 fret-diagram-terse definition string or a fret-diagram-verbose 993 fret-diagram-terse definition string or a fret-diagram-verbose
1068 marking list. 994 marking list.
1069 995
1070 @lilypond[verbatim, ragged-right, quote] 996 @lilypond[verbatim, ragged-right, quote]
1071 \include "predefined-guitar-fretboards.ly" 997 \include "predefined-guitar-fretboards.ly"
1072 998
1073 \storePredefinedDiagram \chordmode {c:maj9} 999 \storePredefinedDiagram \chordmode { c:maj9 }
1074 #guitar-tuning 1000 #guitar-tuning
1075 #"x;3-2;o;o;o;o;" 1001 #"x;3-2;o;o;o;o;"
1076 1002
1077 mychords = \chordmode{ 1003 mychords = \chordmode { c1 | c:maj9 | }
1078 c1 c:maj9
1079 }
1080 1004
1081 << 1005 <<
1082 \context ChordNames { 1006 \context ChordNames { \mychords }
1083 \mychords 1007 \context FretBoards { \mychords }
1084 }
1085 \context FretBoards {
1086 \mychords
1087 }
1088 >> 1008 >>
1089 @end lilypond 1009 @end lilypond
1090 1010
1091 Different fret diagrams for the same chord name can be stored using different 1011 Different fret diagrams for the same chord name can be stored using different
1092 octaves of pitches. The different octave should be at least two octaves 1012 octaves of pitches. The different octave should be at least two octaves
1093 above or below the default octave, because the octaves above and below the 1013 above or below the default octave, because the octaves above and below the
1094 default octave are used for transposing fretboards. 1014 default octave are used for transposing fretboards.
1095 1015
1096 @lilypond[verbatim, ragged-right, quote] 1016 @lilypond[verbatim, ragged-right, quote]
1097 \include "predefined-guitar-fretboards.ly" 1017 \include "predefined-guitar-fretboards.ly"
1098 1018
1099 \storePredefinedDiagram \chordmode {c''} 1019 \storePredefinedDiagram \chordmode { c'' }
1100 #guitar-tuning 1020 #guitar-tuning
1101 #(offset-fret 2 (chord-shape 'bes guitar-tuning)) 1021 #(offset-fret 2 (chord-shape 'bes guitar-tuning))
1102 1022
1103 mychords = \chordmode{ 1023 mychords = \chordmode { c1 | c''1 | }
1104 c1 c''
1105 }
1106 1024
1107 << 1025 <<
1108 \context ChordNames { 1026 \context ChordNames { \mychords }
1109 \mychords 1027 \context FretBoards { \mychords }
1110 }
1111 \context FretBoards {
1112 \mychords
1113 }
1114 >> 1028 >>
1115 @end lilypond 1029 @end lilypond
1116 1030
1117 @cindex fretted instruments, chord shapes 1031 @cindex fretted instruments, chord shapes
1118 @cindex chord shapes for fretted instruments 1032 @cindex chord shapes for fretted instruments
1119 1033
1120 @funindex \addChordShape 1034 @funindex \addChordShape
1121 @funindex add ChordShape 1035 @funindex add ChordShape
1122 @funindex storePredefinedDiagram 1036 @funindex storePredefinedDiagram
1123 @funindex \storePredefinedDiagram 1037 @funindex \storePredefinedDiagram
1124 1038
1125 In addition to fret diagrams, LilyPond stores an internal list of chord 1039 In addition to fret diagrams, LilyPond stores an internal list of chord
1126 shapes. The chord shapes are fret diagrams that can be shifted along 1040 shapes. The chord shapes are fret diagrams that can be shifted along
1127 the neck to different posistions to provide different chords. Chord 1041 the neck to different posistions to provide different chords. Chord
1128 shapes can be added to the internal list and then used to define 1042 shapes can be added to the internal list and then used to define
1129 predefined fret diagrams. Because they can be moved to various 1043 predefined fret diagrams. Because they can be moved to various
1130 positions on the neck, chord shapes will normally not contain 1044 positions on the neck, chord shapes will normally not contain
1131 any open strings. Like fret diagrams, chord shapes can be 1045 any open strings. Like fret diagrams, chord shapes can be
1132 entered as either fret-diagram-terse strings or fret-diagram-verbose 1046 entered as either fret-diagram-terse strings or fret-diagram-verbose
1133 marking lists. 1047 marking lists.
1134 1048
1135 @lilypond[verbatim, ragged-right, quote] 1049 @lilypond[verbatim, ragged-right, quote]
1136 \include "predefined-guitar-fretboards.ly" 1050 \include "predefined-guitar-fretboards.ly"
1137 1051
1138 % add a new chord shape 1052 % add a new chord shape
1139
1140 \addChordShape #'powerf #guitar-tuning #"1-1;3-3;3-4;x;x;x;" 1053 \addChordShape #'powerf #guitar-tuning #"1-1;3-3;3-4;x;x;x;"
1141 1054
1142 % add some new chords based on the power chord shape 1055 % add some new chords based on the power chord shape
1143 1056 \storePredefinedDiagram \chordmode { f'' }
1144 \storePredefinedDiagram \chordmode {f''}
1145 #guitar-tuning 1057 #guitar-tuning
1146 #(chord-shape 'powerf guitar-tuning) 1058 #(chord-shape 'powerf guitar-tuning)
1147 \storePredefinedDiagram \chordmode {g''} 1059 \storePredefinedDiagram \chordmode { g'' }
1148 #guitar-tuning 1060 #guitar-tuning
1149 #(offset-fret 2 (chord-shape 'powerf guitar-tuning)) 1061 #(offset-fret 2 (chord-shape 'powerf guitar-tuning))
1150 1062
1151 mychords = \chordmode{ 1063 mychords = \chordmode { f1 | f''1 | g1 | g''1 | }
1152 f1 f'' g g''
1153 }
1154 1064
1155 << 1065 <<
1156 \context ChordNames { 1066 \context ChordNames { \mychords }
1157 \mychords 1067 \context FretBoards { \mychords }
1158 }
1159 \context FretBoards {
1160 \mychords
1161 }
1162 >> 1068 >>
1163 @end lilypond 1069 @end lilypond
1164 1070
1165 The graphical layout of a fret diagram can be customized according to 1071 The graphical layout of a fret diagram can be customized according to
1166 user preference through the properties of the @code{fret-diagram-interface}. 1072 user preference through the properties of the @code{fret-diagram-interface}.
1167 Details are found at @rinternals{fret-diagram-interface}. For a 1073 Details are found at @rinternals{fret-diagram-interface}. For a
1168 predefined fret diagram, the interface properties belong to 1074 predefined fret diagram, the interface properties belong to
1169 @code{FretBoards.FretBoard}. 1075 @code{FretBoards.FretBoard}.
1170 1076
1171 @snippets 1077 @snippets
(...skipping 35 matching lines...) Expand 10 before | Expand all | Expand 10 after
1207 @cindex automatic chord diagrams 1113 @cindex automatic chord diagrams
1208 1114
1209 Fret diagrams can be automatically created from entered notes using the 1115 Fret diagrams can be automatically created from entered notes using the
1210 @code{FretBoards} context. If no predefined diagram is available for 1116 @code{FretBoards} context. If no predefined diagram is available for
1211 the entered notes in the active @code{stringTunings}, this context 1117 the entered notes in the active @code{stringTunings}, this context
1212 calculates strings and frets that can be used to play the notes. 1118 calculates strings and frets that can be used to play the notes.
1213 1119
1214 @lilypond[quote,ragged-right,verbatim] 1120 @lilypond[quote,ragged-right,verbatim]
1215 << 1121 <<
1216 \context ChordNames { 1122 \context ChordNames {
1217 \chordmode { 1123 \chordmode { f1 | g | }
1218 f1 g
1219 }
1220 } 1124 }
1221 \context FretBoards { 1125 \context FretBoards {
1222 < f, c f a c' f'>1 1126 <f, c f a c' f'>1 |
1223 < g,\6 b, d g b g'> 1127 <g, b, d g b g'>1 |
1224 } 1128 }
1225 \context Staff { 1129 \context Staff {
1226 \clef "treble_8" 1130 \clef "treble_8"
1227 < f, c f a c' f'>1 1131 <f, c f a c' f'>1 |
1228 < g, b, d g b' g'> 1132 <g, b, d g b g'>1 |
1229 } 1133 }
1230 >> 1134 >>
1231 @end lilypond 1135 @end lilypond
1232 1136
1233 @funindex predefinedFretboardsOff 1137 @funindex predefinedFretboardsOff
1234 @funindex \predefinedFretboardsOff 1138 @funindex \predefinedFretboardsOff
1235 @funindex predefinedFretboardsOn 1139 @funindex predefinedFretboardsOn
1236 @funindex \predefinedFretboardsOn 1140 @funindex \predefinedFretboardsOn
1237 1141
1238 As no predefined diagrams are loaded by default, automatic calculation 1142 As no predefined diagrams are loaded by default, automatic calculation
1239 of fret diagrams is the default behavior. Once default diagrams are 1143 of fret diagrams is the default behavior. Once default diagrams are
1240 loaded, automatic calculation can be enabled and disabled with predefined 1144 loaded, automatic calculation can be enabled and disabled with predefined
1241 commands: 1145 commands:
1242 1146
1243 @lilypond[quote,ragged-right,verbatim] 1147 @lilypond[quote,ragged-right,verbatim]
1244 1148
1245 \storePredefinedDiagram <c e g c' e'> 1149 \storePredefinedDiagram <c e g c' e'>
1246 #guitar-tuning 1150 #guitar-tuning
1247 #"x;3-1-(;5-2;5-3;5-4;3-1-1);" 1151 #"x;3-1-(;5-2;5-3;5-4;3-1-1);"
1248 << 1152 <<
1249 \context ChordNames { 1153 \context ChordNames {
1250 \chordmode { 1154 \chordmode { c1 | c1 | c1 | }
1251 c1 c c
1252 }
1253 } 1155 }
1254 \context FretBoards { 1156 \context FretBoards {
1255 <c e g c' e'>1 1157 <c e g c' e'>1 |
1256 \predefinedFretboardsOff 1158 \predefinedFretboardsOff
1257 <c e g c' e'> 1159 <c e g c' e'>1 |
1258 \predefinedFretboardsOn 1160 \predefinedFretboardsOn
1259 <c e g c' e'> 1161 <c e g c' e'>1 |
1260 } 1162 }
1261 \context Staff { 1163 \context Staff {
1262 \clef "treble_8" 1164 \clef "treble_8"
1263 <c e g c' e'>1 1165 <c e g c' e'>1 |
1264 <c e g c' e'> 1166 <c e g c' e'>1 |
1265 <c e g c' e'> 1167 <c e g c' e'>1 |
1266 } 1168 }
1267 >> 1169 >>
1268 @end lilypond 1170 @end lilypond
1269 1171
1270 1172
1271 1173
1272 Sometimes the fretboard calculator will be unable to find 1174 Sometimes the fretboard calculator will be unable to find
1273 an acceptable diagram. This can often be remedied by 1175 an acceptable diagram. This can often be remedied by
1274 manually assigning a note to a string. In many cases, only one 1176 manually assigning a note to a string. In many cases, only one
1275 note need be manually placed on a string; the rest of 1177 note need be manually placed on a string; the rest of
1276 the notes will then be placed appropriately by the @code{FretBoards} 1178 the notes will then be placed appropriately by the @code{FretBoards}
1277 context. 1179 context.
1278 1180
1279 @cindex fret diagrams, adding fingerings 1181 @cindex fret diagrams, adding fingerings
1280 @cindex fingerings, adding to fret diagrams 1182 @cindex fingerings, adding to fret diagrams
1281 1183
1282 Fingerings can be added to FretBoard fret diagrams. 1184 Fingerings can be added to FretBoard fret diagrams.
1283 1185
1284 @lilypond[quote, verbatim] 1186 @lilypond[quote, verbatim]
1285 << 1187 <<
1286 \context ChordNames { 1188 \context ChordNames {
1287 \chordmode { 1189 \chordmode { c1 | d1:m | }
1288 c1 d:m
1289 }
1290 } 1190 }
1291 \context FretBoards { 1191 \context FretBoards {
1292 < c-3 e-2 g c'-1 e' > 1 1192 <c-3 e-2 g c'-1 e'>1 |
1293 < d a-2 d'-3 f'-1> 1193 <d a-2 d'-3 f'-1>1 |
1294 } 1194 }
1295 \context Staff { 1195 \context Staff {
1296 \clef "treble_8" 1196 \clef "treble_8"
1297 < c e g c' e' > 1 1197 <c e g c' e'>1 |
1298 < d a d' f'> 1198 <d a d' f'>1 |
1299 } 1199 }
1300 >> 1200 >>
1301 @end lilypond 1201 @end lilypond
1302 1202
1303 The minimum fret to be used in calculating strings and frets for 1203 The minimum fret to be used in calculating strings and frets for
1304 the FretBoard context can be set with the @code{minimumFret} 1204 the FretBoard context can be set with the @code{minimumFret}
1305 property. 1205 property.
1306 1206
1307 @lilypond[quote, verbatim] 1207 @lilypond[quote, verbatim]
1308 << 1208 <<
1309 \context ChordNames { 1209 \context ChordNames {
1310 \chordmode { 1210 \chordmode { d1:m | d1:m | }
1311 d1:m d:m
1312 }
1313 } 1211 }
1314 \context FretBoards { 1212 \context FretBoards {
1315 < d a d' f'> 1213 <d a d' f'>1 |
1316 \set FretBoards.minimumFret = #5 1214 \set FretBoards.minimumFret = #5
1317 < d a d' f'> 1215 <d a d' f'>1 |
1318 } 1216 }
1319 \context Staff { 1217 \context Staff {
1320 \clef "treble_8" 1218 \clef "treble_8"
1321 < d a d' f'> 1219 <d a d' f'>1 |
1322 < d a d' f'> 1220 <d a d' f'>1 |
1323 } 1221 }
1324 >> 1222 >>
1325 @end lilypond 1223 @end lilypond
1326 1224
1327 The strings and frets for the @code{FretBoards} context depend 1225 The strings and frets for the @code{FretBoards} context depend
1328 on the @code{stringTunings} property, which has the same meaning 1226 on the @code{stringTunings} property, which has the same meaning
1329 as in the TabStaff context. See @ref{Custom tablatures} for 1227 as in the TabStaff context. See @ref{Custom tablatures} for
1330 information on the @code{stringTunings} property. 1228 information on the @code{stringTunings} property.
1331 1229
1332 The graphical layout of a fret diagram can be customized according to 1230 The graphical layout of a fret diagram can be customized according to
(...skipping 37 matching lines...) Expand 10 before | Expand all | Expand 10 after
1370 Right-hand fingerings @var{p-i-m-a} must be entered within a 1268 Right-hand fingerings @var{p-i-m-a} must be entered within a
1371 chord construct @code{<>} for them to be printed in the score, 1269 chord construct @code{<>} for them to be printed in the score,
1372 even when applied to a single note. 1270 even when applied to a single note.
1373 1271
1374 @warning{There @strong{must} be a hyphen before 1272 @warning{There @strong{must} be a hyphen before
1375 @code{@bs{}rightHandFinger} and a space before the closing @code{>}.} 1273 @code{@bs{}rightHandFinger} and a space before the closing @code{>}.}
1376 1274
1377 @lilypond[quote,verbatim,relative=0] 1275 @lilypond[quote,verbatim,relative=0]
1378 \clef "treble_8" 1276 \clef "treble_8"
1379 <c-\rightHandFinger #1 >4 1277 <c-\rightHandFinger #1 >4
1380 <e-\rightHandFinger #2 > 1278 <e-\rightHandFinger #2 >4
1381 <g-\rightHandFinger #3 > 1279 <g-\rightHandFinger #3 >4
1382 <c-\rightHandFinger #4 > 1280 <c-\rightHandFinger #4 >4 |
1383 <c,-\rightHandFinger #1 e-\rightHandFinger #2 1281 <c,-\rightHandFinger #1 e-\rightHandFinger #2
1384 g-\rightHandFinger #3 c-\rightHandFinger #4 >1 1282 g-\rightHandFinger #3 c-\rightHandFinger #4 >1 |
1385 @end lilypond 1283 @end lilypond
1386 1284
1387 For convenience, you can abbreviate @code{\rightHandFinger} to something 1285 For convenience, you can abbreviate @code{\rightHandFinger} to something
1388 short, for example @code{RH}, 1286 short, for example @code{RH},
1389 1287
1390 @example 1288 @example
1391 #(define RH rightHandFinger) 1289 #(define RH rightHandFinger)
1392 @end example 1290 @end example
1393 1291
1394 1292
(...skipping 35 matching lines...) Expand 10 before | Expand all | Expand 10 after
1430 @unnumberedsubsubsec Indicating position and barring 1328 @unnumberedsubsubsec Indicating position and barring
1431 1329
1432 @cindex indicating position and barring for fretted instruments 1330 @cindex indicating position and barring for fretted instruments
1433 @cindex fretted instruments, indicating position and barring 1331 @cindex fretted instruments, indicating position and barring
1434 1332
1435 This example demonstrates how to include guitar position and 1333 This example demonstrates how to include guitar position and
1436 barring indications. 1334 barring indications.
1437 1335
1438 @lilypond[quote,ragged-right,fragment,verbatim,relative=0] 1336 @lilypond[quote,ragged-right,fragment,verbatim,relative=0]
1439 \clef "treble_8" 1337 \clef "treble_8"
1440 b16 d g b e 1338 b16 d g b
1339 e16
1441 \textSpannerDown 1340 \textSpannerDown
1442 \override TextSpanner #'(bound-details left text) = #"XII " 1341 \override TextSpanner #'(bound-details left text) = #"XII "
1443 g16\startTextSpan 1342 g16\startTextSpan b e
1444 b16 e g e b g\stopTextSpan 1343 g16 e b g\stopTextSpan
1445 e16 b g d 1344 e16 b g d
1446 @end lilypond 1345 @end lilypond
1447 1346
1448 1347
1449 @seealso 1348 @seealso
1450 Notation Reference: 1349 Notation Reference:
1451 @ref{Text spanners}. 1350 @ref{Text spanners}.
1452 1351
1453 Snippets: 1352 Snippets:
1454 @rlsr{Fretted strings}, 1353 @rlsr{Fretted strings},
1455 @rlsr{Expressive marks}. 1354 @rlsr{Expressive marks}.
1456 1355
1457 1356
1458 @node Indicating harmonics and dampened notes 1357 @node Indicating harmonics and dampened notes
1459 @unnumberedsubsubsec Indicating harmonics and dampened notes 1358 @unnumberedsubsubsec Indicating harmonics and dampened notes
1460 1359
1461 @cindex fretted instruments, dampened notes 1360 @cindex fretted instruments, dampened notes
1462 @cindex fretted instruments, harmonics 1361 @cindex fretted instruments, harmonics
1463 @cindex dampened notes on fretted instruments 1362 @cindex dampened notes on fretted instruments
1464 @cindex harmonics on fretted instruments 1363 @cindex harmonics on fretted instruments
1465 1364
1466 Special note heads can be used to indicate dampened notes or 1365 Special note heads can be used to indicate dampened notes or
1467 harmonics. Harmonics are normally further explained with a 1366 harmonics. Harmonics are normally further explained with a
1468 text markup. 1367 text markup.
1469 1368
1470 @lilypond[quote,ragged-right,verbatim] 1369 @lilypond[quote,ragged-right,verbatim]
1471 \relative c' { 1370 \relative c' {
1472 \clef "treble_8" 1371 \clef "treble_8"
1473 \override Staff.NoteHead #'style = #'harmonic-mixed 1372 \override Staff.NoteHead #'style = #'harmonic-mixed
1474 d^\markup { \italic { \fontsize #-2 { "harm. 12" }}} <g b>1 1373 d4^\markup { \italic { \fontsize #-2 { "harm. 12" } } } <g b>2.
1475 } 1374 }
1476 @end lilypond 1375 @end lilypond
1477 1376
1478 Dampened notes (also called @notation{dead notes}) are supported 1377 Dampened notes (also called @notation{dead notes}) are supported
1479 within normal and tablature staves: 1378 within normal and tablature staves:
1480 1379
1481 @lilypond[quote,ragged-right,verbatim] 1380 @lilypond[quote,ragged-right,verbatim]
1482 music = \relative c' { 1381 music = \relative c' {
1483 < a\3 \deadNote c\2 a'\1 >4 1382 <a\3 \deadNote c\2 a'\1>4
1484 < b\3 \deadNote d\2 b'\1 > 1383 <b\3 \deadNote d\2 b'\1>4
1485 < c\3 \deadNote e\2 c'\1 > 1384 <c\3 \deadNote e\2 c'\1>4
1486 \deadNotesOn 1385 \deadNotesOn
1487 \times 2/3 { g8 b e } 1386 \times 2/3 { g8 b e } |
1488 \deadNotesOff 1387 \deadNotesOff
1489 < a,\3 c\2 e\1 >1 1388 <a,\3 c\2 e\1>1 |
1490 } 1389 }
1491 \new StaffGroup << 1390 \new StaffGroup <<
1492 \new Staff { 1391 \new Staff {
1493 \clef "treble_8" 1392 \clef "treble_8"
1494 \music 1393 \music
1495 } 1394 }
1496 \new TabStaff { 1395 \new TabStaff {
1497 \music 1396 \music
1498 } 1397 }
1499 >> 1398 >>
1500 @end lilypond 1399 @end lilypond
1501 1400
1502 Another playing technique (especially used on electic guitars) is 1401 Another playing technique (especially used on electic guitars) is
1503 called @notation{palm mute}. The string is hereby partly muted by the 1402 called @notation{palm mute}. The string is hereby partly muted by the
1504 palm of the striking hand (hence the name). Lilypond supports 1403 palm of the striking hand (hence the name). Lilypond supports
1505 the notation of palm mute-style notes by changing the note head to a 1404 the notation of palm mute-style notes by changing the note head to a
1506 triangle shape. 1405 triangle shape.
1507 1406
1508 @lilypond[quote,ragged-right,verbatim] 1407 @lilypond[quote,ragged-right,verbatim]
1509 \new Voice { % Warning: explicit Voice instantiation is 1408 \new Voice { % Warning: explicit Voice instantiation is required
1510 % required to have palmMuteOff work properly 1409 % for palmMuteOff to work properly when the
1511 % when palmMuteOn comes at the beginning of 1410 % first note of a score uses palmMuteOn.
1512 % the piece.
1513 \relative c, { 1411 \relative c, {
1514 \clef "G_8" 1412 \clef "G_8"
1515 \palmMuteOn 1413 \palmMuteOn
1516 e8^\markup { \musicglyph #"noteheads.u2do" = palm mute } 1414 e8^\markup { \musicglyph #"noteheads.u2do" = palm mute }
1517 < e b' e > e 1415 <e b' e>8 e \palmMuteOff e
1518 \palmMuteOff 1416 e8 \palmMute e e e |
1519 e e \palmMute e e e | 1417 e8 \palmMute { e8 e e } e8 e e e |
1520 e8 \palmMute { e e e } e e e e | 1418 <\palmMute e b' e>8 \palmMute { e8 e e } <\palmMute e b' e>2 |
1521 < \palmMute e b' e >8 \palmMute { e e e } < \palmMute e b' e >2
1522 } 1419 }
1523 } 1420 }
1524 @end lilypond 1421 @end lilypond
1525 1422
1526 @seealso 1423 @seealso
1527 Snippets: 1424 Snippets:
1528 @rlsr{Fretted strings}. 1425 @rlsr{Fretted strings}.
1529 1426
1530 Notation Reference: 1427 Notation Reference:
1531 @ref{Special note heads}, 1428 @ref{Special note heads},
(...skipping 53 matching lines...) Expand 10 before | Expand all | Expand 10 after
1585 \set TabStaff.stringTunings = #(four-string-banjo banjo-c-tuning) 1482 \set TabStaff.stringTunings = #(four-string-banjo banjo-c-tuning)
1586 @end example 1483 @end example
1587 1484
1588 1485
1589 @seealso 1486 @seealso
1590 Snippets: 1487 Snippets:
1591 @rlsr{Fretted strings}. 1488 @rlsr{Fretted strings}.
1592 1489
1593 Installed Files: 1490 Installed Files:
1594 @file{scm/@/output@/-lib@/.scm} contains predefined banjo tunings. 1491 @file{scm/@/output@/-lib@/.scm} contains predefined banjo tunings.
OLDNEW

Powered by Google App Engine
RSS Feeds Recent Issues | This issue
This is Rietveld f62528b