Documentation/user/fretted-strings.itely

   1 @c -*- coding: utf-8; mode: texinfo; -*-
   2 @ignore
   3     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
   4
   5     When revising a translation, copy the HEAD committish of the
   6     version that you are working on.  See TRANSLATION for details.
   7 @end ignore
   8
   9 @c \version "2.11.53"
  10
  11 @node Fretted string instruments
  12 @section Fretted string instruments
  13
  14 @lilypondfile[quote]{fretted-headword.ly}
  15
  16 This section discusses several aspects of music notation that are unique
  17 to fretted string instruments.
  18
  19 @cindex tablature
  20 @cindex guitar tablature
  21
  22 @menu
  23 * Common notation for fretted strings::
  24 * Guitar::
  25 * Banjo::
  26 @end menu
  27
  28 @node Common notation for fretted strings
  29 @subsection Common notation for fretted strings
  30
  31 This section discusses common notation that is unique
  32 to fretted string instruments.
  33
  34 @menu
  35 * References for fretted strings::
  36 * String number indications::
  37 * Default tablatures::
  38 * Custom tablatures::
  39 * Automatic fret diagrams::
  40 * Fret diagram markups::
  41 * Right-hand fingerings::
  42 @end menu
  43
  44 @node References for fretted strings
  45 @subsubsection References for fretted strings
  46
  47 Music for fretted string instruments is normally notated on
  48 a single staff, either in traditional music notation or in
  49 tablature.  Sometimes the two types are combined, and it is
  50 especially common in popular music to use chord diagrams above
  51 a staff of traditional notation.  The guitar and the banjo are
  52 transposing instruments, sounding an octave lower than written.
  53 Scores for these instruments should use the @code{"treble_8"} clef.
  54 Some other elements pertinent to fretted string instruments
  55 are covered elsewhere:
  56
  57 @itemize
  58 @item Fingerings are indicated with @ref{Fingering instructions}.
  59
  60 @item Instructions for @notation{Laissez vibrer} ties
  61 as well as ties on arpeggios and tremolos is described in
  62 @ref{Ties}.
  63
  64 @item Instructions on handling multiple voices is described
  65 in @ref{Collision resolution}.
  66
  67 @end itemize
  68
  69 @seealso
  70
  71 Notation Reference:
  72 @ref{Instrument names},
  73 @ref{Writing music in parallel},
  74 @ref{Fingering instructions},
  75 @ref{Ties},
  76 @ref{Arpeggio},
  77 @ref{List of articulations},
  78 @ref{Clef}.
  79
  80 @node String number indications
  81 @subsubsection String number indications
  82
  83 @cindex String numbers
  84
  85 The string on which a note should be played may be indicated by
  86 appending @code{\@var{number}} to a note inside a chord construct
  87 @code{<>}.
  88
  89 @warning{String numbers @strong{must} be defined inside a chord
  90 construct even if there is only a single note.}
  91
  92 @lilypond[verbatim,quote,relative=0]
  93 \clef "treble_8"
  94 <c\5>4 <e\4> <g\3>2
  95 <c,\5 e\4 g\3>1
  96 @end lilypond
  97
  98 When fingerings and string indications are used together, their
  99 placement is controlled by the order in which the two items appear
 100 in the code:
 101
 102 @lilypond[verbatim,quote,relative=1]
 103 \clef "treble_8"
 104 <g\3-0>2
 105 <g-0\3>
 106 @end lilypond
 107
 108 @snippets
 109
 110 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 111 {controlling-the-placement-of-chord-fingerings.ly}
 112
 113 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 114 {allowing-fingerings-to-be-printed-inside-the-staff.ly}
 115
 116 @seealso
 117
 118 Notation Reference:
 119 @ref{Fingering instructions}.
 120
 121 Snippets:
 122 @rlsr{Fretted strings}.
 123
 124 Internals Reference:
 125 @rinternals{StringNumber},
 126 @rinternals{Fingering}.
 127
 128
 129 @node Default tablatures
 130 @subsubsection Default tablatures
 131 @cindex Tablatures, basic
 132 @cindex Tablatures, default
 133
 134 Tablature notation is used for notating music for plucked string
 135 instruments.  Pitches are not denoted with note heads, but by
 136 numbers indicating on which string and fret a note must be played.
 137 LilyPond offers limited support for tablature.
 138
 139 The string number associated with a note is given as a backslash
 140 followed by a number.  By default, string 1 is the highest,
 141 and the tuning defaults to the standard guitar tuning (with 6 strings).
 142 The notes are printed as tablature, by using @code{TabStaff} and
 143 @code{TabVoice} contexts
 144
 145 @lilypond[quote,ragged-right,fragment,verbatim]
 146 \new TabStaff {
 147   a,4\5 c'\2 a\3 e'\1
 148   e\4 c'\2 a\3 e'\1
 149 }
 150 @end lilypond
 151
 152 @funindex minimumFret
 153 @cindex fret
 154
 155
 156 When no string is specified for a note, the note is assigned to
 157 the lowest string that can generate the note with a fret number
 158 greater than or equal to @code{minimumFret} is selected.  The
 159 default value for @code{minimumFret} is 0.
 160
 161
 162 @lilypond[quote,ragged-right,verbatim]
 163 \new StaffGroup <<
 164    \new Staff \relative c {
 165      \clef "treble_8"
 166      c16 d e f g4
 167      c,16 d e f g4
 168    }
 169    \new TabStaff \relative c {
 170      c16 d e f g4
 171      \set TabStaff.minimumFret = #5
 172      c,16 d e f g4
 173    }
 174 >>
 175 @end lilypond
 176
 177 @snippets
 178
 179 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 180 {stem-and-beam-behavior-in-tablature.ly}
 181
 182 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 183 {polyphony-in-tablature.ly}
 184
 185 @seealso
 186
 187 Notation Reference:
 188 @ref{Stems}.
 189
 190 Snippets:
 191 @rlsr{Fretted strings}.
 192
 193 Internals Reference:
 194 @rinternals{TabNoteHead},
 195 @rinternals{TabStaff},
 196 @rinternals{TabVoice},
 197 @rinternals{Beam}.
 198
 199 @knownissues
 200
 201 Chords are not handled in a special way, and hence the automatic
 202 string selector may easily select the same string for two notes in
 203 a chord.
 204
 205 In order to handle @code{\partcombine}, a @code{TabStaff} must use
 206 specially-created voices:
 207
 208 @lilypond[quote,ragged-right,verbatim]
 209 melodia = \partcombine { e4 g g g }{ e4 e e e }
 210 <<
 211   \new TabStaff <<
 212     \new TabVoice = "one" s1
 213     \new TabVoice = "two" s1
 214     \new TabVoice = "shared" s1
 215     \new TabVoice = "solo" s1
 216     { \melodia }
 217   >>
 218 >>
 219 @end lilypond
 220
 221
 222 @node Custom tablatures
 223 @subsubsection Custom tablatures
 224 @cindex Tablatures, custom
 225
 226 You can change the tuning of the strings.  A string tuning is
 227 given as a Scheme list with one integer number for each string,
 228 the number being the pitch (measured in semitones relative to
 229 middle C) of an open string.  The numbers specified for
 230 @code{stringTunings} are the numbers of semitones to subtract or
 231 add, starting the specified pitch by default middle C, in string
 232 order.  LilyPond automatically calculates the number of strings by
 233 looking at @code{stringTunings}.
 234
 235 In the next example, @code{stringTunings} is set for the pitches
 236 e, a, d, and g.
 237
 238 @lilypond[quote,ragged-right,fragment,verbatim]
 239 \new TabStaff <<
 240   \set TabStaff.stringTunings = #'(-5 -10 -15 -20)
 241   {
 242     a,4 c' a e' e c' a e'
 243   }
 244 >>
 245 @end lilypond
 246
 247 LilyPond comes with predefined string tunings for banjo, mandolin,
 248 guitar and bass guitar.  Lilypond automatically sets the correct
 249 transposition for predefined tunings.  The following example is
 250 for bass guitar, which sounds an octave lower than written.
 251
 252 @lilypond[quote,ragged-right,verbatim]
 253 <<
 254   \new Staff <<
 255     \clef "bass_8"
 256     \relative c, {
 257     c4 d e f
 258     }
 259   >>
 260   \new TabStaff <<
 261     \set TabStaff.stringTunings = #bass-tuning
 262     \relative c, {
 263     c4 d e f
 264     }
 265   >>
 266 >>
 267 @end lilypond
 268
 269 The default string tuning is @code{guitar-tuning} (the standard
 270 EADGBE tuning).  Some other predefined tunings are
 271 @code{guitar-open-g-tuning}, @code{mandolin-tuning} and
 272 @code{banjo-open-g-tuning}.
 273
 274 @seealso
 275
 276 Snippets:
 277 @rlsr{Fretted strings}.
 278
 279 The file @file{scm/@/output@/-lib@/.scm} contains the predefined string
 280 tunings.
 281
 282 Internals Reference:
 283 @rinternals{Tab_note_heads_engraver}.
 284
 285 @knownissues
 286
 287 No guitar special effects have been implemented.
 288
 289 @node Automatic fret diagrams
 290 @subsubsection Automatic fret diagrams
 291 @cindex fret diagrams
 292 @cindex chord diagrams
 293
 294 Fret diagrams can be automatically created from entered notes using the
 295 @code{FretBoards} context.  This context calculates strings and frets
 296 which can be used to play the notes.
 297
 298 @lilypond[quote,ragged-right,verbatim]
 299 <<
 300   \context ChordNames {
 301      \chordmode {
 302        f1 g
 303      }
 304   }
 305   \context FretBoards {
 306     < f, c f a c' f'>1
 307     < g,\6 b, d g b g'>
 308   }
 309   \context Staff {
 310     \clef "treble_8"
 311     < f, c f a c' f'>1
 312     < g, b, d g b' g'>
 313   }
 314 >>
 315 @end lilypond
 316
 317 Notes can be explicitly placed on a string.  It is often enough
 318 to place only the lowest note on an explicit string; the rest of
 319 the notes will then be placed appropriately by the @code{FretBoards}
 320 context.
 321
 322 @lilypond[quote,ragged-right,verbatim]
 323 <<
 324   \context ChordNames {
 325      \chordmode {
 326        c1 c d:m d:m
 327      }
 328   }
 329   \context FretBoards {
 330     < c e g c' e' > 1
 331     < c\5 e g c' e' > 1
 332     < d a d' f'>
 333     < d\4 a d' f'>
 334   }
 335   \context Staff {
 336     \clef "treble_8"
 337     < c e g c' e' > 1
 338     < c e g c' e' > 1
 339     < d a d' f'>
 340     < d a d' f'>
 341   }
 342 >>
 343 @end lilypond
 344
 345 Fingerings can be added to FretBoard fret diagrams.
 346
 347 @lilypond[quote, verbatim]
 348 <<
 349   \context ChordNames {
 350      \chordmode {
 351        c1 d:m
 352      }
 353   }
 354   \context FretBoards {
 355     < c\5-3 e-2 g c'-1 e' > 1
 356     < d\4 a-2 d'-3 f'-1>
 357   }
 358   \context Staff {
 359     \clef "treble_8"
 360     < c e g c' e' > 1
 361     < d a d' f'>
 362   }
 363 >>
 364 @end lilypond
 365
 366 The strings and frets for the @code{FretBoards} context depend
 367 on the @code{stringTunings} property, which has the same meaning
 368 as in the TabStaff context.  See @ref{Custom tablatures} for
 369 information on the @code{stringTunings} property.
 370
 371 The graphical layout of a fret diagram can be customized according to
 372 user preference through the properties of the @code{fret-diagram-interface}.
 373 Details are found at @rinternals{fret-diagram-interface}.  For a
 374 @code{FretBoards} fret diagram, the interface properties belong to
 375 @code{FretBoards}.
 376
 377 @snippets
 378 The minimum fret to be used in calculating strings and frets for
 379 the FretBoard context can be set with the @code{minimumFret}
 380 property.
 381
 382 @c TODO -- snippet showing minimum fret.
 383
 384 @c TODO -- snippet for using StringTunings
 385
 386 @seealso
 387
 388 Notation Reference:
 389 @ref{Custom tablatures}
 390
 391 Snippets:
 392 @rlsr{Fretted strings}.
 393
 394 Internals Reference:
 395 @rinternals {fret-diagram-interface}.
 396
 397
 398 @node Fret diagram markups
 399 @subsubsection Fret diagram markups
 400 @cindex fret diagrams
 401 @cindex chord diagrams
 402
 403 Fret diagrams can be added to music as a markup to the desired
 404 note.  The markup contains information about the desired fret
 405 diagram.  There are three different fret-diagram markup
 406 interfaces: standard, terse, and verbose.  The three interfaces
 407 produce equivalent markups, but have varying amounts of
 408 information in the markup string.  Details about the markup
 409 interfaces are found at @ref{Text markup commands}.
 410
 411 The standard fret diagram markup string indicates the string
 412 number and the fret number for each dot to be placed on the string.
 413 In addition, open and unplayed (muted) strings can be indicated.
 414
 415 @lilypond[quote, verbatim]
 416 <<
 417   \context ChordNames {
 418      \chordmode {
 419        c1 d:m
 420      }
 421   }
 422   \context Staff {
 423     \clef "treble_8"
 424     < c e g c' e' > 1 ^\markup
 425       \fret-diagram #"6-x;5-3;4-2;3-o;2-1;1-o;"
 426     < d a d' f'> ^\markup
 427       \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-1;"
 428   }
 429 >>
 430 @end lilypond
 431
 432 Barre indications can be added to the diagram from
 433 the fret-diagram markup string.
 434
 435 @lilypond[quote, verbatim]
 436 <<
 437   \context ChordNames {
 438      \chordmode {
 439        f1 g
 440      }
 441   }
 442   \context Staff {
 443     \clef "treble_8"
 444     < f, c f a c' f'>1 ^\markup
 445       \fret-diagram #"c:6-1-1;6-1;5-3;4-3;3-2;2-1;1-1;"
 446     < g, b, d g b' g'> ^\markup
 447       \fret-diagram #"c:6-1-3;6-3;5-5;4-5;3-4;2-3;1-3;"
 448   }
 449 >>
 450 @end lilypond
 451
 452 The size of the fret diagram, and the number of frets in the diagram
 453 can be changed in the fret-diagram markup string.
 454
 455 @lilypond[quote, verbatim]
 456 <<
 457   \context ChordNames {
 458      \chordmode {
 459        f1 g
 460      }
 461   }
 462   \context Staff {
 463     \clef "treble_8"
 464     < f, c f a c' f'>1 ^\markup
 465       \fret-diagram #"s:1.5;c:6-1-1;6-1;5-3;4-3;3-2;2-1;1-1;"
 466     < g, b, d g b' g'> ^\markup
 467       \fret-diagram #"h:6;6-3;5-2;4-o;3-o;2-o;1-3;"
 468   }
 469 >>
 470 @end lilypond
 471
 472 The number of strings in a fret diagram can be changed to accomodate
 473 different instruments such as banjos and ukeleles with the fret-diagram
 474 markup string.
 475
 476 @lilypond[quote, verbatim]
 477 <<
 478   \context ChordNames {
 479      \chordmode {
 480        a1
 481      }
 482   }
 483   \context Staff {
 484         %% A chord for ukelele
 485     a'1 ^\markup \fret-diagram #"w:4;4-2-2;3-1-1;2-o;1-o;"
 486   }
 487 >>
 488 @end lilypond
 489
 490 Fingering indications can be added, and the location of fingering labels
 491 can be controlled by the fret-diagram markup string.
 492
 493 @lilypond[quote, verbatim]
 494 <<
 495   \context ChordNames {
 496      \chordmode {
 497        c1 d:m
 498      }
 499   }
 500   \context Staff {
 501     \clef "treble_8"
 502     < c e g c' e' > 1 ^\markup
 503       \fret-diagram #"f:1;6-x;5-3-3;4-2-2;3-o;2-1-1;1-o;"
 504     < d a d' f'> ^\markup
 505       \fret-diagram #"f:2;6-x;5-x;4-o;3-2-2;2-3-3;1-1-1;"
 506   }
 507 >>
 508 @end lilypond
 509
 510 Dot radius and dot position can be controlled with the fret-diagram
 511 markup string.
 512
 513 @lilypond[quote, verbatim]
 514 <<
 515   \context ChordNames {
 516      \chordmode {
 517        c1 d:m
 518      }
 519   }
 520   \context Staff {
 521     \clef "treble_8"
 522     < c e g c' e' > 1 ^\markup
 523       \fret-diagram #"d:0.35;6-x;5-3;4-2;3-o;2-1;1-o;"
 524     < d a d' f'> ^\markup
 525       \fret-diagram #"p:0.2;6-x;5-x;4-o;3-2;2-3;1-1;"
 526   }
 527 >>
 528 @end lilypond
 529
 530 The fret-diagram-terse markup string omits string numbers; the string
 531 number is implied by the presence of semicolons.  There is one semicolon
 532 for each string in the diagram.  The first semicolon corresponds to the
 533 highest string number and the last semicolon corresponds to the first string.
 534 Mute strings, open strings, and fret numbers can be indicated.
 535
 536 @lilypond[quote, verbatim]
 537 <<
 538   \context ChordNames {
 539      \chordmode {
 540        c1 d:m
 541      }
 542   }
 543   \context Staff {
 544     \clef "treble_8"
 545     < c e g c' e' > 1 ^\markup
 546       \fret-diagram-terse #"x;3;2;o;1;o;"
 547     < d a d' f'> ^\markup
 548       \fret-diagram-terse #"x;x;o;2;3;1;"
 549   }
 550 >>
 551 @end lilypond
 552
 553 Barre indicators can be included in the fret-diagram-terse markup string.
 554
 555 @lilypond[quote, verbatim]
 556 <<
 557   \context ChordNames {
 558      \chordmode {
 559        f1 g
 560      }
 561   }
 562   \context Staff {
 563     \clef "treble_8"
 564     < f, c f a c' f'>1 ^\markup
 565       \fret-diagram-terse #"1-(;3;3;2;1;1-);"
 566     < g, b, d g b' g'> ^\markup
 567       \fret-diagram-terse #"3-(;5;5;4;3;3-);"
 568   }
 569 >>
 570 @end lilypond
 571
 572 Fingering indications can be included in the fret-diagram-terse markup string.
 573
 574 @c Need to use override to enable fingerings to show this -- can we do so?
 575 @lilypond[quote, verbatim]
 576 <<
 577   \context ChordNames {
 578      \chordmode {
 579        c1 d:m
 580      }
 581   }
 582   \context Staff {
 583     \override Voice.TextScript
 584       #'fret-diagram-details #'finger-code = #'below-string
 585     \clef "treble_8"
 586     < c e g c' e' > 1 ^\markup
 587       \fret-diagram-terse #"x;3-3;2-2;o;1-1;o;"
 588     < d a d' f'> ^\markup
 589       \fret-diagram-terse #"x;x;o;2-2;3-3;1-1;"
 590   }
 591 >>
 592 @end lilypond
 593
 594 Other fret diagram properties must be adjusted using @code{\override} when using
 595 the fret-diagram-terse markup.
 596
 597 The fret-diagram-verbose markup string is in the format of a Scheme list.  Each
 598 element of the list indicates an item to be placed on the fret diagram.
 599
 600 @lilypond[quote, verbatim]
 601 <<  \context ChordNames {
 602      \chordmode {
 603        c1 d:m
 604      }
 605   }
 606   \context Staff {
 607     \clef "treble_8"
 608     < c e g c' e' > 1 ^\markup
 609       \fret-diagram-verbose #'(
 610         (mute 6)
 611         (place-fret 5 3)
 612         (place-fret 4 2)
 613         (open 3)
 614         (place-fret 2 1)
 615         (open 1)
 616       )
 617     < d a d' f'> ^\markup
 618       \fret-diagram-verbose #'(
 619         (mute 6)
 620         (mute 5)
 621         (open 4)
 622         (place-fret 3 2)
 623         (place-fret 2 3)
 624         (place-fret 1 1)
 625       )
 626   }
 627 >>
 628 @end lilypond
 629
 630 Fingering indications and barres can be included in a
 631 fret-diagram-verbose markup string.
 632
 633 @c \override is necessary to make fingering visible
 634 @lilypond[quote, verbatim]
 635 <<
 636   \context ChordNames {
 637      \chordmode {
 638        f1 g
 639      }
 640   }
 641   \context Staff {
 642     \clef "treble_8"
 643     \override Voice.TextScript
 644       #'fret-diagram-details #'finger-code = #'below-string
 645
 646     < f, c f a c' f'>1 ^\markup
 647       \fret-diagram-verbose #'(
 648         (place-fret 6 1)
 649         (place-fret 5 3)
 650         (place-fret 4 3)
 651         (place-fret 3 2)
 652         (place-fret 2 1)
 653         (place-fret 1 1)
 654         (barre 6 1 1)
 655       )
 656     < g, b, d g b' g'> ^\markup
 657       \fret-diagram-verbose #'(
 658         (place-fret 6 3 2)
 659         (place-fret 5 2 1)
 660         (open 4)
 661         (open 3)
 662         (open 2)
 663         (place-fret 1 3 3)
 664       )
 665   }
 666 >>
 667 @end lilypond
 668
 669 All other fret diagram properties must be adjusted using @code{\override}
 670 when using the fret-diagram-verbose markup.
 671
 672 @ignore
 673 The following example shows the three fret-diagram markup
 674 interfaces, along with examples of common tweaks.  For example,
 675 the size of the verbose fret diagram is reduced to 0.75, and the
 676 finger indications are specified to appear below the diagram.  The
 677 terse diagram includes tweaks to specify placement of finger code
 678 and color of dots.
 679
 680 @lilypond[verbatim,ragged-right,quote]
 681 \new Voice {
 682   \clef "treble_8"
 683   d^\markup \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-2;"
 684   d d d
 685   fis^\markup \override #'(size . 0.75) {
 686     \override #'(finger-code . below-string) {
 687       \fret-diagram-verbose #'((place-fret 6 2 1) (barre 6 1 2)
 688                                (place-fret 5 4 3)
 689                                (place-fret 4 4 4)
 690                                (place-fret 3 3 2)
 691                                (place-fret 2 2 1)
 692                                (place-fret 1 2 1))
 693     }
 694   }
 695   fis fis fis
 696   c^\markup \override #'(dot-radius . 0.35) {
 697     \override #'(finger-code . in-dot) {
 698       \override #'(dot-color . white) {
 699         \fret-diagram-terse #"x;3-1-(;5-2;5-3;5-4;3-1-);"
 700       }
 701     }
 702   }
 703   c c c
 704 }
 705 @end lilypond
 706 @end ignore
 707
 708 The graphical layout of a fret diagram can be customized according to
 709 user preference through the properties of the @code{fret-diagram-interface}.
 710 Details are found at @rinternals{fret-diagram-interface}.  For a fret diagram
 711 markup , the interface properties belong to @code{Voice.TextScript}.
 712
 713 @snippets
 714 TODO create snippets for changing properties.  Use regression test?
 715
 716 @seealso
 717
 718 Notation Reference:
 719 @ref{Text markup commands}.
 720
 721 Snippets:
 722 @rlsr{Fretted strings}.
 723
 724 Internals Reference:
 725 @rinternals{fret-diagram-interface}.
 726
 727 @node Right-hand fingerings
 728 @subsubsection Right-hand fingerings
 729
 730 Right-hand fingerings @var{p-i-m-a} must be entered within a
 731 chord construct @code{<>} for them to be printed in the score,
 732 even when applied to a single note.
 733
 734 @warning{There @strong{must} be a hyphen after the note and a space
 735 before the closing @code{>}.}
 736
 737 @lilypond[quote,verbatim,relative=0]
 738 \clef "treble_8"
 739 <c-\rightHandFinger #1 >4
 740 <e-\rightHandFinger #2 >
 741 <g-\rightHandFinger #3 >
 742 <c-\rightHandFinger #4 >
 743 <c,-\rightHandFinger #1 e-\rightHandFinger #2 g-\rightHandFinger #3 c-\rightHandFinger #4 >1
 744 @end lilypond
 745
 746 For convenience, you can abbreviate @code{\rightHandFinger} to something
 747 short, for example @code{RH},
 748
 749 @example
 750 #(define RH rightHandFinger)
 751 @end example
 752
 753 @cindex fingerings, right hand, for guitar
 754 @cindex right hand fingerings for guitar
 755
 756 @snippets
 757
 758 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 759 {placement-of-right-hand-fingerings.ly}
 760
 761 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 762 {fingerings,-string-indications,-and-right-hand-fingerings.ly}
 763
 764 @seealso
 765
 766 Snippets:
 767 @rlsr{Fretted strings}.
 768
 769 Internals Reference:
 770 @rinternals{StrokeFinger}.
 771
 772
 773 @node Guitar
 774 @subsection Guitar
 775
 776 Most of the notational issues associated with guitar music are
 777 covered sufficiently in the general fretted strings section, but there
 778 are a few more worth covering here.  Occasionally users want to
 779 create songbook-type documents having only lyrics with chord
 780 indications above them.  Since Lilypond is a music typesetter,
 781 it is not recommended for documents that have no music notation
 782 in them.  A better alternative is a word processor, text editor,
 783 or, for experienced users, a typesetter like GuitarTeX.
 784
 785 @menu
 786 * Indicating position and barring::
 787 * Indicating harmonics and dampened notes::
 788 @end menu
 789
 790 @node Indicating position and barring
 791 @subsubsection Indicating position and barring
 792
 793 This example demonstrates how to include guitar position and
 794 barring indications.
 795
 796 @lilypond[quote,ragged-right,fragment,verbatim,relative=0]
 797 \clef "treble_8"
 798 b16 d g b e
 799 \textSpannerDown
 800 \override TextSpanner #'bound-details #'left #'text = #"XII "
 801   g16\startTextSpan
 802   b16 e g e b g\stopTextSpan
 803 e16 b g d
 804 @end lilypond
 805
 806 @seealso
 807
 808 Notation Reference:
 809 @ref{Text spanners}.
 810
 811 Snippets:
 812 @rlsr{Fretted strings},
 813 @rlsr{Expressive marks}.
 814
 815 @node Indicating harmonics and dampened notes
 816 @subsubsection Indicating harmonics and dampened notes
 817
 818 Special note heads can be used to indicate dampened notes or
 819 harmonics.  Harmonics are normally further explained with a
 820 text markup.
 821
 822 @lilypond[quote,ragged-right,fragment,verbatim]
 823 \relative c' {
 824   \clef "treble_8"
 825   \override Staff.NoteHead #'style = #'cross
 826   g8 a b c b4
 827   \override Staff.NoteHead #'style = #'harmonic-mixed
 828   d^\markup { \italic { \fontsize #-2 { "harm. 12" }}} <g b>1
 829 }
 830 @end lilypond
 831
 832 @seealso
 833
 834 Snippets:
 835 @rlsr{Fretted strings}.
 836
 837 Notation Reference:
 838 @ref{Special note heads},
 839 @ref{Note head styles}.
 840
 841 @node Banjo
 842 @subsection Banjo
 843
 844 @menu
 845 * Banjo tablatures::
 846 @end menu
 847
 848 @node Banjo tablatures
 849 @subsubsection Banjo tablatures
 850 @cindex Banjo tablatures
 851
 852 LilyPond has basic support for the five-string banjo.  When making tablatures
 853 for five-string banjo, use the banjo tablature format function to get
 854 correct fret numbers for the fifth string:
 855
 856 @c due to crazy intervals of banjo music, absolute pitch is recommended
 857
 858 @lilypond[quote,ragged-right,fragment,verbatim]
 859 \new TabStaff <<
 860   \set TabStaff.tablatureFormat = #fret-number-tablature-format-banjo
 861   \set TabStaff.stringTunings = #banjo-open-g-tuning
 862   {
 863     \stemDown
 864     g8 d' g'\5 a b g e d' |
 865     g4 d''8\5 b' a'\2 g'\5 e'\2 d' |
 866     g4
 867   }
 868 >>
 869 @end lilypond
 870
 871 A number of common tunings for banjo are predefined in LilyPond:
 872 @code{banjo-c-tuning} (gCGBD), @code{banjo-modal-tuning} (gDGCD),
 873 @code{banjo-open-d-tuning} (aDF#AD) and @code{banjo-open-dm-tuning}
 874 (aDFAD).
 875
 876 These tunings may be converted to four-string banjo tunings using the
 877 @code{four-string-banjo} function:
 878
 879 @example
 880 \set TabStaff.stringTunings = #(four-string-banjo banjo-c-tuning)
 881 @end example
 882
 883 @seealso
 884
 885 Snippets:
 886 @rlsr{Fretted strings}.
 887
 888 The file @file{scm/@/output@/-lib@/.scm} contains predefined banjo tunings.
 889
 890
 891
 892
 893