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.14.2"
   8
   9 \header {
  10   lsrtags = "version-specific, pitches, contemporary-notation, staff-notation, really-cool"
  11
  12 %% Translation of GIT committish: b482c3e5b56c3841a88d957e0ca12964bd3e64fa
  13   doctitlees = "Armaduras de tonalidad no tradicionales"
  14   texidoces = "
  15
  16 La muy utilizada instrucción @code{\\key} establece la propiedad
  17 @code{keySignature} property, dentro del contexto @code{Staff}.
  18
  19 Para crear armaduras de tonalidad no estándar, ajuste esta
  20 propiedad directamente.  El formato de esta instrucción es una
  21 lista:
  22
  23 @code{\\set Staff.keySignature = #`(((octava . paso) . alteración)
  24 ((octava . paso) . alteración) ...)} donde, para cada elemento
  25 dentro de la lista, @code{octava} especifica la octava
  26 (siendo@tie{}cero la octava desde el Do@tie{}central hasta el Si
  27 por encima), @code{paso} especifica la nota dentro de la octava
  28 (cero@tie{}significa@tie{}Do y 6@tie{}significa@tie{}Si), y
  29 @code{alteración} es @code{,SHARP ,FLAT ,DOUBLE-SHARP}
  30 etc. (observe la coma precedente.)
  31
  32 De forma alternativa, para cada elemento de la lista el uso del
  33 formato más conciso @code{(paso . alteración)} especifica que la
  34 misma alteración debe estar en todas las octavas.
  35
  36 He aquí un ejemplo de una posible armadura para generar una escala
  37 exátona:
  38 "
  39
  40
  41 %% Translation of GIT committish: 6ae36b6f8a7cf2df5f4e46c3c06820fccd9f35e1
  42   texidocit = "
  43 Il comando @code{\\key} comunemente usato imposta la proprietà
  44 @code{keySignature}, che fa parte del contesto @code{Staff}.
  45
  46 Per creare armature di chiave non standard, tale proprietà va
  47 impostata esplicitamente.  Il formato di questo comando è
  48 una lista:
  49
  50 @code{\\set Staff.keySignature = #`(((ottava . grado) . alterazione) ((ottava
  51 . grado) . alterazione) ...)} dove, per ogni elemento della lista,
  52 @code{ottava} indica l'ottava (0@tie{}è l'ottava dal Do@tie{}centrale
  53 al Si precedente), @code{grado} indica la nota all'interno
  54 dell'ottava (0@tie{}significa@tie{}Do e 6@tie{}significa@tie{}Si) e @code{alterazione}
  55 può essere @code{,SHARP ,FLAT ,DOUBLE-SHARP} etc.  (Si noti la virgola iniziale.)
  56
  57 Altrimenti, usando, per ogni elemento della lista, il formato breve
  58 @code{(grado . alterazione)}, ciò indica che la stessa alterazione deve
  59 essere presente in tutte le ottave.
  60
  61 Ecco un esempio di una possibile armatura per generare una scala
  62 a tono intero:
  63 "
  64   doctitleit = "Armature di chiave non tradizionali"
  65
  66 %% Translation of GIT committish: 0a868be38a775ecb1ef935b079000cebbc64de40
  67   doctitlede = "Untypische Tonarten"
  68   texidocde = "
  69 Der üblicherweise benutzte @code{\\key}-Befehl setzt die
  70 @code{keySignature}-Eigenschaft im @code{Staff}-Kontext.
  71
  72 Um untypische Tonartenvorzeichen zu erstellen, muss man diese Eigenschaft
  73 direkt setzen.  Das Format für den Befehl ist eine Liste: @code{ \\set
  74 Staff.keySignature = #`(((Oktave . Schritt) . Alteration) ((Oktave
  75 . Schritt) . Alteration) ...)} wobei für jedes Element in der Liste
  76 @code{Oktave} die Oktave angibt (0@tie{}ist die Oktave vom
  77 eingestrichenen@tie{}C bis zum eingestrichenen@tie{}H), @code{Schritt} gibt
  78 die Note innerhalb der Oktave an (0@tie{}heißt@tie{}C und
  79 6@tie{}heißt@tie{}H), und @code{Alteration} ist @code{,SHARP ,FLAT
  80 ,DOUBLE-SHARP} usw.  (Beachte das beginnende Komma.)
  81
  82 Alternativ kann auch jedes Element der Liste mit dem allgemeineren Format
  83 @code{(Schritt . Alteration)} gesetzt werden, wobei dann die Einstellungen
  84 für alle Oktaven gelten.
  85
  86 Hier ein Beispiel einer möglichen Tonart für eine Ganztonleiter:
  87 "
  88
  89 %% Translation of GIT committish: 57f9346bb030f49336a858fcbf1519366fe56454
  90   texidocfr = "
  91 La commande @code{\\key} détermine la propriété @code{keySignature} d'un
  92 contexte @code{Staff}.
  93
  94 Des armures inhabituelles peuvent être spécifiées en modifiant
  95 directement cette propriété. Il s'agit en l'occurrence de définir une
  96 liste :
  97
  98 @code{\\set Staff.keySignature = #`(((octave . pas) . altération) ((octave . pas) . altération) @dots{})}
  99
 100 dans laquelle, et pour chaque élément,
 101 @code{octave} spécifie l'octave (0 pour celle allant du do médium au si
 102 supérieur), @code{pas} la note dans cette octave (0 pour do et 6 pour
 103 si), et @code{altération} sera @code{,SHARP ,FLAT ,DOUBLE-SHARP} etc.
 104 (attention à la virgule en préfixe).
 105
 106 Une formulation abrégée -- @code{(pas . altération)} -- signifie que
 107 l'altération de l'élément en question sera valide quel que soit l'octave.
 108
 109 Voici, par exemple, comment générer une gamme par ton :
 110
 111 "
 112   doctitlefr = "Armures inhabituelles"
 113
 114
 115   texidoc = "
 116 The commonly used @code{\\key} command sets the @code{keySignature}
 117 property, in the @code{Staff} context.
 118
 119 To create non-standard key signatures, set this property directly. The
 120 format of this command is a list:
 121
 122 @code{ \\set Staff.keySignature = #`(((octave . step) . alter) ((octave
 123 . step) . alter) ...) } where, for each element in the list,
 124 @code{octave} specifies the octave (0 being the octave from middle C to
 125 the B above), @code{step} specifies the note within the octave (0 means
 126 C and 6 means B), and @code{alter} is @code{,SHARP ,FLAT ,DOUBLE-SHARP}
 127 etc. (Note the leading comma.) The accidentals in the key signature
 128 will appear in the reverse order to that in which they are specified.
 129
 130
 131 Alternatively, for each item in the list, using the more concise format
 132 @code{(step . alter)} specifies that the same alteration should hold in
 133 all octaves.
 134
 135
 136 For microtonal scales where a @qq{sharp} is not 100 cents, @code{alter}
 137 refers to the alteration as a proportion of a 200-cent whole tone.
 138
 139
 140 Here is an example of a possible key signature for generating a
 141 whole-tone scale:
 142
 143 "
 144   doctitle = "Non-traditional key signatures"
 145 } % begin verbatim
 146
 147
 148 \relative c' {
 149   \set Staff.keySignature = #`(((0 . 6) . ,FLAT)
 150                                ((0 . 5) . ,FLAT)
 151                                ((0 . 3) . ,SHARP))
 152   c4 d e fis
 153   aes4 bes c2
 154 }
 155