Documentation/relative-octaves.pod

   1 =head1 NAME
   2
   3 Octaves --  how to do pitches
   4
   5 =head1 DESCRIPTION
   6
   7 The LilyPond input language, Mudela (help, silly name), should be easy
   8 to read and write.  In my experience Mudela is already quite convenient
   9 for entering music.  Every time i've entered a substantial piece of music,
  10 however, i found that i made quite a few mistakes.  The MIDI output helps
  11 a lot with locating and correcting the errors.  There's one type of error
  12 that seems to be frequent, stubborn and hard to catch, and that's the
  13 octavation error.  The relative octave feature is an attempt to make
  14 Mudela a bit easier to write.  In addition, this featuer makes it harder
  15 to make octavation mistakes, yet if you made one, its a lot simpler to find
  16 and correct.
  17
  18 Here's how it works.
  19
  20 =over 5
  21
  22 =item *
  23 forget the old "\octave c';" command
  24
  25 =item *
  26 forget the old octave boundaries with octaves c .. c'
  27
  28 =back
  29
  30 You start the relative octave mode (for now) with the command
  31
  32     \octave relative;
  33
  34 From then on, the pitch of a note will be the closest to the last one,
  35 assuming that large intervals are a lot more rare than small ones.
  36 Thus, you can enter a scale without using octavation quotes:
  37
  38     c d e f g a b c
  39
  40 the last c being an octave higher than the first.  If you have to
  41 enter an interval that is greater than a quart, you must specify
  42 whether the pitch goes up, using post-quotes:
  43
  44     c c' % octave up
  45     c g' % quart up
  46
  47 or down, using pre-quotes:
  48
  49     c 'c % octave down
  50     c 'f % quart down
  51
  52 Although it is not necesary, and thus redundant, information to specify
  53 the direction of smaller intervals, you are allowed to do so:
  54
  55     c d  % second up
  56     c d' % second up
  57
  58     c a  % third down
  59     c 'a % third down
  60
  61
  62 =head1 CONVERTING
  63
  64 To convert a piece of music from the old absolute-octave notation to
  65 relative octaves, lilypond provides the B<-f, --find-quarters> feature
  66 to locate all big intervals in your music (sorry, fully automated convert
  67 is too complex).
  68
  69 You'll do something like this:
  70
  71     lilypond -f los-toros-oboe 2>&1 | tee intervals
  72     ...
  73     los-toros-oboe.ly: 59: warning: Interval greater than quart, relative: d':
  74         [)g8  r d
  75                  '] r |
  76     los-toros-oboe.ly: 100: warning: Interval bigger than quart, relative: d':
  77         [d8 d
  78              '] [es'8.-> c'16] |
  79     ...
  80
  81 Then you load a copy of the original mudela file in your favourite editor,
  82 and let it parse the 'error file' F<intervals>.  First you remove all
  83 octavation quotes.  Then, jumping from warning to warning, you enter quotes
  84 as suggested by LilyPond.
  85
  86 =head1 EXAMPLE
  87
  88 See F<mutopia/ltor.ly>.