Documentation/user/introduction.itely

   1 @node Introduction
   2 @chapter Introduction
   3
   4 LilyPond is a free program that produces high quality sheet music.
   5
   6 The features that set LilyPond apart from other music printing
   7 programs are
   8
   9 @itemize
  10 @item Freely available under terms of the GNU GPL
  11 @item Carefully designed music font
  12 @item Lots of music formatting knowledge
  13 @item Sophisticated formatting functions
  14 @item Output is  configurable using Scheme
  15 @item Highly modular design
  16 @item Semantic input format
  17 @item Input can be generated, inspected and modified via builtin Scheme
  18  interpreter.
  19 @item Runs on both Unix and MS Windows
  20 @item Multiple output formats
  21 @item Easily embed musical fragments in LaTeX, Texinfo and HTML documents.
  22 @item Works as a compiler: edit input in your favorite text editor
  23 @end itemize
  24
  25 If you need to print out existing arrangements, composition, new
  26 editions, or musical excercises, then LilyPond will suit you.
  27 LilyPond is not interactive, and is probably not suited for creating
  28 new compositions.
  29
  30 @menu
  31 * Why LilyPond::
  32 * The Feta Font::
  33 * Engraving::
  34 * Semantic input format::
  35 * A programming approach::
  36 * About this manual::
  37 @end menu
  38
  39 @node Why LilyPond
  40 @section Why LilyPond
  41
  42 LilyPond originally started out as an interesting hobby
  43 project. Intrigued by music notation we set out to write a program to
  44 produce high-quality music printouts, with minimal user intervention.
  45
  46 Engraving, the art of printing music is a very complex craftmanship,
  47 that tries to make a typographically beautiful rendering of a piece of
  48 music.  The purpose of nicely engraved music is to ease the way music
  49 is read.  The typographical decisions have underlying logic, and to us
  50 scientists, this begs the question: what is this logic, and can we
  51 cast this logic into the more concrete form a computer program.
  52
  53 LilyPond is our concrete answer to this question, but besides being an
  54 interesting hobby project, it also allows people that don't know much
  55 about notation and engraving to print fine sheet music.
  56
  57 With LilyPond, we hope to give back a little to the Free Software
  58 Community that gave us so much, and if possible, give people the
  59 opportunity to publish sheet music with high quality layout.  In our
  60 utopic vision, some day LilyPond will help create more beautiful music.
  61
  62 @node  The Feta Font
  63 @section The Feta Font
  64
  65
  66 Most of the rules concerning music symbols have not been explicitly
  67 laid down, so we have imitated the looks of symbols in beautiful hand
  68 engraved music. The starting point was to have a strong, bold look,
  69 with rounded symbol shapes, just like traditional engraving.
  70
  71 @iftex
  72   {\font\fet=feta20 at 100pt
  73   \fet\fetaquartrest\hskip 1cm\fetahalfhead\hskip 1cm\fetaflat}
  74 @end iftex
  75
  76 In the figure above, a few notable glyphs are shown. For example, in
  77 most music the half-notehead is not elliptic but diamond shaped.  The
  78 stem of a flat symbol should be slightly brushed, i.e. becoming wider
  79 at the top. Fine endings, such as the one on the bottom of the quarter
  80 rest, should not end in sharp points, but rather in rounded shapes.
  81
  82 Finally, the blackness of the font is carefully tuned to give a strong
  83 and dark visual impression. Many computer music fonts are rather
  84 light, leading to anemic look when they are printed.
  85
  86 Although such details are not directly visible to the untrained eye,
  87 careful attention to such details gives lilypond output a more
  88 balanced appearance.  We believe that the Feta font is among the most
  89 elegant music font designs available today.
  90
  91 The Feta font was implemented in the font design system METAFONT. The
  92 source code includes numerous comments on the specific design
  93 considerations of each glyph. PostScript Type1 versions of the font
  94 are also available.
  95
  96 @node Engraving
  97 @section Engraving
  98
  99
 100 Music engraving used to be a craft requiring many years of training.
 101 In the old days, sheet music was made by cutting and stamping the
 102 music mirrored into zinc or pewter plates. The plate would be inked,
 103 and the depressions caused by the cutting and stamping would hold ink
 104 thus forming an positive image.
 105
 106 Of all craftmanships, engraving was the most difficult to learn trade;
 107 completing the basic training took as long as six years.
 108 Unfortunately, little of this knowledge comes to us as explicitly
 109 formulated rules.
 110
 111 The only books that specifically deal with music typography are the
 112 books by Ross, Wanske and Hader @cite{hader48,ross,wanske}, and we
 113 have found that are often lacking in detail. Of course, in order to
 114 accurately computerize a process, one has to have a very detailed
 115 description of what must be done.
 116
 117 @lilypond
 118     \score { \notes {
 119       c'4 e''4 e'4 b'4 |
 120       \property Staff.NoteSpacing \override #'stem-spacing-correction
 121       = #0.0
 122       \property Staff.StaffSpacing \override #'stem-spacing-correction
 123       = #0.0
 124       c'4 e''4 e'4 b'4 |
 125     }
 126     \paper { linewidth = -1. } }
 127 @end lilypond
 128
 129 @node Semantic input format
 130 @section Semantic input format
 131
 132 One the key points of LilyPond, is that the input is musical: what you
 133 put into the program are musical concepts, such as pitches, durations,
 134 voices, etc.  The program then interprets these concepts, and produces
 135 graphic output: glyphs, curves, offsets.  In this way the program
 136 tries to act like an engraver.
 137
 138
 139 If you only want to print music, this might not interest you so much,
 140 except for the fact that it means you don't have to worry much about
 141 formatting details.
 142
 143
 144 Many music encodings exist today @cite{selfridge-field97:beyond-midi},
 145 but most of the encodings have not been tailored either for human use,
 146 or for processing it with a computer.  By its nature, LilyPond input
 147 has both features: it is concise, suitable for human input, and it can
 148 be processed automatically: it may be converted into MIDI or into print.
 149
 150
 151 However, one big problem with music, is that there are no standards
 152 for encoding music. Sure, you can record performances using MIDI, but
 153 that offers far too little information for adequate musicological
 154 purposes. With LilyPond we've taken a reverse approach: we have tried
 155 to come up with musical format that can cater virtually all music as
 156 long as it can be notated.
 157
 158 LilyPond input focuses on musical concepts such as pitch, duration and
 159 music expressions.  Musical data is rhythmic, and implies an ordering
 160 of events. This ordering is used to create compound musical concepts:
 161 Large musical structures are built recursively from smaller
 162 expressions: a sequence of music expressions forms a new, longer and
 163 bigger music expression. In this sense, the input is recursive. It
 164 shares this property with very music encodings. The recursive nature
 165 will appeal to the more hackerish musician.
 166
 167
 168 @node A programming approach
 169 @section A programming approach
 170
 171 blabla
 172
 173 @node  About this manual
 174 @section About this manual
 175
 176 blabla
 177