Documentation/tex/lilypond-regtest.doc

   1 % -*-LaTeX-*-
   2 \documentclass{article}
   3
   4 \title{LilyPond feature test}
   5 \author{Han-Wen Nienhuys}
   6 \begin{document}
   7 \maketitle
   8
   9 This document tries give an brief overview of LilyPond features. When
  10 the text correspond with the shown notation, we consider LilyPond
  11 Officially BugFree (tm).
  12
  13 \section{Notes and rests}
  14
  15 Rests.  Note that the dot of 8th, 16th and 32nd rests rest should be
  16 next to the top of the rest.  All rests except the whole rest are
  17 centered on the middle staff line.
  18
  19 \mudelafile{rest.fly}
  20
  21 Note head shapes are settable.  The stem endings should be adjusted
  22 per note head.  If you want different note head styles on one stem,
  23 you must create a special context called Thread.
  24
  25 \mudelafile{noteheadstyle.ly}
  26
  27 Multiple measure rests do not collide with barlines and clefs.  They
  28 are not expanded when you set Score.SkipBars
  29
  30 \mudelafile{multi-measure-rest.ly}
  31
  32 \section{Stems}
  33
  34 Stem tremolos (official naming?) or rolls are tremolo signs that look
  35 like beam segments crossing stems.  If the stem is in a beam, the
  36 tremolo must be parallel to the beam.  If the stem is invisible
  37 (eg. on a whole note), the tremolo must be centered on the note.
  38
  39 \mudelafile{stem-tremolo.ly}
  40
  41
  42 \section{Beams, slurs and other spanners}
  43
  44 %Beams should not interfere with various items on the staff (amongst
  45 %others repeat signs)
  46 %
  47 % \mud elafile{beam-repeat.ly}
  48
  49 Beams can be typeset over fixed distance aligned staffs, beam
  50 beautification doesn't really work, but knees do. Beams should be
  51 behave well, whereever the switching point is.
  52
  53 \mudelafile{beam-interstaff.ly}
  54
  55 The same goes for slurs. They behave decently when broken across
  56 linebreak.
  57
  58 \mudelafile{slur-interstaff.ly}
  59
  60 Tuplets are indicated by a bracket with a number.  There should be no
  61 bracket if there is one beam that matches  the length of the tuplet.
  62 The bracket does not interfere with the stafflines, and the number is
  63 centered in the gap in the bracket.
  64
  65 \mudelafile{tup.ly}
  66
  67 \section{Multiple notes}
  68
  69 Rests should not collide with beams, stems and noteheads.  Rests may
  70 be under beams.  Rests should be move by integral number of spaces
  71 inside the staff, and by half spaces outside.  Notice that the half
  72 and whole rests just outside the staff get ledger lines in different
  73 cases.
  74
  75
  76 \mudelafile{rest-collision.ly}
  77
  78 Normal collisions. We have support for four voice polyphony, where the
  79 middle voices are horizontally shifted in a limited number of cases.
  80
  81 \mudelafile{collisions.ly}
  82
  83 The number of stafflines of a staff can be set with the property
  84 numberOfStaffLines.  Ledger lines both on note heads and rests are adjusted.
  85
  86 \mudelafile{number-staff-lines.fly}
  87
  88 \section{Spacing}
  89
  90 In a limited number of cases, LilyPond corrects for optical spacing
  91 effects.  In this example, space for opposite pointed stems is adjusted
  92
  93 \mudelafile{stem-spacing.sly}
  94
  95 \section{Global stuff}
  96
  97 Markings that are attached to (invisible) barlines are
  98 delicate: the are attached to the rest of the score without the score
  99 knowing it.  Consequently, they fall over  often.
 100
 101 \mudelafile{bar-scripts.ly}
 102
 103 Staff margins are also markings attached to barlines.  They should be
 104 left otf the staff, and be centered vertically wrt the staff.  They
 105 may be on normal staffs, but also on compound staffs, like the
 106 PianoStaff
 107
 108 \mudelafile{staff-margin.ly}
 109
 110
 111 \section{Clefs and Time Signatures}
 112
 113 The transparent clef should not occupy any space and with style
 114 \texttt{fullSizeChanges}, the changing clef should be typeset in full
 115 size. For octaviated clefs, the ``8'' should appear closely above or
 116 below the clef respectively.  The ``8'' is processed in a rather
 117 convoluted way, so this is fragile as well.
 118
 119 \mudelafile{clefs.ly}
 120
 121 By default, time signatures are written with two numbers. With style
 122 ``C'', 4/4 and 2/2 are written with their corresponding symbols and
 123 with style ``old'', 2/2, 3/2, 3/4, 4/4, 6/4, 9/4, 6/8 and 9/8 are
 124 typeset with symbols, all other signatures retain the default layout.
 125 The style ``1'', gives single number signatures for all signatures.
 126
 127 \mudelafile{time.fly}
 128
 129 \end{document}