ly/params.ly

   1 % params.ly
   2 % generic paper parameters
   3
   4 %{
   5
   6 TODO:
   7
   8 * cleanup
   9 * use elt properties, iso. paper variables.
  10 %}
  11
  12
  13
  14 paperfile = \papersize + ".ly";
  15 % paperfile = "a4.ly";
  16 \include \paperfile;
  17 \include "paper.ly";
  18
  19 staffspace = \staffheight / 4.0;
  20 stafflinethickness = \staffspace / 10.0;
  21
  22 % deprecated
  23 interline = \staffspace;
  24
  25 %{
  26 The space taken by a note is determined by the formula
  27
  28    SPACE = arithmetic_multiplier * ( C + log2 (TIME) ))
  29
  30 where TIME is the amount of time a note occupies.  The value of C is
  31 chosen such that the smallest space within a measure is
  32 arithmetic_basicspace:
  33
  34   C = arithmetic_basicspace - log2 (mininum (SHORTEST, 1/8))
  35
  36 The smallest space is the one following the shortest note in the
  37 measure, or the space following a hypothetical 1/8 note.  Typically
  38 arithmetic_basicspace is set to a value so that the shortest note
  39 takes about two noteheads of space (ie, is followed by a notehead of
  40 space):
  41
  42    2*quartwidth = arithmetic_multiplier * ( C + log2 (SHORTEST) ))
  43
  44    { using: C = arithmetic_basicspace - log2 (mininum (SHORTEST, 1/8)) }
  45    { assuming: SHORTEST <= 1/8 }
  46
  47                = arithmetic_multiplier *
  48                ( arithmetic_basicspace - log2 (SHORTEST) + log2 (SHORTEST) )
  49
  50                = arithmetic_multiplier * arithmetic_basicspace
  51
  52    { choose: arithmetic_multiplier = 1.0*quartwidth (why?)}
  53
  54                = quartwidth * arithmetic_basicspace
  55
  56    =>
  57
  58    arithmetic_basicspace = 2/1 = 2
  59
  60 If you want to space your music wider, use something like:
  61
  62    arithmetic_basicspace = 4.;
  63
  64 %}
  65 % We use 0.9*\quartwidth, because 1.0 seems to wide.
  66 % quartwidth == 1.32 * staffspace
  67 % We don't adjust arithmetic_basicspace accordingly (why not?)
  68 arithmetic_multiplier = 0.9 * 1.32 * \staffspace ;
  69 arithmetic_basicspace = 2.0;
  70
  71
  72 %
  73 % UGH; junk these!
  74 %
  75
  76 % catch suspect beam slopes, set slope to zero if
  77 % outer stem is lengthened more than
  78 beam_lengthened = 0.2 * \staffspace;
  79 % and slope is running away steeper than
  80 beam_steep_slope = 0.2 / 1.0;
  81
  82
  83
  84 %{
  85   Slur parameters.
  86
  87   See Documentation/programmer/fonts.doc
  88
  89   TODO: -> elt-properties.
  90 %}
  91 % Height-limit (h_inf) = factor * staff_space
  92 slur_height_limit_factor = 2.0;
  93 slur_ratio = 1.0 / 3.0;
  94
  95 slur_thickness = 1.2 * \stafflinethickness;
  96
  97 slur_force_blowfit = 0.5;
  98 slur_beautiful = 0.5;
  99
 100
 101 %{
 102 Horizontal space between centre of notehead and slur.
 103 %}
 104 % OSU: suggested gap = ss / 5;
 105 slur_x_gap = \staffspace / 5.0;
 106 slur_y_gap = 0.25 * \staffspace;
 107 slur_y_free = 0.75 * \staffspace;
 108 slur_x_minimum = 1.5 * \staffspace;
 109
 110 % URG: the magic constants for area asymmetry
 111 bezier_pct_c0 = -0.2;
 112 bezier_pct_c3 = 0.000006;
 113 bezier_pct_out_max = 0.8;
 114 bezier_pct_in_max = 1.2;
 115 bezier_area_steps = 1.0;
 116
 117
 118 %{
 119   Tie parameters
 120 %}
 121
 122 tie_height_limit_factor = 1.0 ;
 123 tie_ratio = \slur_ratio;
 124
 125 % OSU: tie gap == slur gap
 126 tie_x_gap = 0.2 * \staffspace;
 127 tie_staffline_clearance = 2.0 *\slur_thickness;
 128
 129 % vertical space between lines of text.
 130 line_kern = \staffspace;
 131
 132 % chop off this much when next to pp / ff sign.
 133 crescendo_shorten = 4.0 * \staffspace;
 134 crescendo_thickness   = \stafflinethickness;
 135 crescendo_height = 0.666 * \staffspace;
 136 crescendo_dash_thickness = 1.2*\stafflinethickness;
 137 crescendo_dash = 4.0*\staffspace;
 138
 139
 140 % optical correction amount.
 141 stemSpacingCorrection = 0.5*\staffspace;
 142
 143
 144 %{
 145  relative strength of space following breakable columns (eg. prefatory matter)
 146  %}
 147 breakable_column_space_strength = 2.0;
 148
 149 % space after inline clefs and such get this much stretched
 150 decrease_nonmus_spacing_factor = 1.0 ;
 151
 152 %{
 153  space before musical columns (eg. taken by accidentals) get this much
 154  stretched when they follow a musical column, in absence of grace notes.
 155
 156  0.0 means no extra space (accidentals are ignored)
 157 %}
 158 musical_to_musical_left_spacing_factor = 0.4;
 159
 160 %{
 161  stretch space this much if there are grace notes before the column
 162 %}
 163 before_grace_spacing_factor = 1.2;
 164
 165 %{
 166 If columns do not have spacing information set, set it to this much
 167 %}
 168 loose_column_distance = 2.0 * \staffspace;
 169
 170 %{
 171 Relative cost of compressing (vs. stretching).  Increasing this
 172 will cause scores to be set looser
 173 .
 174 %}
 175
 176 compression_energy_factor = 0.6;
 177
 178
 179
 180 \include "engraver.ly";
 181
 182
 183
 184
 185