input/lsr/clefs-commonly-tweaked-properties.ly

   1 %% Do not edit this file; it is auto-generated from LSR http://lsr.dsi.unimi.it
   2 %% This file is in the public domain.
   3 \version "2.11.38"
   4
   5 \header {
   6   lsrtags = "pitches, staff-notation, editorial-and-educational-use, tweaks-and-overrides"
   7  texidoc = "
   8 The command @code{\\clef \"treble_8\"} is equivalent to setting
   9 @code{clefGlyph}, @code{clefPosition} (which controls the Y-position of
  10 the clef), @code{middleCPosition} and @code{clefOctavation}. A clef is
  11 printed when any of these properties are changed.
  12
  13
  14 Note that changing the glyph, the position of the clef, or the
  15 octavation, does not in itself change the position of subsequent notes
  16 on the staff: the position of middle C must also be specified to do
  17 this. The positional parameters are relative to the staff centre line,
  18 positive numbers displacing upwards, counting 1 for each line and
  19 space. The @code{clefOctavation} value would normally be set to 7, -7,
  20 15 or -15, but other values are valid.
  21
  22
  23 When a clef change takes place at a line break the new clef symbol is
  24 printed at both the end of the previous line and the beginning of the
  25 new line by default. If the warning clef at the end of the previous
  26 line is not required it can be suppressed by setting the @code{Staff}
  27 property @code{explicitClefVisibility} to the value
  28 @code{end-of-line-invisible}. The default behaviour can be recovered
  29 with  @code{\\unset Staff.explicitClefVisibility}.
  30
  31 The following examples show the possibilities when setting these
  32 properties manually. On the first line, the manual changes preserve the
  33 standard relative positioning of clefs and notes, whereas on the second
  34 line, they do not.
  35 " }
  36 % begin verbatim
  37 {
  38   % The default treble clef
  39   c'1
  40   % The standard bass clef
  41   \set Staff.clefGlyph = #"clefs.F"
  42   \set Staff.clefPosition = #2
  43   \set Staff.middleCPosition = #6
  44   c'
  45   % The baritone clef
  46   \set Staff.clefGlyph = #"clefs.C"
  47   \set Staff.clefPosition = #4
  48   \set Staff.middleCPosition = #4
  49   c'
  50   % The standard choral tenor clef
  51   \set Staff.clefGlyph = #"clefs.G"
  52   \set Staff.clefPosition = #-2
  53   \set Staff.clefOctavation = #-7
  54   \set Staff.middleCPosition = #1
  55   c'
  56   % A non-standard clef
  57   \set Staff.clefPosition = #0
  58   \set Staff.clefOctavation = #0
  59   \set Staff.middleCPosition = #-4
  60   c' \break
  61
  62   % The following clef changes do not preserve
  63   % the normal relationship between notes and clefs:
  64
  65   \set Staff.clefGlyph = #"clefs.F"
  66   \set Staff.clefPosition = #2
  67   c'
  68   \set Staff.clefGlyph = #"clefs.G"
  69   c'
  70   \set Staff.clefGlyph = #"clefs.C"
  71   c'
  72   \set Staff.clefOctavation = #7
  73   c'
  74   \set Staff.clefOctavation = #0
  75   \set Staff.clefPosition = #0
  76   c'
  77
  78   % Here we go back to the normal clef:
  79
  80   \set Staff.middleCPosition = #4
  81   c'
  82 }