From ce827b8f9699836117c94e15502294cec5ae48f2 Mon Sep 17 00:00:00 2001 From: Graham Percival Date: Mon, 26 May 2008 22:22:00 -0700 Subject: [PATCH] Update from Jonathan. --- Documentation/user/fretted-strings.itely | 114 ++++++++++++++++++----- 1 file changed, 91 insertions(+), 23 deletions(-) diff --git a/Documentation/user/fretted-strings.itely b/Documentation/user/fretted-strings.itely index 34915ce0d4..eb1d63ade6 100644 --- a/Documentation/user/fretted-strings.itely +++ b/Documentation/user/fretted-strings.itely @@ -43,13 +43,49 @@ TBC @cindex String numbers -String numbers can be added to chords, by indicating the string number -with @code{\}@var{number}, +The string on which a note should be played may be indicated by +appending @code{\}@tie{}@var{number} to a note inside a chord. -@lilypond[relative,relative=1,ragged-right,fragment] - +@warning{String numbers @strong{must} be defined inside a chord, +even if there is only a single note in the chord.} + +@lilypond[verbatim,quote,relative=2] +4 2 +1 +@end lilypond + + +@ignore +In notation for fretted stringed instruments, the string on which +a note should be played is indicated by a circled number, and this +is added with @code{\}@var{number} inside a chord construct. The +string indication must occur within a @code{<>} chord construct for it to +be printed in the score, even if it is a single note. If the +@code{\}@var{number} is placed outside the @code{<>}, it will not generate +errors but also will not print the string indication. + +@warning{rhythmic durations must be specified outside of the +chords.} +example, @code{4} will produce a quarter-note C on the fifth +string. +@end ignore + +Although fingering is covered in detail elsewhere, it is worth noting +here how fingerings and string indications behave together, since +guitar music often incorporates both at once. The usual convention +is to place the fingering closest to the note, then the string +indication outside the fingering. This is controlled by the order in +which the two items appear: + +@lilypond[verbatim,quote,relative=2] +2 + @end lilypond +@snippets + +@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle] +{controlling-the-placement-of-chord-fingerings.ly} @seealso @@ -64,8 +100,8 @@ Internals Reference: @rinternals{StringNumber}, Tablature notation is used for notating music for plucked string instruments. Pitches are not denoted with note heads, but by -numbers indicating on which string and fret a note must be played. LilyPond -offers limited support for tablature. +numbers indicating on which string and fret a note must be played. +LilyPond offers limited support for tablature. The string number associated to a note is given as a backslash followed by a number, e.g., @code{c4\3} for a C quarter on the third @@ -198,9 +234,18 @@ No guitar special effects have been implemented. @cindex fret diagrams @cindex chord diagrams -Fret diagrams can be added to music as a markup to the desired note. The -markup contains information about the desired fret diagram, as shown in the -following example +Fret diagrams can be added to music as a markup to the desired note. +The markup contains information about the desired fret diagram. +There are three different fret-diagram markup interfaces: standard, terse, +and verbose. The three interfaces produce equivalent markups, but have +varying amounts of information in the markup string. Details about the +markup interfaces are found at @ref{Text markup commands}. + +The following example shows the three fret-diagram markup interfaces, +along with examples of common tweaks. For example, the size of the verbose +fret diagram is reduced to 0.75, and the finger indications are specified +to appear below the diagram. The terse diagram includes tweaks to +specify placement of finger code and color of dots. @lilypond[verbatim, ragged-right, quote] \new Voice { @@ -209,8 +254,10 @@ following example fis'^\markup \override #'(size . 0.75) { \override #'(finger-code . below-string) { \fret-diagram-verbose #'((place-fret 6 2 1) (barre 6 1 2) - (place-fret 5 4 3) (place-fret 4 4 4) - (place-fret 3 3 2) (place-fret 2 2 1) + (place-fret 5 4 3) + (place-fret 4 4 4) + (place-fret 3 3 2) + (place-fret 2 2 1) (place-fret 1 2 1)) } } @@ -226,12 +273,6 @@ following example } @end lilypond - -There are three different fret-diagram markup interfaces: standard, terse, -and verbose. The three interfaces produce equivalent markups, but have -varying amounts of information in the markup string. Details about the -markup interfaces are found at @ref{Text markup commands}. - You can set a number of graphical properties according to your preference. Details about the property interface to fret diagrams are found at @rinternals{fret-diagram-interface}. @@ -244,11 +285,22 @@ Details about the property interface to fret diagrams are found at @node Right hand fingerings @subsubsection Right hand fingerings -Right hand fingerings in chords can be entered using -@code{@var{note}-\rightHandFinger @var{finger}} +Right-hand fingerings @var{p-i-m-a} can be entered using +@code{<@var{note}-\rightHandFinger @var{finger} >}. +The right-hand fingering indication must occur within a @code{<>} chord +construct for it to be printed in the score, even if it is a single note. +There must be a hyphen after the note and the space +before the closing @code{>}. + -@lilypond[verbatim,fragment,relative=2] - +@lilypond[quote,ragged-right,fragment,verbatim] +\relative c' { + 4 + + + + 1 +} @end lilypond for brevity, you can abbreviate @code{\rightHandFinger} to something @@ -263,8 +315,8 @@ short, for example @code{RH}, @snippets -You may exercise greater control over right handing fingerings by -setting @code{strokeFingerOrientations}, +You may exercise greater control over the placement of right-hand +fingerings by setting @code{strokeFingerOrientations}, @lilypond[quote,verbatim,ragged-right,fragment,relative=1] #(define RH rightHandFinger) @@ -288,6 +340,21 @@ The letters used for the fingerings are contained in the property \override StrokeFinger #'digit-names = ##("x" "y" "z" "!" "@") 4 4 + 4 + 4 +} +@end lilypond + +This example combines left-hand fingering, string indication, and +right-hand fingering + +@lilypond[quote,ragged-right,fragment,verbatim] +#(define RH rightHandFinger) +\relative c' { + 4 + + + } @end lilypond @@ -385,3 +452,4 @@ These tunings may be converted to four string banjo tunings using the The file @file{scm/@/output@/-lib@/.scm} contains predefined banjo tunings. + -- 2.39.5