Documentation/snippets/non-traditional-key-signatures.ly

   1 % DO NOT EDIT this file manually; it is automatically
   2 % generated from Documentation/snippets/new
   3 % Make any changes in Documentation/snippets/new/
   4 % and then run scripts/auxiliar/makelsr.py
   5 %
   6 % This file is in the public domain.
   7 %% Note: this file works from version 2.19.21
   8 \version "2.19.21"
   9
  10 \header {
  11   lsrtags = "contemporary-notation, pitches, really-cool, staff-notation, version-specific"
  12
  13   texidoc = "
  14 The commonly used @code{\\key} command sets the @code{keyAlterations}
  15 property, in the @code{Staff} context.
  16
  17 To create non-standard key signatures, set this property directly. The
  18 format of this command is a list:
  19
  20 @code{ \\set Staff.keyAlterations = #`(((octave . step) . alter) ((octave
  21 . step) . alter) ...) } where, for each element in the list,
  22 @code{octave} specifies the octave (0 being the octave from middle C to
  23 the B above), @code{step} specifies the note within the octave (0 means
  24 C and 6 means B), and @code{alter} is @code{,SHARP ,FLAT ,DOUBLE-SHARP}
  25 etc. (Note the leading comma.)
  26
  27
  28 Alternatively, for each item in the list, using the more concise format
  29 @code{(step . alter)} specifies that the same alteration should hold in
  30 all octaves.
  31
  32
  33 For microtonal scales where a @qq{sharp} is not 100 cents, @code{alter}
  34 refers to the alteration as a proportion of a 200-cent whole tone.
  35
  36
  37 Here is an example of a possible key signature for generating a
  38 whole-tone scale:
  39
  40 "
  41   doctitle = "Non-traditional key signatures"
  42 } % begin verbatim
  43
  44
  45
  46 \relative {
  47   \set Staff.keyAlterations = #`((6 . ,FLAT)
  48                                  (5 . ,FLAT)
  49                                  (3 . ,SHARP))
  50   c'4 d e fis
  51   aes4 bes c2
  52 }