Documentation/tex/lilypond-regtest.doc

   1 % -*-LaTeX-*-
   2 \documentclass{article}
   3
   4 \begin{document}
   5 \title{LilyPond feature test}
   6 \author{Han-Wen Nienhuys}
   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
  28 \section{Beams, slurs and other spanners}
  29
  30 %Beams should not interfere with various items on the staff (amongst
  31 %others repeat signs)
  32 %
  33 % \mud elafile{beam-repeat.ly}
  34
  35 Beams can be typeset over fixed distance aligned staffs, beam
  36 beautification doesn't really work, but knees do. Beams should be
  37 behave well, whereever the switching point is.
  38
  39 \mudelafile{beam-interstaff.ly}
  40
  41 The same goes for slurs. They behave decently when broken across
  42 linebreak.
  43
  44 \mudelafile{slur-interstaff.ly}
  45
  46 Tuplets are indicated by a bracket with a number.  There should be no
  47 bracket if there is one beam that matches  the length of the tuplet.
  48 The bracket does not interfere with the stafflines, and the number is
  49 centered in the gap in the bracket.
  50
  51 \mudelafile{tup.ly}
  52
  53 \section{Multiple notes}
  54
  55 Rests should not collide with beams, stems and noteheads.  Rests may
  56 be under beams.  Rests should be move by integral number of spaces
  57 inside the staff, and by half spaces outside.  Notice that the half
  58 and whole rests just outside the staff get ledger lines in different
  59 cases.
  60
  61
  62 \mudelafile{rest-collision.ly}
  63
  64 Normal collisions. We have limited support for four voice polyphony,
  65 where the middle voices are horizontally shifted, sometimes.
  66
  67 \mudelafile{collisions.ly}
  68
  69 The number of stafflines of a staff can be set with the property
  70 numberOfStaffLines.  Ledger lines both on note heads and rests are adjusted.
  71
  72 \mudelafile{number-staff-lines.fly}
  73
  74 \section{Global stuff}
  75
  76 Markings that are attached to (invisible) barlines are quite
  77 delicate: the are attached to the rest of the score without the score
  78 knowing it.  Consequently, they fall over quite often.
  79
  80 \mudelafile{bar-scripts.ly}
  81
  82
  83 \section{Clefs and Time Signatures}
  84
  85 For octaviated clefs, the ``8'' should appear closely above or below
  86 the clef respectively. The transparent clef should not occupy any space
  87 and with style \texttt{fullSizeChanges}, the changing clef should be
  88 typeset in full size.
  89
  90 \mudelafile{clefs.ly}
  91
  92 By default, time signatures are written with two numbers. With style
  93 ``C'', 4/4 and 2/2 are written with their corresponding symbols and
  94 with style ``old'', 2/2, 3/2, 3/4, 4/4, 6/4, 9/4, 6/8 and 9/8 are
  95 typeset with symbols, all other signatures retain the default layout.
  96 The style ``1'', gives single number signatures for all signatures.
  97
  98 \mudelafile{time.fly}
  99
 100 \end{document}