]> git.donarmstrong.com Git - lilypond.git/commitdiff
Update fretted-strings.itely
authorCarl Sorensen <c_sorensen@byu.edu>
Wed, 13 Aug 2008 00:13:14 +0000 (18:13 -0600)
committerCarl Sorensen <c_sorensen@byu.edu>
Wed, 13 Aug 2008 00:13:14 +0000 (18:13 -0600)
Documentation/user/fretted-strings.itely

index 8bcea60612c6460926ff84aa500c942c629b9e35..038019e7ca229c7cb0bd15f8411d81ef3709a042 100644 (file)
@@ -259,32 +259,42 @@ is the standard EADGBE tuning.  Some other predefined tunings are
 are found in @code{scm/output-lib.scm}.
 
 A string tuning is a Scheme list of string pitches, 
-one for each string, ordered from the bottom to the 
-top of the tablature staff.
-This ordinarily results in ordering from lowest pitch to highest
-pitch, but some instruments (e.g. ukulele) do not have strings
-ordered by pitch.
-
-A string pitch in a string tuning list is the pitch difference of 
-middle C from the open string measured in semitones.  The pitch must
-be an integer.  Lilypond calculates the actual pitch of the string by
-adding the string tuning pitch to the actual pitch for middle C.
+one for each string, ordered by string number from 1 to N,
+where string 1 is at the top of the tablature staff and
+string N is at the bottom.  This ordinarily results in ordering 
+from highest pitch to lowest pitch, but some instruments 
+(e.g. ukulele) do not have strings ordered by pitch.
+
+A string pitch in a string tuning list is the pitch difference  
+of the open string from middle C measured in semitones.  The 
+string pitch must be an integer.  Lilypond calculates the actual 
+pitch of the string by adding the string tuning pitch to the 
+actual pitch for middle C.
 
 LilyPond automatically calculates the number of strings in the
 @code{TabStaff} as the number of elements in @code{stringTunings}.
 
 Any desired string tuning can be created.  For example, we can
 define a string tuning for a four-string instrument with pitches
-of e, a, d', and g':
+of @code{a''},  @code{d''},  @code{g'}, and @code{c'}:
 
 
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new TabStaff {
-  \set TabStaff.stringTunings = #'(-5 -10 -15 -20)
-  {
-    a,4 c' a e' e c' a e'
-  }
+@lilypond[quote,verbatim]
+mynotes = {
+    c'4 e' g' c'' |
+    e'' g'' b'' c'''
 }
+
+<<
+  \new Staff {
+    \clef treble
+    \mynotes
+  }
+  \new TabStaff {
+    \set TabStaff.stringTunings = #'(21 14 7 0)
+    \mynotes
+  }
+>>
 @end lilypond
 
 @seealso
@@ -302,6 +312,7 @@ Internals Reference:
 
 No guitar special effects have been implemented.
 
+
 @node Fret diagram markups
 @subsubsection Fret diagram markups
 @cindex fret diagrams