]> git.donarmstrong.com Git - lilypond.git/commitdiff
LSR: more commonprop moved to lsr.
authorGraham Percival <graham@percival-music.ca>
Sat, 8 Dec 2007 03:24:20 +0000 (19:24 -0800)
committerGraham Percival <graham@percival-music.ca>
Sat, 8 Dec 2007 03:24:20 +0000 (19:24 -0800)
Documentation/user/pitches.itely
input/lsr/editorial/clefs-commonly-tweaked-properties.ly
input/lsr/pitches/clefs-commonly-tweaked-properties.ly
input/lsr/staff/clefs-commonly-tweaked-properties.ly

index 57369e59b01e7f1a319575ebf7c97a9b21f99012..b06b466a73707010debbded0cba8ebe2c947875f 100644 (file)
@@ -764,91 +764,10 @@ For example,
 \clef "G_8" c4
 @end lilypond
 
-@commonprop
-
-@c FIXME
-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 in not required it can be suppressed by setting the
-@code{explicitClefVisibility} Staff property to the value
-@var{end-of-line-invisible}:  @code{\set
-Staff.explicitClefVisibility = #end-of-line-invisible} The default
-behaviour can be recovered with @code{\unset
-Staff.explicitClefVisibility}
-
-The command @code{\clef "treble_8"} is equivalent to setting
-@code{clefGlyph}, @code{clefPosition} (which controls the Y
-position of the clef), @code{middleCPosition} and
-@code{clefOctavation}.  A clef is printed when either the
-@code{clefGlyph}, @code{clefPosition} or @code{clefOctavation}
-properties 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 centre line, positive numbers
-displacing upwards, counting 1 for each line and space.  The
-clefOctavation value would normally be set to 7, -7, 15 or -15,
-but other values are not invalid.
-
-The following examples show the possibilities when setting these
-properties manually.  First some manual changes which preserve the
-standard relative positioning of clefs and notes:
-
-@lilypond[verbatim,quote,ragged-right]
-{
-  % The default treble clef
-  c'4
-  % The standard bass clef
-  \set Staff.clefGlyph = #"clefs.F"
-  \set Staff.clefPosition = #2
-  \set Staff.middleCPosition = #6
-  c'4
-  % The baritone clef
-  \set Staff.clefGlyph = #"clefs.C"
-  \set Staff.clefPosition = #4
-  \set Staff.middleCPosition = #4
-  c'4
-  % The standard choral tenor clef
-  \set Staff.clefGlyph = #"clefs.G"
-  \set Staff.clefPosition = #-2
-  \set Staff.clefOctavation = #-7
-  \set Staff.middleCPosition = #1
-  c'4
-  % A non-standard clef
-  \set Staff.clefPosition = #0
-  \set Staff.clefOctavation = #0
-  \set Staff.middleCPosition = #-4
-  c'4
-}
-@end lilypond
-
-and some which do not:
-
-@lilypond[verbatim,quote,ragged-right]
-{
-  \set Staff.clefGlyph = #"clefs.F"
-  \set Staff.clefPosition = #2
-  c'4
-  \set Staff.clefGlyph = #"clefs.G"
-  c'4
-  \set Staff.clefGlyph = #"clefs.C"
-  c'4
-  \set Staff.clefOctavation = #7
-  c'4
-  \set Staff.clefOctavation = #0
-  \set Staff.clefPosition = #0
-  c'4
-  \set Staff.middleCPosition = #4
-  c'4
-}
-@end lilypond
-
 
 @commonprop
 
-@lsr{pitches,
-clefs-commonly-tweaked-properties.ly}
+@lsr{pitches, clefs-commonly-tweaked-properties.ly}
 
 
 @seealso
index 90eb606cb1cdcbb121af4bc3d6ec3e883eabab6b..354ff14bdc9b521e25efe881448aaedb1a1c70b8 100644 (file)
@@ -5,26 +5,74 @@
 The command @code{\\clef \"treble_8\"} is equivalent to setting
 @code{clefGlyph}, @code{clefPosition} (which controls the Y position of
 the clef), @code{middleCPosition} and @code{clefOctavation}.  A clef is
-printed when any of these properties are changed.  The following
-example shows possibilities when setting properties manually. 
+printed when any of these properties 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 centre line,
+positive numbers displacing upwards, counting 1 for each line and
+space. The clefOctavation value would normally be set to 7, -7, 15 or
+-15, but other values are not invalid.
+
+
+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 in not required it can be suppressed by setting the
+explicitClefVisibility Staff property to the value  @code{
+end-of-line-invisible: \\set Staff.explicitClefVisibility =
+#end-of-line-invisible  } The default behaviour can be recovered with 
+@code{\\unset Staff.explicitClefVisibility}
+
+
+The following examples show the possibilities when setting these
+properties manually. On the first line, the manual changes preserve the
+standard relative positioning of clefs and notes, whereas on the second
+line, they do not. 
 " }
 
 {
-  \set Staff.clefGlyph = #"clefs.F"
-  \set Staff.clefPosition = #2
-  c'4
-  \set Staff.clefGlyph = #"clefs.G"
-  c'4
-  \set Staff.clefGlyph = #"clefs.C"
-  c'4
-  \set Staff.clefOctavation = #7
-  c'4
-  \set Staff.clefOctavation = #0
-  \set Staff.clefPosition = #0
-  c'4
-  \clef "bass"
-  c'4
-  \set Staff.middleCPosition = #4
-  c'4
-}
+           % The default treble clef
+           c'4
+           % The standard bass clef
+           \set Staff.clefGlyph = #"clefs.F"
+           \set Staff.clefPosition = #2
+           \set Staff.middleCPosition = #6
+           c'4
+           % The baritone clef
+           \set Staff.clefGlyph = #"clefs.C"
+           \set Staff.clefPosition = #4
+           \set Staff.middleCPosition = #4
+           c'4
+           % The standard choral tenor clef
+           \set Staff.clefGlyph = #"clefs.G"
+           \set Staff.clefPosition = #-2
+           \set Staff.clefOctavation = #-7
+           \set Staff.middleCPosition = #1
+           c'4
+           % A non-standard clef
+           \set Staff.clefPosition = #0
+           \set Staff.clefOctavation = #0
+           \set Staff.middleCPosition = #-4
+           c'4 \break
+
+           % The following clef changes do not preserve
+           % the normal relationship between notes and clefs:
 
+           \set Staff.clefGlyph = #"clefs.F"
+           \set Staff.clefPosition = #2
+           c'4
+           \set Staff.clefGlyph = #"clefs.G"
+           c'4
+           \set Staff.clefGlyph = #"clefs.C"
+           c'4
+           \set Staff.clefOctavation = #7
+           c'4
+           \set Staff.clefOctavation = #0
+           \set Staff.clefPosition = #0
+           c'4
+           \set Staff.middleCPosition = #4
+           c'4
+         }
index 90eb606cb1cdcbb121af4bc3d6ec3e883eabab6b..354ff14bdc9b521e25efe881448aaedb1a1c70b8 100644 (file)
@@ -5,26 +5,74 @@
 The command @code{\\clef \"treble_8\"} is equivalent to setting
 @code{clefGlyph}, @code{clefPosition} (which controls the Y position of
 the clef), @code{middleCPosition} and @code{clefOctavation}.  A clef is
-printed when any of these properties are changed.  The following
-example shows possibilities when setting properties manually. 
+printed when any of these properties 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 centre line,
+positive numbers displacing upwards, counting 1 for each line and
+space. The clefOctavation value would normally be set to 7, -7, 15 or
+-15, but other values are not invalid.
+
+
+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 in not required it can be suppressed by setting the
+explicitClefVisibility Staff property to the value  @code{
+end-of-line-invisible: \\set Staff.explicitClefVisibility =
+#end-of-line-invisible  } The default behaviour can be recovered with 
+@code{\\unset Staff.explicitClefVisibility}
+
+
+The following examples show the possibilities when setting these
+properties manually. On the first line, the manual changes preserve the
+standard relative positioning of clefs and notes, whereas on the second
+line, they do not. 
 " }
 
 {
-  \set Staff.clefGlyph = #"clefs.F"
-  \set Staff.clefPosition = #2
-  c'4
-  \set Staff.clefGlyph = #"clefs.G"
-  c'4
-  \set Staff.clefGlyph = #"clefs.C"
-  c'4
-  \set Staff.clefOctavation = #7
-  c'4
-  \set Staff.clefOctavation = #0
-  \set Staff.clefPosition = #0
-  c'4
-  \clef "bass"
-  c'4
-  \set Staff.middleCPosition = #4
-  c'4
-}
+           % The default treble clef
+           c'4
+           % The standard bass clef
+           \set Staff.clefGlyph = #"clefs.F"
+           \set Staff.clefPosition = #2
+           \set Staff.middleCPosition = #6
+           c'4
+           % The baritone clef
+           \set Staff.clefGlyph = #"clefs.C"
+           \set Staff.clefPosition = #4
+           \set Staff.middleCPosition = #4
+           c'4
+           % The standard choral tenor clef
+           \set Staff.clefGlyph = #"clefs.G"
+           \set Staff.clefPosition = #-2
+           \set Staff.clefOctavation = #-7
+           \set Staff.middleCPosition = #1
+           c'4
+           % A non-standard clef
+           \set Staff.clefPosition = #0
+           \set Staff.clefOctavation = #0
+           \set Staff.middleCPosition = #-4
+           c'4 \break
+
+           % The following clef changes do not preserve
+           % the normal relationship between notes and clefs:
 
+           \set Staff.clefGlyph = #"clefs.F"
+           \set Staff.clefPosition = #2
+           c'4
+           \set Staff.clefGlyph = #"clefs.G"
+           c'4
+           \set Staff.clefGlyph = #"clefs.C"
+           c'4
+           \set Staff.clefOctavation = #7
+           c'4
+           \set Staff.clefOctavation = #0
+           \set Staff.clefPosition = #0
+           c'4
+           \set Staff.middleCPosition = #4
+           c'4
+         }
index 90eb606cb1cdcbb121af4bc3d6ec3e883eabab6b..354ff14bdc9b521e25efe881448aaedb1a1c70b8 100644 (file)
@@ -5,26 +5,74 @@
 The command @code{\\clef \"treble_8\"} is equivalent to setting
 @code{clefGlyph}, @code{clefPosition} (which controls the Y position of
 the clef), @code{middleCPosition} and @code{clefOctavation}.  A clef is
-printed when any of these properties are changed.  The following
-example shows possibilities when setting properties manually. 
+printed when any of these properties 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 centre line,
+positive numbers displacing upwards, counting 1 for each line and
+space. The clefOctavation value would normally be set to 7, -7, 15 or
+-15, but other values are not invalid.
+
+
+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 in not required it can be suppressed by setting the
+explicitClefVisibility Staff property to the value  @code{
+end-of-line-invisible: \\set Staff.explicitClefVisibility =
+#end-of-line-invisible  } The default behaviour can be recovered with 
+@code{\\unset Staff.explicitClefVisibility}
+
+
+The following examples show the possibilities when setting these
+properties manually. On the first line, the manual changes preserve the
+standard relative positioning of clefs and notes, whereas on the second
+line, they do not. 
 " }
 
 {
-  \set Staff.clefGlyph = #"clefs.F"
-  \set Staff.clefPosition = #2
-  c'4
-  \set Staff.clefGlyph = #"clefs.G"
-  c'4
-  \set Staff.clefGlyph = #"clefs.C"
-  c'4
-  \set Staff.clefOctavation = #7
-  c'4
-  \set Staff.clefOctavation = #0
-  \set Staff.clefPosition = #0
-  c'4
-  \clef "bass"
-  c'4
-  \set Staff.middleCPosition = #4
-  c'4
-}
+           % The default treble clef
+           c'4
+           % The standard bass clef
+           \set Staff.clefGlyph = #"clefs.F"
+           \set Staff.clefPosition = #2
+           \set Staff.middleCPosition = #6
+           c'4
+           % The baritone clef
+           \set Staff.clefGlyph = #"clefs.C"
+           \set Staff.clefPosition = #4
+           \set Staff.middleCPosition = #4
+           c'4
+           % The standard choral tenor clef
+           \set Staff.clefGlyph = #"clefs.G"
+           \set Staff.clefPosition = #-2
+           \set Staff.clefOctavation = #-7
+           \set Staff.middleCPosition = #1
+           c'4
+           % A non-standard clef
+           \set Staff.clefPosition = #0
+           \set Staff.clefOctavation = #0
+           \set Staff.middleCPosition = #-4
+           c'4 \break
+
+           % The following clef changes do not preserve
+           % the normal relationship between notes and clefs:
 
+           \set Staff.clefGlyph = #"clefs.F"
+           \set Staff.clefPosition = #2
+           c'4
+           \set Staff.clefGlyph = #"clefs.G"
+           c'4
+           \set Staff.clefGlyph = #"clefs.C"
+           c'4
+           \set Staff.clefOctavation = #7
+           c'4
+           \set Staff.clefOctavation = #0
+           \set Staff.clefPosition = #0
+           c'4
+           \set Staff.middleCPosition = #4
+           c'4
+         }