-New features in 2.12 since 2.10
+New features in 2.20 since 2.18
*******************************
- * Fret diagrams can now have variable string thickness:
-
- [image of music]
-
-
- * A new fret diagram orientation, opposing-landscape, is available:
-
- [image of music]
-
-
- * Unbeamed 128th notes are now supported:
-
- [image of music]
-
-
- * Extending LilyPond's existing support for microtones, there are
- now arrowed accidentals for the notation of microtonal alterations.
- To use them, redefine the `glyph-name-alist' property of
- `Accidental' as in the following example which uses quartertones
- to typeset arrowed accidentals. Alternatively, it is possible to
- define separate names for all notes with arrowed accidentals (see
- `ly/makam.ly' for boilerplate code).
-
- [image of music]
-
-
- * Straight flags (used in old scores of e.g. Bach, but also in
- different form in modern scores of e.g. Stockhausen) are now
- implemented:
-
- [image of music]
-
-
- * `\bookpart' blocks may be used to split a book into several parts,
- separated by a page break, in order to ease the page breaking, or
- to use different `\paper' settings in different parts.
-
- \bookpart {
- \header {
- title = "Book title"
- subtitle = "First part"
+ * Blocks introduced with `\header' can be stored in variables and
+ used as arguments to music and scheme functions and as the body of
+ `#{...#}' constructs. They are represented as a Guile module.
+
+ While `\book', `\bookpart', `\score', `\with', `\layout', `\midi',
+ `\paper' blocks can be passed around in similar manner, they are
+ represented by different data types.
+
+ * Dot-separated symbol lists like `FretBoard.stencil' were already
+ supported as of version 2.18. They may now also contain unsigned
+ integers, and may alternatively be separated by commata. This
+ allows usage such as
+
+ { \time 2,2,1 5/8 g'8 8 8 8 8 }
+ [image of music]
+
+
+ and
+ \tagGroup violin,oboe,bassoon
+
+ * Such lists may also be used in expressions for assignments, sets,
+ and overrides. This allows usage such as
+
+ { \unset Timing.beamExceptions
+ \set Timing.beatStructure = 1,2,1
+ g'8 8 8 8 8 8 8 8 }
+ [image of music]
+
+
+ * Association list elements could previously be assigned values
+ individually (for example, paper variables like
+ `system-system-spacing.basic-distance'). They may now be also
+ referenced in this manner, as with
+ \paper {
+ \void \displayScheme \system-system-spacing.basic-distance
+ }
+
+ In combination with the previously mentioned changes, this allows
+ setting and referencing pseudovariables like `violin.1'.
+
+ * LilyPond source files may now be embedded inside the generated PDF
+ files. This experimental feature is disabled by default and may
+ be regarded as unsafe, as PDF documents with hidden content tend
+ to present a security risk. Please note that not all PDF viewers
+ have the ability to handle embedded documents (if not, the PDF
+ output will appear normally and source files will remain
+ invisible). This feature only works with the PDF backend.
+
+ * French note names are now defined specifically instead of being
+ aliased to Italian note names: in addition to the generic
+ Italian-derived syntax, the D pitch may be entered as `ré'.
+ Double sharps may also be entered using the `-x' suffix.
+
+ * Additional bass strings (for lute tablature) are supported.
+
+ m = { f'4 d' a f d a, g, fis, e, d, c, \bar "|." }
+
+ \score {
+ \new TabStaff \m
+ \layout {
+ \context {
+ \Score
+ tablatureFormat = #fret-letter-tablature-format
+ }
+ \context {
+ \TabStaff
+ stringTunings = \stringTuning <a, d f a d' f'>
+ additionalBassStrings = \stringTuning <c, d, e, fis, g,>
+ fretLabels = #'("a" "b" "r" "d" "e" "f" "g" "h" "i" "k")
+ }
}
- \score { ... }
- ...
}
- \bookpart {
- \header {
- subtitle = "Second part"
+ [image of music]
+
+
+ * The markup-list-command `\table' is now available. Each column
+ may be aligned differently.
+
+ \markuplist {
+ \override #'(padding . 2)
+ \table
+ #'(0 1 0 -1)
+ {
+ \underline { center-aligned right-aligned center-aligned left-aligned }
+ one "1" thousandth "0.001"
+ eleven "11" hundredth "0.01"
+ twenty "20" tenth "0.1"
+ thousand "1000" one "1.0"
+ }
+ }
+ [image of music]
+
+
+ * A new markup-command, `\with-dimensions-from', makes
+ `\with-dimensions' easier to use by taking the new dimensions from
+ a markup object, given as first argument.
+
+ \markup {
+ \pattern #5 #Y #0 "x"
+ \pattern #5 #Y #0 \with-dimensions-from "x" "f"
+ \pattern #5 #Y #0 \with-dimensions-from "x" "g"
+ \override #'(baseline-skip . 2)
+ \column {
+ \pattern #5 #X #0 "n"
+ \pattern #5 #X #0 \with-dimensions-from "n" "m"
+ \pattern #5 #X #0 \with-dimensions-from "n" "!"
}
- \score { ... }
- ...
}
+ [image of music]
- * Nested contexts of the same type are now allowed. This deprecates
- `InnerStaffGroup' and `InnerChoirStaff'.
- [image of music]
+ * A new page breaking function `ly:one-line-auto-height-breaking'
+ places a whole score on a single line and changes the page width
+ to match, just like `ly:one-line-breaking'. The difference is that
+ it also automatically modifies the height of the page to fit the
+ height of the music.
+ * Markup-command `\draw-squiggle-line' is now available.
+ Customizing is possible with overrides of `thickness',
+ `angularity', `height' and `orientation'
- * Percent repeat counters can be shown at regular intervals using the
- context property `repeatCountVisibility'.
+ \markup
+ \overlay {
+ \draw-squiggle-line #0.5 #'(3 . 3) ##t
- [image of music]
+ \translate #'(3 . 3)
+ \override #'(thickness . 4)
+ \draw-squiggle-line #0.5 #'(3 . -3) ##t
+ \translate #'(6 . 0)
+ \override #'(angularity . -5)
+ \draw-squiggle-line #0.5 #'(-3 . -3) ##t
- * In addition to the already existing `showLastLength' property,
- `showFirstLength' can now be set as well, rendering only the first
- measures of a piece. Both properties may be set at the same time:
+ \translate #'(3 . -3)
+ \override #'(angularity . 2)
+ \override #'(height . 0.3)
+ \override #'(orientation . -1)
+ \draw-squiggle-line #0.2 #'(-3 . 3) ##t
+ }
+ [image of music]
- [image of music]
+ * A new command, `\RemoveAllEmptyStaves', has been made available,
+ which acts exactly like `\RemoveEmptyStaves', except for also
+ removing empty staves on the first system in a score.
- * The file extension for MIDI can be set using the command-line
- program default `midi-extension'. For Windows, the default
- extension has been changed to `.mid'.
+ * Markup-commands `\undertie' and `\overtie' are now available, as
+ well as the generic markup-command `\tie'.
- * Two variations on the default double repeat bar line are now
- available.
+ \markup {
+ \undertie "undertied"
+ \overtie "overtied"
+ }
- [image of music]
+ m = {
+ c''1 \prall -\tweak text \markup \tie "131" -1
+ }
+ { \voiceOne \m \voiceTwo \m }
+ [image of music]
- * Four automatic accidentals rules have been added: `neo-modern',
- `neo-modern-cautionary', `dodecaphonic' and `teaching'. The
- following example illustrates `neo-modern' rule.
- [image of music]
+ * `TabStaff' is now able to print micro-tones for bendings etc.
+ \layout {
+ \context {
+ \Score
+ supportNonIntegerFret = ##t
+ }
+ }
- * Flags can now be generated with Scheme-code using the `'flag'
- `Stem' grob property. Existing scores will work without change.
+ mus = \relative { c'4 cih d dih }
- [image of music]
+ <<
+ \new Staff << \clef "G_8" \mus >>
+ \new TabStaff \mus
+ >>
+ [image of music]
- * Harp pedalling diagrams were added:
+ * Two new styles of whiteout are now available. The `outline' style
+ approximates the contours of a glyph's outline, and its shape is
+ produced from multiple displaced copies of the glyph. The
+ `rounded-box' style produces a rounded rectangle shape. For all
+ three styles, including the default `box' style, the whiteout
+ shape's `thickness', as a multiple of staff-line thickness, can be
+ customized.
+
+ \markup {
+ \combine
+ \filled-box #'(-1 . 15) #'(-3 . 4) #1
+ \override #'(thickness . 3)
+ \whiteout whiteout-box
+ }
+ \markup {
+ \combine
+ \filled-box #'(-1 . 24) #'(-3 . 4) #1
+ \override #'(style . rounded-box)
+ \override #'(thickness . 3)
+ \whiteout whiteout-rounded-box
+ }
+ \markup {
+ \combine
+ \filled-box #'(-1 . 18) #'(-3 . 4) #1
+ \override #'(style . outline)
+ \override #'(thickness . 3)
+ \whiteout whiteout-outline
+ }
+ \relative {
+ \override Staff.Clef.whiteout-style = #'outline
+ \override Staff.Clef.whiteout = 3
+ g'1
+ }
+ [image of music]
+
+
+ * All of `\override', `\revert', `\set', and `\unset' now work with
+ the `\once' prefix for making one-time settings.
+
+ \relative {
+ c'4 d
+ \override NoteHead.color = #red
+ e4 f |
+ \once \override NoteHead.color = #green
+ g4 a
+ \once \revert NoteHead.color
+ b c |
+ \revert NoteHead.color
+ f2 c |
+ }
+ [image of music]
+
+
+ * When outputting MIDI, LilyPond will now store the `title' defined
+ in a score's `\header' block (or, if there is no such definition
+ on the `\score' level, the first such definition found in a
+ `\header' block of the score's enclosing `\bookpart', `\book', or
+ top-level scope) as the name of the MIDI sequence in the MIDI
+ file. Optionally, the name of the MIDI sequence can be overridden
+ using the new `midititle' `\header' field independently of `title'
+ (for example, in case `title' contains markup code which does not
+ render as plain text in a satisfactory way automatically).
+
+ * Music (and scheme and void) functions and markup commands that
+ just supply the final parameters to a chain of overrides, music
+ function and markup command calls can now be defined in the form
+ of just writing the expression cut short with `\etc'.
+
+ bold-red-markup = \markup \bold \with-color #red \etc
+ highlight = \tweak font-size 3 \tweak color #red \etc
+
+ \markup \bold-red "text"
+ \markuplist \column-lines \bold-red { One Two }
+
+ { c' \highlight d' e'2-\highlight -! }
+ [image of music]
+
+
+ * LilyPond functions defined with `define-music-function',
+ `define-event-function', `define-scheme-function' and
+ `define-void-function' can now be directly called from Scheme as
+ if they were genuine Scheme procedures. Argument checking and
+ matching will still be performed in the same manner as when
+ calling the function through LilyPond input. This includes the
+ insertion of defaults for optional arguments not matching their
+ predicates. Instead of using `\default' in the actual argument
+ list for explicitly skipping a sequence of optional arguments,
+ `*unspecified*' can be employed.
+
+ * Current input location and parser are now stored in GUILE fluids
+ and can be referenced via the function calls `(*location*)' and
+ `(*parser*)'. Consequently, a lot of functions previously taking
+ an explicit `parser' argument no longer do so.
+
+ Functions defined with `define-music-function',
+ `define-event-function', `define-scheme-function' and
+ `define-void-function' no longer use `parser' and `location'
+ arguments.
+
+ With those particular definitions, LilyPond will try to recognize
+ legacy use of `parser' and `location' arguments, providing
+ backwards-compatible semantics for some time.
+
+ * In the "english" notename language, the long notenames for pitches
+ with accidentals now contain a hyphen for better readability. You
+ now have to write
+ \key a-flat \major
+ instead of the previous
+ \key aflat \major
+
+ Double accidentals do not get another hyphen, so the Dutch `cisis'
+ has the long English notename `c-sharpsharp'.
+
+ * The visual style of tremolo slashes (shape, style and slope) is
+ now more finely controlled.
[image of music]
- * Predefined, user-configurable, transposable fret diagrams are now
- available in the `FretBoards' context:
+ * Multi-measure rests have length according to their total duration,
+ under the control of `MultiMeasureRest.space-increment'.
[image of music]
- * The following syntax changes were made, in chronological order. In
- addition, fret diagram properties have been moved to
- `fret-diagram-details', and the `#'style' property is used to
- select solid/dashed lines instead of `#'dash-fraction'.
-
- 'break-align-symbol -> 'break-align-symbols
- scripts.caesura -> scripts.caesura.curved
- \setEasyHeads -> \easyHeadsOn
- \easyHeadsOff (new command)
- \fatText -> \textLengthOn
- \emptyText -> \textLengthOff
- \set hairpinToBarline -> \override Hairpin #'to-barline
- \compressMusic -> \scaleDurations
- \octave -> \octaveCheck
- \arpeggioUp -> \arpeggioArrowUp
- \arpeggioDown -> \arpeggioArrowDown
- \arpeggioNeutral -> \arpeggioNormal
- \setTextCresc -> \crescTextCresc
- \setTextDecresc -> \dimTextDecresc
- \setTextDecr -> \dimTextDecr
- \setTextDim -> \dimTextDim
- \setHairpinCresc -> \crescHairpin
- \setHairpinDecresc -> \dimHairpin
- \sustainUp -> \sustainOff
- \sustainDown -> \sustainOn
- \sostenutoDown -> \sostenutoOn
- \sostenutoUp -> \sostenutoOff
- 'infinite-spacing-height -> 'extra-spacing-height
- #(set-octavation oct) -> \ottava #oct
- \put-adjacent markup axis dir markup -> \put-adjacent axis dir markup markup
- \pointAndClickOn (new command)
- \pointAndClickOff (new command)
- \center-align -> \center-column
- \hcenter -> \center-align
- printallheaders -> print-all-headers
- \bigger -> \larger (already existing command)
- systemSeparatorMarkup -> system-separator-markup
-
- Moreover, some files in the `ly/' directory have been renamed; the
- *-init.ly filenames are now only used for files that are
- automatically included, while such files as `makam-init.ly' or
- `gregorian-init.ly' have been renamed to `makam.ly' or
- `gregorian.ly'.
-
- * The "tex" and "texstr" backends have been removed. Font are now
- accessed via the fontconfig library; the Pango library is used to
- display text strings.
-
- * Metronome marks can now also contain a textual description. The
- duration and count (if given) are shown in parentheses after the
- text.
+ * Page numbers may now be printed in roman numerals, by setting the
+ `page-number-type' paper variable.
- [image of music]
+ * It is now possible to use `\time' and `\partial' together to
+ change the time signature in mid measure.
+ \override Score.BarNumber.break-visibility = #end-of-line-invisible
+ \partial 4 \time 3/4 f4 | 2 4 | 2 \bar "||"
+ \time 9/8 \partial 4. f8 8 8 | 2. 8 8 8 |
+ [image of music]
- * In figured bass you can now also use a backslash through a number
- to indicate a raised 6th step.
- [image of music]
+ * It is now possible to override the `text' property of chord names.
+ <<
+ \new ChordNames \chordmode {
+ a' b c:7
+ \once \override ChordName.text = #"foo"
+ d
+ }
+ >>
+ [image of music]
- * Arpeggios may now use "parenthesis" style brackets:
- [image of music]
+ * Improved horizontal alignment when using `TextScript', with
+ `DynamicText' or `LyricText'.
+ * A new command `\magnifyStaff' has been added which scales staff
+ sizes, staff lines, bar lines, beamlets and horizontal spacing
+ generally at the `Staff' context level. Staff lines are prevented
+ from being scaled smaller than the default since the thickness of
+ stems, slurs, and the like are all based on the staff line
+ thickness.
+
+ * `InstrumentName' now supports `text-interface'.
+
+ * There is now support for controlling the `expression level' of
+ MIDI channels using the `Staff.midiExpression' context property.
+ This can be used to alter the perceived volume of even sustained
+ notes (albeit in a very `low-level' way) and accepts a number
+ value between `0.0' and `1.0'.
+
+ \score {
+ \new Staff \with {
+ midiExpression = #0.6
+ midiInstrument = #"clarinet"
+ }
+ <<
+ { a'1~ a'1 }
+ {
+ \set Staff.midiExpression = #0.7 s4\f\<
+ \set Staff.midiExpression = #0.8 s4
+ \set Staff.midiExpression = #0.9 s4
+ \set Staff.midiExpression = #1.0 s4
+
+ \set Staff.midiExpression = #0.9 s4\>
+ \set Staff.midiExpression = #0.8 s4
+ \set Staff.midiExpression = #0.7 s4
+ \set Staff.midiExpression = #0.6 s4\!
+ }
+ >>
+ \midi { }
+ }
+
+ * Support for making it easier to use alternative `music' fonts other
+ than the default Emmentaler in LilyPond has been added. See
+ `http://fonts.openlilylib.org/' for more information.
+
+ * Grobs and their parents can now be aligned separately allowing
+ more flexibility for grob positions. For example the `left' edge
+ of a grob can now be aligned on the `center' of its parent.
+
+ * Improvements to the `\partial' command have been made to avoid
+ problems when using multiple, parallel contexts.
+
+ * `\chordmode' can now use `< >' and `<< >>' constructs.
+
+ * A new command `\tagGroup' has now been added. This complements
+ the existing `\keepWithTag' and `\removeWithTag' commands. For
+ Example:
+
+ \tagGroup #'(violinI violinII viola cello)
+
+ declares a list of `tags' that belong to a single `tag group'.
+
+ \keepWithTag #'violinI
+
+ Is now only concerned with `tags' from `violinI'’s tag group.
+
+ Any element of the included music tagged with one or more tags
+ from the group, but _not_ with VIOLINI, will be removed.
+
+ * The `\addlyrics' function now works with arbitrary contexts
+ incuding `Staff'.
+
+ * String numbers can now also be used to print roman numerals (e.g.
+ for unfretted string instruments).
+
+ c2\2
+ \romanStringNumbers
+ c\2
+ \arabicStringNumbers
+ c1\3
+ [image of music]
+
+
+ * The `thin-kern' property of the `BarLine' grob has been renamed to
+ `segno-kern'.
+
+ * `KeyCancellation' grobs now ignore cue clefs (like `KeySignature'
+ grobs do).
+
+ * Add support for `\once \unset'
+
+ * It is now possible to individually color both the dots and
+ parentheses in fret diagrams when using the
+ `\fret-diagram-verbose' markup command.
+
+ \new Voice {
+ c1^\markup {
+ \override #'(fret-diagram-details . (
+ (finger-code . in-dot))) {
+ \fret-diagram-verbose #'((mute 6)
+ (place-fret 5 3 1 red)
+ (place-fret 4 5 2 inverted)
+ (place-fret 3 5 3 green)
+ (place-fret 2 5 4 blue inverted)
+ (place-fret 1 3 1 violet)
+ (barre 5 1 3 ))
+ }
+ }
+ c1^\markup {
+ \override #'(fret-diagram-details . (
+ (finger-code . below-string))) {
+ \fret-diagram-verbose #'((mute 6)
+ (place-fret 5 3 1 red parenthesized)
+ (place-fret 4 5 2 yellow
+ default-paren-color
+ parenthesized)
+ (place-fret 3 5 3 green)
+ (place-fret 2 5 4 blue )
+ (place-fret 1 3 1)
+ (barre 5 1 3))
+ }
+ }
+ }
+ [image of music]
+
+
+ * Two new properties have been added for use in
+ `fret-diagram-details' when using the `\fret-diagram-verbose'
+ markup command; `fret-label-horizontal-offset' which affects the
+ `fret-label-indication' and `paren-padding' which controls the
+ space between the dot and the parentheses surrounding it.
+
+ \new Voice {
+ c1^\markup {
+ \fret-diagram-verbose #'((mute 6)
+ (place-fret 5 3 1)
+ (place-fret 4 5 2)
+ (place-fret 3 5 3)
+ (place-fret 1 6 4 parenthesized)
+ (place-fret 2 3 1)
+ (barre 5 2 3))
+ }
+ c1^\markup {
+ \override #'(fret-diagram-details . (
+ (fret-label-horizontal-offset . 2)
+ (paren-padding . 0.25))) {
+ \fret-diagram-verbose #'((mute 6)
+ (place-fret 5 3 1)
+ (place-fret 4 5 2)
+ (place-fret 3 5 3)
+ (place-fret 1 6 4 parenthesized)
+ (place-fret 2 3 1)
+ (barre 5 2 3))
+ }
+ }
+ }
+ [image of music]
- * Single-system scores are now naturally spaced instead of being
- stretched to fill the line width. This can be changed by setting
- `ragged-right = ##f'.
- * Enclosing text within boxes with rounded corners is now possible,
- using the `\rounded-box' markup command.
+ * A new markup command `\justify-line' has been added. Similar to
+ the `\fill-line' markup command except that instead of setting
+ _words_ in columns, the `\justify-line' command balances the
+ whitespace between them ensuring that when there are three or more
+ words in a markup, the whitespace is always consistent.
- * `lilypond-book' can run any program instead of `latex' to guess
- the line width, thanks to `--latex-program' command line option.
+ \markup \fill-line {oooooo oooooo oooooo oooooo}
+ \markup \fill-line {ooooooooo oooooooo oo ooo}
+ [image of music]
- * Underlining is now possible with the `\underline' markup command.
- * It is now possible to specify, using the `page-count' variable in
- the paper block, the number of pages that will be used.
+ \markup \justify-line {oooooo oooooo oooooo oooooo}
+ \markup \justify-line {ooooooooo oooooooo oo ooo}
+ [image of music]
- * A new page breaking function, `ly:minimal-breaking', is dedicated
- to books with many pages or a lot of text.
- * A table of contents is included using `\markuplines
- \table-of-contents'. Elements are added to it using the
- `\tocItem' command.
+ * A new command `\magnifyMusic' has been added, which allows the
+ notation size to be changed without changing the staff size, while
+ automatically scaling stems, beams, and horizontal spacing.
- * Text spreading over several pages is entered using the
- `\markuplines' keyword. Builtin markup list commands, such as
- `\justified-lines' or `\wordwrap-lines' may be used, and new ones
- created using the `define-markup-list-command' Scheme macro.
+ \new Staff <<
+ \new Voice \relative {
+ \voiceOne
+ <e' e'>4 <f f'>8. <g g'>16 <f f'>8 <e e'>4 r8
+ }
+ \new Voice \relative {
+ \voiceTwo
+ \magnifyMusic 0.63 {
+ \override Score.SpacingSpanner.spacing-increment = #(* 1.2 0.63)
+ r32 c'' a c a c a c r c a c a c a c
+ r c a c a c a c a c a c a c a c
+ }
+ }
+ >>
+ [image of music]
+
+
+ * A new flexible template suitable for a range of choral music, is
+ now provided. This may be used to create simple choral music,
+ with or without piano accompaniment, in two or four staves. Unlike
+ other templates, this template is `built-in', which means it does
+ not need to be copied and edited: instead it is simply `\include''d
+ in the input file. For details, see *note Built-in templates:
+ (lilypond-learning)Built-in templates.
+
+ * The positioning of tuplet numbers for kneed beams has been
+ significantly improved. Previously, tuplet numbers were placed
+ according to the position of the tuplet bracket, even if it was
+ not printed. This could lead to stranded tuplet numbers. Now
+ they are now positioned closer to the kneed-beam when an
+ appropriate beam segment exists for its placement and when the
+ bracket is not drawn.
+
+ Collision detection is also added, offsetting horizontally if too
+ close to an adjoining note column but preserving the number's
+ vertical distance from the kneed beam. If the number itself is
+ too large to fit in the available space the original,
+ bracket-based, positioning system is used instead; and in the
+ event of a collision (e.g. with an accidental) the tuplet number
+ is moved vertically away instead.
+
+ \time 3/4
+ \override Beam.auto-knee-gap = 3
+ \tuplet 3/2 4 {
+ g8 c'' e,
+ c'8 g,, e''
+ g,,8 e''' c,,
+ }
+ [image of music]
- * Particular points of a book may be marked with the `\label'
- command. Then, the page where these points are placed can be
- referred to using the `\page-ref' markup command.
- * Page breaking and page turning commands (`\pageBreak',
- `\noPageBreak', etc.) can be used at top-level, between scores and
- top-level markups.
+ The original kneed-beam tuplet behavior is still available through
+ an `\override' via a new, `knee-to-beam' property.
- * The following options are now changed as a `-d' sub-option:
- `--backend', `--safe', `--preview' and `--no-pages' (which became
- `-dno-print-pages'). The `-b' option does not exist any more.
+ \time 3/4
+ \override Beam.auto-knee-gap = 3
+ \override TupletNumber.knee-to-beam = ##f
+ \tuplet 3/2 4 {
+ g8 c'' e,
+ c'8 g,, e''
+ g,,8 e''' c,,
+ }
+ [image of music]
- * Improved testing procedures now catch changes in CPU and memory
- performance, page layout, MIDI results and warnings. This helps to
- reduce the number of regression errors during development,
- resulting in more stable releases.
- See `INSTALL.html#Testing-LilyPond' for more information.
+ * `\lyricsto' and `\addLyrics' have been `harmonized'. Both now
+ accept the same kind of delimited argument list that `\lyrics' and
+ `\chords' accept. Backward compatibility has been added so music
+ identifiers (i.e. `\mus') are permitted as arguments. A
+ `convert-ly' rule has been added that removes redundant uses of
+ `\lyricmode' and rearranges combinations with context starters such
+ that `\lyricsto' in general is applied last (i.e. like
+ `\lyricmode' would be).
- * Nested properties, such as `'details' in `Slur', can be reverted
- as well. The syntax for this is
+ * Scheme functions and identifiers can now be used as output
+ definitions.
- \revert Slur #'(details closeness-factor)
+ * Scheme expressions can now be used as chord constituents.
- * All line spanners are more flexible now in the configuration of
- their end points. This includes glissando, voice followers, text
- crescendos and other text spanners. The old syntax for setting
- text on line spanners is no longer valid.
+ * Improved visual spacing of small and regular `MI' Funk and Walker
+ noteheads so they are now the same width as other shaped notes in
+ their respective sets. `SOL' noteheads are also now visually
+ improved when used with both the normal Aiken and Sacred Harp
+ heads, as well as with the thin variants.
- [image of music]
+ * `LeftEdge' now has a definable `Y-extent' (i.e.vertical). See *note
+ LeftEdge: (lilypond-internals)LeftEdge.
+ * Added a new `make-path-stencil' function that supports all `path'
+ commands both relative and absolute:
- This feature was sponsored by Trevor Bača.
+ `lineto', `rlineto', `curveto', `rcurveto', `moveto', `rmoveto',
+ `closepath'. The function also supports `single-letter' syntax
+ used in standard SVG path commands:
- * The environment variable `LILYPONDPREFIX' has been renamed
- `LILYPOND_DATADIR'.
+ `L', `l', `C', `c', `M', `m', `Z' and `z'. The new command is
+ also backward-compatible with the original
+ `make-connected-path-stencil' function. Also see
+ `scm/stencil.scm'.
- * Notes or rests, such as a typical end note, that fill an entire
- measure are preceded by some more space.
+ * Context properties named in the `alternativeRestores' property are
+ restored to their value at the start of the _first_ alternative in
+ all subsequent alternatives.
- [image of music]
+ Currently the default set restores `current meter';
+ \time 3/4
+ \repeat volta 2 { c2 e4 | }
+ \alternative {
+ { \time 4/4 f2 d | }
+ { f2 d4 | }
+ }
+ g2. |
+ [image of music]
- * All `\score's in a lilypond-book fragment are now inserted into
- the document. Also, toplevel markups don't result in an entire
- page.
- * Alterations (such as a sharp or flat) may now be arbitrary
- fractions. This allows some forms of microtonal music. For
- example, Turkish makam music uses 1/9th tone alterations.
+ `measure position';
- [image of music]
+ \time 3/4
+ \repeat volta 2 { c2 e4 | }
+ \alternative {
+ { \time 4/4
+ \set Timing.measurePosition = #(ly:make-moment -1/2)
+ f2 | }
+ { f2 d4 | }
+ }
+ g2. |
+ [image of music]
- * Tie directions may be set with `^~' and `_~'.
+ and `chord changes';
- * Tablature now supports harmonics and slides:
+ <<
+ \new ChordNames {
+ \set chordChanges = ##t
+ \chordmode { c1:m d:m c:m d:m }
+ }
+ \new Staff {
+ \repeat volta 2 { \chordmode { c1:m } }
+ \alternative {
+ { \chordmode { d:m } }
+ { \chordmode { c:m } }
+ }
+ \chordmode { d:m }
+ }
+ >>
+ [image of music]
+
+
+ * Improved MIDI output for breathe marks. After tied notes, breaths
+ take time _only_ from the last note of the tie; e.g. `{ c4~ c8
+ \breathe }' performs as `{ c4~ c16 r }' instead of `{ c4 r8 }'.
+ This is more consistent with articulations and how humans
+ interpret breaths after ties. It now also makes it easier to
+ align simultaneous breathe marks over multiple parts, all with
+ different note lengths.
+
+ * A new note head style for Tabulature has been added;
+ `TabNoteHead.style = #'slash'.
+
+ * Four new Clef glyphs have been added _Double G_, _Tenor G_,
+ _Varpercussion_ and _varC_ and their related tessitura.
+
+ \override Staff.Clef.full-size-change = ##t
+
+ \clef "GG" c c c c
+ \clef "tenorG" c c c c
+ \clef "varC" c c c c
+ \clef "altovarC" c c c c
+ \clef "tenorvarC" c c c c
+ \clef "baritonevarC" c c c c
+ \clef "varpercussion" c c c c
+
+ \break
+ \override Staff.Clef.full-size-change = ##f
+
+ \clef "GG" c c c c
+ \clef "tenorG" c c c c
+ \clef "varC" c c c c
+ \clef "altovarC" c c c c
+ \clef "tenorvarC" c c c c
+ \clef "baritonevarC" c c c c
+ \clef "varpercussion" c c c c
+ [image of music]
+
+
+ * Isolated durations in music sequences now stand for unpitched
+ notes. This may be useful for specifying rhythms to music or
+ scheme functions. When encountered in the final score, the
+ pitches are provided by the preceding note or chord. Here are two
+ examples where this makes for readable input:
+
+ \new DrumStaff \with { \override StaffSymbol.line-count = 1 }
+ \drummode {
+ \time 3/4
+ tambourine 8 \tuplet 3/2 { 16 16 16 }
+ 8 \tuplet 3/2 { 16 16 16 } 8 8 |
+ }
+ [image of music]
- [image of music]
+ \new Staff { r16 c'16 ~ 8 ~ 4 ~ 2 | }
+ [image of music]
- This feature was sponsored by Mike Amundsen
- * Horizontal spacing now follows object outlines more accurately.
- This allows tighter horizontal spacing.
+ * `\displayLilyMusic' and its underlying Scheme functions no longer
+ omit redundant note durations. This makes it easier to reliably
+ recognize and format standalone durations in expressions like
+ { c4 d4 8 }
- [image of music]
+ * Beaming exceptions can now be constructed using the
+ `\beamExceptions' scheme function. One can now write
+ \time #'(2 1) 3/16
+ \set Timing.beamExceptions =
+ \beamExceptions { 32[ 32] 32[ 32] 32[ 32] }
+ c16 c c |
+ \repeat unfold 6 { c32 } |
+ [image of music]
- * Objects that belong outside of the staff are now positioned
- automatically to avoid collisions.
- [image of music]
+ with multiple exceptions separated with `|' bar checks (writing
+ the exception pattern without pitches is convenient but not
+ mandatory). Previously, setting the beam exceptions would have
+ required writing
+ \set Timing.beamExceptions =
+ #'( ;start of alist
+ (end . ;entry for end of beams
+ ( ;start of alist of end points
+ ((1 . 32) . (2 2 2)) ;rule for 1/32 beams -- end each 1/16
+ )))
- * Staves are spaced vertically using a skyline algorithm. This helps
- prevent uneven vertical spacing.
+ * The most common articulations are now reflected in MIDI output.
+ Accent and marcato make notes louder; staccato, staccatissimo and
+ portato make them shorter. Breath marks shorten the previous note.
- [image of music]
+ This behavior is customizable through the `midiLength' and
+ `midiExtraVelocity' properties on `ArticulationEvent'. See
+ `script-init.ly' for examples.
+
+ * The PostScript functionality of stroke adjustment is no longer
+ applied automatically but left to the discretion of the PostScript
+ device (by default, Ghostscript uses it for resolutions up to
+ 150dpi when generating raster images). When it is enabled, a more
+ complex drawing algorithm designed to benefit from stroke
+ adjustment is employed mostly for stems and bar lines.
+ Stroke adjustment can be forced by specifying the command line
+ option `-dstrokeadjust' to LilyPond. When generating `PDF' files,
+ this will usually result in markedly better looking `PDF' previews
+ but significantly larger file size. Print quality at high
+ resolutions will be unaffected.