From 8b6039267311f944ce5680ddf217130de6608dcc Mon Sep 17 00:00:00 2001 From: Graham Percival Date: Fri, 7 Dec 2007 19:24:20 -0800 Subject: [PATCH] LSR: more commonprop moved to lsr. --- Documentation/user/pitches.itely | 83 +----------------- .../clefs-commonly-tweaked-properties.ly | 86 +++++++++++++++---- .../clefs-commonly-tweaked-properties.ly | 86 +++++++++++++++---- .../clefs-commonly-tweaked-properties.ly | 86 +++++++++++++++---- 4 files changed, 202 insertions(+), 139 deletions(-) diff --git a/Documentation/user/pitches.itely b/Documentation/user/pitches.itely index 57369e59b0..b06b466a73 100644 --- a/Documentation/user/pitches.itely +++ b/Documentation/user/pitches.itely @@ -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 diff --git a/input/lsr/editorial/clefs-commonly-tweaked-properties.ly b/input/lsr/editorial/clefs-commonly-tweaked-properties.ly index 90eb606cb1..354ff14bdc 100644 --- a/input/lsr/editorial/clefs-commonly-tweaked-properties.ly +++ b/input/lsr/editorial/clefs-commonly-tweaked-properties.ly @@ -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 + } diff --git a/input/lsr/pitches/clefs-commonly-tweaked-properties.ly b/input/lsr/pitches/clefs-commonly-tweaked-properties.ly index 90eb606cb1..354ff14bdc 100644 --- a/input/lsr/pitches/clefs-commonly-tweaked-properties.ly +++ b/input/lsr/pitches/clefs-commonly-tweaked-properties.ly @@ -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 + } diff --git a/input/lsr/staff/clefs-commonly-tweaked-properties.ly b/input/lsr/staff/clefs-commonly-tweaked-properties.ly index 90eb606cb1..354ff14bdc 100644 --- a/input/lsr/staff/clefs-commonly-tweaked-properties.ly +++ b/input/lsr/staff/clefs-commonly-tweaked-properties.ly @@ -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 + } -- 2.39.5