]> git.donarmstrong.com Git - lilypond.git/blob - NEWS.txt
add vcs lines to debian/control
[lilypond.git] / NEWS.txt
1 New features in 2.14 since 2.12
2 *******************************
3
4    * Lilypond now helps beams avoid collisions with other grobs!  This
5      feature works completely with manual beams.  It also works for all
6      automatic beams that do not end right before a change in staff.
7      For this special case, please use manual beams.
8
9    * The Articulate script by Peter Chubb, which is GPLv3 licensed, is
10      now a part of the distribution.  It allows easy generation of
11      improved MIDI files that perform non-legato by default, legato
12      slurs, staccato, tempo markings, trills, etc.
13
14           \include "articulate.ly"
15           \articulate <<
16                 all the rest of the score...
17           >>
18
19    * Single beat repeats for sixteenth or shorter notes and beat
20      repeats for measures containing notes of varying durations are now
21      supported.
22
23      [image of music]
24
25    * Lilypond now engraves woodwind fingering charts.
26
27      [image of music]
28
29    * MIDI output has been improved
30         * the option `\set Score.midiChannelMapping = #'voice' puts
31           each voice on its own midi MIDI channel
32
33         * the option `\set Score.midiChannelMapping = #'instrument'
34           puts identical instruments on the same MIDI channel.  This
35           means that e.g. for a full orchestral score there are always
36           16 (15 plus percussion) differently sounding instruments
37           available, unrestricted by the number of staves or voices.
38           (Some MIDI players will cut off notes, however, if two voices
39           play the same pitch simultaneously on the same channel.) This
40           option also stores each voice in a separate track in the MIDI
41           file.
42
43         * the default, `\set Score.midiChannelMapping = #'staff',
44           assigns one MIDI channel per staff.  This setting allows
45           instrument changes (implemented as MIDI program changes) to
46           re-use single MIDI channel.
47
48         * dynamics are now rendered as note velocities, no longer as
49           midi volume.  This improves the sound on [high end] midi
50           renderers.
51
52    * MIDI-import through Midi2ly is improved
53         * Midi2ly now also works on Windows systems
54
55         * MIDI-files with more than 32 tracks are now handled
56
57         * notes on certain simultaneous voices no longer ignored
58
59         * notes overrunning a bar line are no longer truncated
60
61         * initial key signature and time signature are respected
62
63         * a problem with octaves in subsequent tracks/voices is fixed
64
65         * initial support for multiple voices notated on one staff
66
67         * the instrumentName is set from track data
68
69         * new -skip option, rests are displayed by default
70
71         * rests overrunning a bar line are not truncated
72
73         * new -include-header option for setting titles
74
75         * new -preview option for big MIDI-files
76      The first feature was sponsored by Valentin Villenave, the other
77      features were sponsored by Image-Line Software for FL Studio.
78
79    * A new `Completion_rest_engraver' is available for automatically
80      converting long rests which overrun bar lines, matching the
81      `Completion_heads_engraver' for notes
82           \layout {
83             \context {
84               \Voice
85               \remove "Note_heads_engraver"
86               \consists "Completion_heads_engraver"
87               \remove "Rest_engraver"
88               \consists "Completion_rest_engraver"
89             }
90           }
91      This feature was sponsored by Image-Line Software for FL Studio.
92
93    * Dots can be added to the table of contents items using:
94           \paper {
95             tocItemMarkup = \tocItemWithDotsMarkup
96           }
97
98    * New markup commands `\pattern' and `\fill-with-pattern' are
99      available.  [image of music]
100
101    * A minimal composer toolkit of modal transformations is provided.
102      A motif may be transposed, inverted and/or converted to its
103      retrograde within any scale.
104
105      [image of music]
106
107    * Added minimal support for black mensural notation.
108
109    * Enhanced support for obliqua shapes within white mensural
110      ligatures.
111
112      [image of music]
113
114    * New markup functions `\with-link' and `\page-link' that add
115      hyperlinks to a given label or a given page number. This works in
116      the PDF backend only. All entries to the table of contents now
117      automatically add hyperlinks to the pages they are referring to.
118
119    * Compound time signatures are now supported by the `\compoundMeter'
120      command, which can be used instead of `\time':
121
122      [image of music]
123
124    * Lyrics above a staff must have their `staff-affinity' set to
125      `DOWN' or must have their `alignAboveContext' property set in
126      order to be properly aligned.  For more information, see *note
127      Placing lyrics vertically: (lilypond-notation)Placing lyrics
128      vertically.
129
130    * `stringTunings' property values have changed from a list of
131      semitones above middle C to a list of LilyPond pitch values.
132      convert-ly will handle the change automatically where the value of
133      `stringTunings' is set to a Scheme constant value.
134
135      New commands `makeStringTuning' and `contextStringTuning' allow
136      the creation of string tunings in the form of a Lilypond chord
137      construct.
138
139    * By using `\cueDuringWithClef', cue notes can now also have their
140      own clef, which is correctly reset at the end of the cue notes.
141      At the begin of each line, the standard clef is still displayed,
142      but the cue clef is shown after the time/key signature in smaller
143      size.
144
145      [image of music]
146
147    * Note names can be selected with a new `\language "italiano"'
148      command, which can be used in safe mode.  The old `\include
149      "italiano.ly"' syntax is still supported for now, but will be
150      deprecated in the future.
151
152    * autobeaming is now disabled by `\cadenzaOn' and enabled by
153      `\cadenzaOff'.  Beaming in cadenzas should be indicated manually.
154      Also, if a cadenza is used in a piece with autobeaming disabled, it
155      will need to be disabled again after the cadenza.
156
157    * The user is now able to specify the name of the predefined
158      fretboard table.  This allows the use of multiple tables, with
159      switching between them based on user input.
160
161    * The part-combiner's decision to combine/not combine notes can now
162      be customized
163
164           [image of music]
165
166
167    * Tablature staves show fret numbers only by default. To get the
168      former style, `\tabFullNotation' is provided.
169
170    * Funk-style and Walker-style shape notes have been added.
171
172    * Rests will no longer keep a staff alive if
173      `\RemoveEmptyStaffContext' is used.
174
175    * New option `-dinclude-settings=INCLUDEFILE.ly', which causes
176      lilypond to include the given file before the score is processed.
177      This allows the user to change global settings without the need to
178      change the score itself.  That way, several different
179      editions/version (e.g. different page sizes) can be generated from
180      a file without having to modify the score for each version.
181
182    * The autobeaming settings syntax has been changed.  beatLength,
183      beatGrouping, beamSettings, and measureGrouping have all been
184      eliminated.  Autobeaming is now controlled by baseMoment,
185      beatStructure, and beamExceptions.  Default settings for each of
186      these properties can be stored for any time signature in
187      time-signature-settings, so that when the time signature is
188      changed, the autobeaming will automatically change.  The new
189      syntax should be much easier and require fewer overrides.
190
191    * The SVG backend has optional support for WOFF fonts
192      (http://www.w3.org/Submission/WOFF).  Using the Scheme option `-d
193      svg-woff' together with the SVG backend selection `-d
194      backend=svg', produces SVG output with CSS WOFF font selection.
195
196    * The LilyPond G clef has been rotated 1.5 degrees clockwise for
197      improved balance.  The old and new versions can be compared by
198      looking at the documentation: old version
199      (http://lilypond.org/doc/v2.12/Documentation/user/lilypond/The-Feta-font.html#Clef-glyphs),
200      new version
201      (http://lilypond.org/doc/v2.14/Documentation/notation/the-feta-font.html#Clef-glyphs).
202
203    * Text crescendo spanners can now be added directly using `\cresc',
204      `\dim' and `\decresc'.
205
206           [image of music]
207
208
209    * The documented syntax of `lilypond' environments in the LaTeX mode
210      of `lilypond-book' has been changed to conform with standard LaTeX
211      syntax: options now come after the environment name:
212           \begin{lilypond}[OPTIONS] ...
213
214      The previous syntax with options after `\begin' is still accepted
215      by `lilypond-book' but deprecated.  Something like
216           sed -i '/begin\[/s/begin\(\[[^]]*]\)\({lilypond}\)/begin\2\1/'
217
218      might do the trick for conversion.
219
220    * Aesthetics of shape note heads have been enhanced.  Variable line
221      thicknesses have been implemented.  All note widths have been made
222      consistent.  Minor shape note commands that use the relative major
223      key for scale steps have been added.
224
225    * A variant of the Segno sign is provided:
226
227           [image of music]
228
229
230    * Context modifications (`\with' blocks) can be stored in variables
231      and inserted into contexts or other `\with' blocks:
232
233           coloredheads = \with { \override NoteHead #'color = #red }
234           noclef = \with { \remove "Clef_engraver" }
235           \score {
236             \new Staff {
237               \new Voice \with { \coloredheads } \relative c' { c4 e g c }
238             }
239             \layout {
240               \context {
241                 \Staff
242                 \noclef
243               }
244             }
245           }
246            [image of music]
247
248
249    * A half-open articulation was added:
250
251           [image of music]
252
253
254      This is sometimes used to indicate half-open hi-hats.
255
256    * The Unicode Bidirectional Algorithm is now fully supported for
257      single-line markup due to enhanced integration with Pango.
258
259    * LilyPond is now licensed under the GNU GPL v3+.
260
261    * In tablature, frets can be indicated with labels other than
262      numbers:
263
264           \new TabStaff
265           \with {
266             stringTunings = #`(,(ly:make-pitch 1 3 NATURAL)
267                                ,(ly:make-pitch 1 1 NATURAL)
268                              ,(ly:make-pitch 0 5 NATURAL)
269                              ,(ly:make-pitch 0 3 NATURAL)
270                              ,(ly:make-pitch 0 1 NATURAL)
271                              ,(ly:make-pitch -1 5 NATURAL))
272             tablatureFormat = #fret-letter-tablature-format
273           }
274           \new TabVoice {
275             \set fretLabels = #`(,(markup #:with-color red "a")
276                                  "b"
277                                  ,(markup #:italic #:smaller "c"))
278             <f d>4. <bes>8 <g e>4
279           }
280            [image of music]
281
282
283    * Layout objects can be printed over a white background, which
284      whites-out objects in lower layers which lie beneath:
285
286           \time 3/4
287           \override Staff.StaffSymbol #'layer = #4
288           \once \override Tie #'layer = #2
289           b'2.~
290           \once \override Staff.TimeSignature #'whiteout = ##t
291           \once \override Staff.TimeSignature #'layer = #3
292           \time 5/4
293           b4
294            [image of music]
295
296
297    * Chords can be repeated using the `q' shortcut:
298
299           <c e g>8.-^ q16 q4-^
300            [image of music]
301
302
303    * With two-sided mode, margins for odd and even pages can be set
304      using `inner-margin' and `outer-margin':
305
306      \paper {
307        two-sided = ##t
308        inner-margin = 10 \mm
309        outer-margin = 20 \mm
310      }
311
312    * Paper margin defaults, as specified in
313      `ly/paper-defaults-init.ly', apply to the default paper size (a4)
314      and are automatically scaled according to the paper size chosen.
315
316    * All combinations of `left-margin', `right-margin' and `line-width'
317      work now.  There is no more need to set `line-width' manually
318      unless you explicitly want to.
319
320    * Support for using an alternative music font, such as Gonville, is
321      now added.
322
323    * In addition to the existing `\hspace' markup command, a new
324      `\vspace' command has been added to provide an easy and flexible
325      way to add vertical space in markups.
326
327    * The direction of manual beams can be set with `^[' and `_['.
328
329    * A version of the breve note head has been added with two vertical
330      lines on each side.
331
332           [image of music]
333
334
335    * Instrument names and vocal names now take into account the extent
336      of system start delimiters in other staves for their positioning,
337      resulting in improved default alignment for left-, center- and
338      right-aligned names.
339
340           [image of music]
341
342
343    * Braces in markup can now be selected by point size using the
344      markup commands `\left-brace' and `\right-brace'.
345
346           [image of music]
347
348
349    * Intermediate .ps files which are created by LilyPond during
350      compilation are now deleted by default.  To keep them, add the
351      following line to your input files:
352      #(ly:set-option 'delete-intermediate-files #f)
353
354    * Dashed and dotted slurs, phrasing slurs, and ties have been made
355      variable thickness, and partially dashed slurs are now available:
356
357           [image of music]
358
359
360    * An eyeglasses markup was added, indicating strongly to look at the
361      conductor for instructions:
362
363           [image of music]
364
365
366    * A snap-pizzicato (also known as Bartok-pizzicato) articulation was
367      added:
368
369           [image of music]
370
371
372    * Tuplet number formatting functions are now available to print
373      other fractions and to add notes to the number or fraction:
374
375           [image of music]
376
377
378    * FretBoards now have a chordChanges property to keep repeated
379      FretBoard objects from being typeset.
380
381    * The vertical spacing engine has been drastically changed, making
382      it more flexible and easier to control.  The spacing between
383      staves within a system can now change to better use the space on
384      the page.  User-defined contexts may participate in this flexible
385      spacing, depending on how their `staff-affinity' is defined.  Some
386      page formatting variables (`page-top-space', `between-system-space
387      -padding', and `before- between- after-title-space') have been
388      replaced by flexible vertical dimensions.
389
390
391
392 \1f
393 Local Variables:
394 coding: utf-8
395 End: