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

   1 %% DO NOT EDIT this file manually; it is automatically
   2 %% generated from LSR http://lsr.dsi.unimi.it
   3 %% Make any changes in LSR itself, or in Documentation/snippets/new/ ,
   4 %% and then run scripts/auxiliar/makelsr.py
   5 %%
   6 %% This file is in the public domain.
   7 \version "2.16.0"
   8
   9 \header {
  10   lsrtags = "contemporary-notation, pitches, really-cool, staff-notation, version-specific"
  11
  12   texidoc = "
  13 The commonly used @code{\\key} command sets the @code{keySignature}
  14 property, in the @code{Staff} context.
  15
  16 To create non-standard key signatures, set this property directly. The
  17 format of this command is a list:
  18
  19 @code{ \\set Staff.keySignature = #`(((octave . step) . alter) ((octave
  20 . step) . alter) ...) } where, for each element in the list,
  21 @code{octave} specifies the octave (0 being the octave from middle C to
  22 the B above), @code{step} specifies the note within the octave (0 means
  23 C and 6 means B), and @code{alter} is @code{,SHARP ,FLAT ,DOUBLE-SHARP}
  24 etc. (Note the leading comma.) The accidentals in the key signature
  25 will appear in the reverse order to that in which they are specified.
  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 \relative c' {
  46   \set Staff.keySignature = #`(((0 . 6) . ,FLAT)
  47                                ((0 . 5) . ,FLAT)
  48                                ((0 . 3) . ,SHARP))
  49   c4 d e fis
  50   aes4 bes c2
  51 }