X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fsnippets%2Fnew%2Fnon-traditional-key-signatures.ly;h=5559898bec44e98b01c798deb76b3137084ea56f;hb=f5fdeccc43889b77f9907d6b80d334921ca89fbc;hp=b0f2a629b35cf96d1706fb962d8d2d8459d48145;hpb=1c859650b6ff11a7dbe829328fd5cae3816b9231;p=lilypond.git diff --git a/Documentation/snippets/new/non-traditional-key-signatures.ly b/Documentation/snippets/new/non-traditional-key-signatures.ly index b0f2a629b3..5559898bec 100644 --- a/Documentation/snippets/new/non-traditional-key-signatures.ly +++ b/Documentation/snippets/new/non-traditional-key-signatures.ly @@ -1,36 +1,44 @@ -\version "2.13.0" +\version "2.19.7" \header { - lsrtags = "pitches, staff-notation" + lsrtags = "contemporary-notation, pitches, really-cool, staff-notation, version-specific" + texidoc = " -The commonly used @code{\\key} command sets the @code{keySignature} +The commonly used @code{\\key} command sets the @code{keyAlterations} property, in the @code{Staff} context. -To create non-standard key signatures, set this property directly. The +To create non-standard key signatures, set this property directly. The format of this command is a list: -@code{\\set Staff.keySignature = #`(((octave . step) . alter) ((octave -. step) . alter) ...)} where, for each element in the list, -@code{octave} specifies the octave (0@tie{}being the octave from -middle@tie{}C to the B above), @code{step} specifies the note within the -octave (0@tie{}means@tie{}C and 6@tie{}means@tie{}B), and @code{alter} is -@code{,SHARP ,FLAT ,DOUBLE-SHARP} etc. (Note the leading comma.) +@code{ \\set Staff.keyAlterations = #`(((octave . step) . alter) ((octave +. step) . alter) ...) } where, for each element in the list, +@code{octave} specifies the octave (0 being the octave from middle C to +the B above), @code{step} specifies the note within the octave (0 means +C and 6 means B), and @code{alter} is @code{,SHARP ,FLAT ,DOUBLE-SHARP} +etc. (Note the leading comma.) + Alternatively, for each item in the list, using the more concise format -@code{(step . alter)} specifies that the same alteration should hold in all -octaves. +@code{(step . alter)} specifies that the same alteration should hold in +all octaves. + + +For microtonal scales where a @qq{sharp} is not 100 cents, @code{alter} +refers to the alteration as a proportion of a 200-cent whole tone. + + +Here is an example of a possible key signature for generating a +whole-tone scale: -Here is an example of a possible key signature for generating a whole-tone -scale: " doctitle = "Non-traditional key signatures" } + \relative c' { - \set Staff.keySignature = #`(((0 . 6) . ,FLAT) - ((0 . 5) . ,FLAT) - ((0 . 3) . ,SHARP)) + \set Staff.keyAlterations = #`((6 . ,FLAT) + (5 . ,FLAT) + (3 . ,SHARP)) c4 d e fis aes4 bes c2 } -