]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/snippets/tweaking-clef-properties.ly
Makelsr.py run
[lilypond.git] / Documentation / snippets / tweaking-clef-properties.ly
index 6fd984c2d1964d8c39c7f43781574000a1a6c91e..2a30cfa8e823f85950629a8038afa79a30c6d189 100644 (file)
-%% Do not edit this file; it is automatically
-%% generated from LSR http://lsr.dsi.unimi.it
-%% This file is in the public domain.
-\version "2.13.16"
+% DO NOT EDIT this file manually; it is automatically
+% generated from Documentation/snippets/new
+% Make any changes in Documentation/snippets/new/
+% and then run scripts/auxiliar/makelsr.py
+%
+% This file is in the public domain.
+%% Note: this file works from version 2.17.18
+\version "2.17.18"
 
 \header {
   lsrtags = "pitches, staff-notation, tweaks-and-overrides"
 
 
 \header {
   lsrtags = "pitches, staff-notation, tweaks-and-overrides"
 
-%% Translation of GIT committish: 5a7301fc350ffc3ab5bd3a2084c91666c9e9a549
-  doctitlees = "Trucaje de las propiedades de clave"
-  texidoces = "
-La instrucción @code{\\clef \"treble_8\"} equivale a un ajuste de
-@code{clefGlyph}, @code{clefPosition} (que controla la posición
-vertical de la clave), @code{middleCPosition} y
-@code{clefOctavation}.  Se imprime una clave cada vez que se
-modifica cualquiera de las propiedades excepto
-@code{middleCPosition}.
-
-Observe que la modificación del glifo, la posición de la clave o
-su octavación, no cambian 'per se' la posición de las siguientes
-notas del pentagrama: para hacer esto también se debe especificar
-la posición del Do central.  Los parámetros posicionales están en
-relación con la tercera línea del pentagrama, los números
-positivos desplazan hacia arriba, contando una unidad por cada
-línea y espacio.  El valor de @code{clefOctavation} se
-establecería normalmente a 7, -7, 15 or -15, pero son válidos
-otros valores.
-
-Cuando se produce un cambio de clave en el salto de línea se
-imprime la clave nueva tanto al final de la línea anterior como al
-principio de la nueva, de forma predeterminada.  Si no se necesita
-la clave de advertencia al final de la línea anterior, se puede
-quitar estableciendo el valor de la propiedad
-@code{explicitClefVisibility} de @code{Staff}, a
-@code{end-of-line-invisible}.  El comportamiento predeterminado se
-puede recuperar con @code{\\unset Staff.explicitClefVisibility}.
-
-Los siguientes ejemplos muestran las posibilidades cuando se
-ajustan estas propiedades manualmente.  En la primera línea, los
-cambios manuales preservan el posicionamiento relativo estándar de
-las claves y las notas, pero no lo hacen en la segunda línea.
-"
-
-
-%% Translation of GIT committish: 0a868be38a775ecb1ef935b079000cebbc64de40
-  doctitlede = "Eigenschaften des Schlüssels optimieren"
-  texidocde = "
-Der Befehl @code{\\clef \"treble_8\"} ist gleichbedeutend mit einem
-expliziten Setzen der Eigenschaften von @code{clefGlyph},
-@code{clefPosition} (welche die vertikale Position des Schlüssels bestimmt),
-@code{middleCPosition} und @code{clefOctavation}.  Ein Schlüssel wird
-ausgegeben, wenn eine der Eigenschaften außer @code{middleCPosition} sich
-ändert.
-
-Eine Änderung des Schriftzeichens (Glyph), der Schlüsselposition oder der
-Oktavierung selber ändert noch nicht die Position der darauf folgenden Noten
-auf dem System: das geschieht nur, wenn auch die Position des
-eingestrichenen@tie{}C (middleCPosition) angegeben wird.  Die
-Positionsparameter sind relativ zur Mittellinie des Systems, dabei versetzen
-positive Zahlen die Position nach oben, jeweils eine Zahl für jede Linie
-plus Zwischenraum.  Der @code{clefOctavation}-Wert ist normalerweise auf 7,
--7, 15 oder -15 gesetzt, aber auch andere Werte sind gültig.
-
-Wenn ein Schlüsselwechsel an einem Zeilenwechsel geschieht, wird das neue
-Symbol sowohl am Ende der alten Zeilen als auch am Anfang der neuen Zeile
-ausgegeben.  Wenn der Warnungs-Schlüssel am Ende der alten Zeile nicht
-erforderlich ist, kann er unterdrückt werden, indem die
-@code{explicitClefVisibility}-Eigenschaft des @code{Staff}-Kontextes auf den
-Wert @code{end-of-line-invisible} gesetzt wird.  Das Standardverhalten kann
-mit @code{\\unset Staff.explicitClefVisibility} wieder hergestellt werden.
-
-Die folgenden Beispiele zeigen die Möglichkeiten, wenn man diese
-Eigenschaften manuell setzt.  Auf der ersten Zeile erhalten die manuellen
-Änderungen die ursprüngliche relative Positionierung von Schlüssel und
-Noten, auf der zweiten Zeile nicht.
-"
-
-%% Translation of GIT committish: 58a29969da425eaf424946f4119e601545fb7a7e
-  texidocfr = "
-La commande @code{\\clef \"treble_8\"} équivaut à définir @code{clefGlyph},
-@code{clefPosition} -- qui contrôle la position verticale de la clé --
-@code{middleCPosition} et @code{clefOctavation}.  Une clé est imprimée
-lorsque l'une de ces propriétés, hormis @code{middleCPosition}, est
-modifiée.
- Les exemples suivant font
-apparaître des possibilités de réglage manuel de ces propriétés.
-
-
-Modifier le glyphe, la position de la clef ou son octaviation ne
-changera pas la position des notes ; il faut pour y parvenir modifier
-aussi la position du do médium.  Le positionnement est relatif à la
-ligne médiane, un nombre positif faisant monter, chaque ligne ou
-interligne comptant pour 1.  La valeur de @code{clefOctavation} devrait
-être de 7, -7, 15 ou -15, bien que rien ne vous empêche de lui affecter
-une autre valeur.
-
-
-Lorsqu'un changement de clef intervient en même temps qu'un saut de
-ligne, la nouvelle clef est imprimer à la fois en fin de ligne et au
-début de la suivante.  Vous pouvez toujours supprimer cette « clef de
-précaution » en affectant la valeur @code{end-of-line-invisible} à la
-propriété @code{explicitClefVisibility} du contexte @code{Staff}.  Le
-comportement par défaut sera réactivé par
-@w{@code{\\unset@tie{}Staff.explicitClefVisibility}}.
-
-
-Les exemples qui suivent illustrent les différentes possibilités de
-définir ces propriétés manuellement.  Sur la première ligne, la
-position relative des notes par rapport aux clefs sont préservées, ce
-qui n'est pas le cas pour la deuxième ligne.
-
-"
-  doctitlefr = "Affinage des propriétés d'une clef"
-
   texidoc = "
   texidoc = "
-The command @code{\\clef \"treble_8\"} is equivalent to setting
-@code{clefGlyph}, @code{clefPosition} (which controls the vertical
-position of the clef), @code{middleCPosition} and
-@code{clefOctavation}. A clef is printed when any of the properties
-except @code{middleCPosition} are changed.
-
-
-Note that changing the glyph, the position of the clef, or the
-octavation does not in itself change the position of subsequent notes
-on the staff: the position of middle C must also be specified to do
-this. The positional parameters are relative to the staff center line,
-positive numbers displacing upwards, counting one for each line and
-space. The @code{clefOctavation} value would normally be set to 7, -7,
-15 or -15, but other values are valid.
-
-
-When a clef change takes place at a line break the new clef symbol is
-printed at both the end of the previous line and the beginning of the
-new line by default. If the warning clef at the end of the previous
-line is not required it can be suppressed by setting the @code{Staff}
-property @code{explicitClefVisibility} to the value
-@code{end-of-line-invisible}. The default behavior can be recovered
-with  @code{\\unset Staff.explicitClefVisibility}.
+Changing the Clef glyph, its position, or the ottavation does not
+change the position of subsequent notes on the staff.  To get key
+signatures on their correct staff lines @code{middleCClefPosition}
+must also be specified, with positive or negative values moving
+@emph{middle C} up or down respectively, relative to the staff's
+center line.
+
+For example, @code{\\clef \"treble_8\"} is equivalent to setting
+the @code{clefGlyph}, @code{clefPosition} (the vertical position
+of the clef itself on the staff), @code{middleCPosition} and
+@code{clefTransposition}. Note that when any of these properties
+(except @code{middleCPosition}) are changed a new clef symbol is
+printed.
 
 The following examples show the possibilities when setting these
 properties manually. On the first line, the manual changes preserve the
 
 The following examples show the possibilities when setting these
 properties manually. On the first line, the manual changes preserve the
@@ -146,35 +34,45 @@ line, they do not.
   doctitle = "Tweaking clef properties"
 } % begin verbatim
 
   doctitle = "Tweaking clef properties"
 } % begin verbatim
 
-\layout { ragged-right = ##t }
+\layout { ragged-right = ##t } % begin verbatim
 
 {
   % The default treble clef
 
 {
   % The default treble clef
+  \key f \major
   c'1
   % The standard bass clef
   \set Staff.clefGlyph = #"clefs.F"
   \set Staff.clefPosition = #2
   \set Staff.middleCPosition = #6
   c'1
   % The standard bass clef
   \set Staff.clefGlyph = #"clefs.F"
   \set Staff.clefPosition = #2
   \set Staff.middleCPosition = #6
+  \set Staff.middleCClefPosition = #6
+  \key g \major
   c'1
   % The baritone clef
   \set Staff.clefGlyph = #"clefs.C"
   \set Staff.clefPosition = #4
   \set Staff.middleCPosition = #4
   c'1
   % The baritone clef
   \set Staff.clefGlyph = #"clefs.C"
   \set Staff.clefPosition = #4
   \set Staff.middleCPosition = #4
+  \set Staff.middleCClefPosition = #4
+  \key f \major
   c'1
   % The standard choral tenor clef
   \set Staff.clefGlyph = #"clefs.G"
   \set Staff.clefPosition = #-2
   c'1
   % The standard choral tenor clef
   \set Staff.clefGlyph = #"clefs.G"
   \set Staff.clefPosition = #-2
-  \set Staff.clefOctavation = #-7
+  \set Staff.clefTransposition = #-7
   \set Staff.middleCPosition = #1
   \set Staff.middleCPosition = #1
+  \set Staff.middleCClefPosition = #1
+  \key f \major
   c'1
   % A non-standard clef
   \set Staff.clefPosition = #0
   c'1
   % A non-standard clef
   \set Staff.clefPosition = #0
-  \set Staff.clefOctavation = #0
+  \set Staff.clefTransposition = #0
   \set Staff.middleCPosition = #-4
   \set Staff.middleCPosition = #-4
+  \set Staff.middleCClefPosition = #-4
+  \key g \major
   c'1 \break
 
   % The following clef changes do not preserve
   c'1 \break
 
   % The following clef changes do not preserve
-  % the normal relationship between notes and clefs:
+  % the normal relationship between notes, key signatures
+  % and clefs:
 
   \set Staff.clefGlyph = #"clefs.F"
   \set Staff.clefPosition = #2
 
   \set Staff.clefGlyph = #"clefs.F"
   \set Staff.clefPosition = #2
@@ -183,9 +81,9 @@ line, they do not.
   c'1
   \set Staff.clefGlyph = #"clefs.C"
   c'1
   c'1
   \set Staff.clefGlyph = #"clefs.C"
   c'1
-  \set Staff.clefOctavation = #7
+  \set Staff.clefTransposition = #7
   c'1
   c'1
-  \set Staff.clefOctavation = #0
+  \set Staff.clefTransposition = #0
   \set Staff.clefPosition = #0
   c'1
 
   \set Staff.clefPosition = #0
   c'1
 
@@ -194,4 +92,3 @@ line, they do not.
   \set Staff.middleCPosition = #0
   c'1
 }
   \set Staff.middleCPosition = #0
   c'1
 }
-