CVSROOT: /cvsroot/lilypond Module name: lilypond Branch: Changes by: Graham Percival <[EMAIL PROTECTED]> 05/05/24 19:09:20
Modified files: . : ChangeLog Documentation/user: lilypond.tely basic-notation.itely advanced-notation.itely changing-defaults.itely Log message: Misc editing, rearranging. CVSWeb URLs: http://savannah.gnu.org/cgi-bin/viewcvs/lilypond/lilypond/ChangeLog.diff?tr1=1.3652&tr2=1.3653&r1=text&r2=text http://savannah.gnu.org/cgi-bin/viewcvs/lilypond/lilypond/Documentation/user/lilypond.tely.diff?tr1=1.128&tr2=1.129&r1=text&r2=text http://savannah.gnu.org/cgi-bin/viewcvs/lilypond/lilypond/Documentation/user/basic-notation.itely.diff?tr1=1.19&tr2=1.20&r1=text&r2=text http://savannah.gnu.org/cgi-bin/viewcvs/lilypond/lilypond/Documentation/user/advanced-notation.itely.diff?tr1=1.27&tr2=1.28&r1=text&r2=text http://savannah.gnu.org/cgi-bin/viewcvs/lilypond/lilypond/Documentation/user/changing-defaults.itely.diff?tr1=1.129&tr2=1.130&r1=text&r2=text Patches: Index: lilypond/ChangeLog diff -u lilypond/ChangeLog:1.3652 lilypond/ChangeLog:1.3653 --- lilypond/ChangeLog:1.3652 Mon May 23 23:23:42 2005 +++ lilypond/ChangeLog Tue May 24 19:09:19 2005 @@ -1,3 +1,14 @@ +2005-05-24 Graham Percival <[EMAIL PROTECTED]> + + * Documentation/user/lilypond.tely: move changing-defaults to be + before global issues. + + * Documentation/user/basic-notation.itely: move Transpose section + here from advanced/Other. + + * Documentation/user/changing-defaults.itely, + advanced-notation.itely: move Fonts to advanced, edit. + 2005-05-24 Han-Wen Nienhuys <[EMAIL PROTECTED]> * lily/parser.yy (bare_int): remove rule. From now on, we require Index: lilypond/Documentation/user/advanced-notation.itely diff -u lilypond/Documentation/user/advanced-notation.itely:1.27 lilypond/Documentation/user/advanced-notation.itely:1.28 --- lilypond/Documentation/user/advanced-notation.itely:1.27 Mon May 23 19:29:14 2005 +++ lilypond/Documentation/user/advanced-notation.itely Tue May 24 19:09:20 2005 @@ -37,6 +37,8 @@ * Text encoding:: * Nested scores:: * Overview of text markup commands:: +* Selecting font sizes:: +* Font selection:: * New dynamic marks:: * Other text markup issues:: @end menu @@ -357,6 +359,133 @@ @include markup-commands.tely [EMAIL PROTECTED] Selecting font sizes [EMAIL PROTECTED] Selecting font sizes + +The easiest method of setting the font size of any context, is by +setting the @code{fontSize} property. + [EMAIL PROTECTED],fragment,relative=1,verbatim] +c8 +\set fontSize = #-4 +c f +\set fontSize = #3 +g [EMAIL PROTECTED] lilypond + [EMAIL PROTECTED] +It does not change the size of variable symbols, such as beams or +slurs. + +Internally, the @code{fontSize} context property will cause the [EMAIL PROTECTED] property to be set in all layout objects. The value +of @code{font-size} is a number indicating the size relative to the +standard size for the current staff height. Each step up is an +increase of approximately 12% of the font size. Six steps is exactly a +factor two. The Scheme function @code{magstep} converts a [EMAIL PROTECTED] number to a scaling factor. + [EMAIL PROTECTED],fragment,relative=1,verbatim] +c8 +\override NoteHead #'font-size = #-4 +c f +\override NoteHead #'font-size = #3 +g [EMAIL PROTECTED] lilypond + +LilyPond has fonts in different design sizes. The music fonts for +smaller sizes are chubbier, while the text fonts are relatively wider. +Font size changes are achieved by scaling the design size that is +closest to the desired size. The standard font size (for [EMAIL PROTECTED] equals 0), depends on the standard staff height. For +a 20pt staff, a 10pt font is selected. + +The @code{font-size} property can only be set on layout objects that +use fonts. These are the ones supporting the [EMAIL PROTECTED] layout interface. + [EMAIL PROTECTED] + +The following commands set @code{fontSize} for the current voice: + [EMAIL PROTECTED] @code{\tiny} [EMAIL PROTECTED], [EMAIL PROTECTED] @code{\small} [EMAIL PROTECTED], [EMAIL PROTECTED] @code{\normalsize} [EMAIL PROTECTED] + + [EMAIL PROTECTED] Font selection [EMAIL PROTECTED] Font selection + [EMAIL PROTECTED] font selection [EMAIL PROTECTED] font magnification [EMAIL PROTECTED] @code{font-interface} + +By setting the object properties described below, you can select a +font from the preconfigured font families. LilyPond has default +support for the feta music fonts and @TeX{}'s Computer Modern text +fonts. + [EMAIL PROTECTED] @bullet [EMAIL PROTECTED] @code{font-encoding} +is a symbol that sets layout of the glyphs. This should only be set to +select different types of non-text fonts, eg. + [EMAIL PROTECTED] for piano staff braces, @code{fetaMusic} the +standard music font, including ancient glyphs, @code{fetaDynamic} for +dynamic signs and @code{fetaNumber} for the number font. + [EMAIL PROTECTED] @code{font-family} +is a symbol indicating the general class of the typeface. Supported are [EMAIL PROTECTED] (Computer Modern), @code{sans}, and @code{typewriter}. + [EMAIL PROTECTED] @code{font-shape} +is a symbol indicating the shape of the font. There are typically +several font shapes available for each font family. Choices are [EMAIL PROTECTED], @code{caps}, and @code{upright}. + [EMAIL PROTECTED] @code{font-series} +is a symbol indicating the series of the font. There are typically +several font series for each font family and shape. Choices are [EMAIL PROTECTED] and @code{bold}. + [EMAIL PROTECTED] itemize + +Fonts selected in the way sketched above come from a predefined style +sheet. If you want to use a font from outside the style sheet, +then set the [EMAIL PROTECTED] property, + [EMAIL PROTECTED],verbatim] +{ + \override Staff.TimeSignature #'font-name = #"Times" + \override Staff.TimeSignature #'font-size = #2 + \time 3/4 + c'1_\markup { + \override #'(font-name . "Vera Bold") + { This text is in Vera Bold } + } +} [EMAIL PROTECTED] lilypond + [EMAIL PROTECTED] +Any font can be used, as long as it is available to Pango/FontConfig. + +The size of the font may be set with the @code{font-size} +property. The resulting size is taken relative to the [EMAIL PROTECTED] as defined in the @code{\paper} block. + [EMAIL PROTECTED] font size [EMAIL PROTECTED] font magnification + [EMAIL PROTECTED] + +Init files: @file{ly/@/declarations@/-init@/.ly} contains hints how new +fonts may be added to LilyPond. + + @node New dynamic marks @subsection New dynamic marks @@ -402,6 +531,7 @@ @end example + @node Preparing parts @section Preparing parts @@ -1922,6 +2052,7 @@ COLORLIST + @node Automatic notation @section Automatic notation @@ -1934,7 +2065,6 @@ @menu * Automatic accidentals:: * Setting automatic beam behavior:: -* Beam formatting:: @end menu @node Automatic accidentals @@ -2198,22 +2328,6 @@ >>}. If a polyphonic voice ends while an automatic beam is still accepting notes, it is not typeset. [EMAIL PROTECTED] Beam formatting [EMAIL PROTECTED] Beam formatting - -When a beam falls in the middle of the staff, the beams point normally -down. However, this behaviour can be altered with the [EMAIL PROTECTED] property. - [EMAIL PROTECTED],raggedright,relative=2,fragment,verbatim] -{ - b8[ b] - \override Beam #'neutral-direction = #-1 - b[ b] - \override Beam #'neutral-direction = #1 - b[ b] -} [EMAIL PROTECTED] lilypond @node Other @@ -2224,7 +2338,6 @@ @menu * Time administration:: -* Transpose:: @end menu @@ -2273,83 +2386,4 @@ @end lilypond [EMAIL PROTECTED] Transpose [EMAIL PROTECTED] Transpose [EMAIL PROTECTED] Transpose [EMAIL PROTECTED] transposition of pitches [EMAIL PROTECTED] @code{\transpose} - -A music expression can be transposed with @code{\transpose}. The -syntax is [EMAIL PROTECTED] -\transpose @var{from} @var{to} @var{musicexpr} [EMAIL PROTECTED] example - -This means that @var{musicexpr} is transposed by the interval between -the pitches @var{from} and @var{to}: any note with pitch @code{from} -is changed to @code{to}. - - -For example, consider a piece written in the key of D-major. If -this piece is a little too low for its performer, it can be -transposed up to E-major with [EMAIL PROTECTED] -\transpose d e @dots{} [EMAIL PROTECTED] example - -Consider a part written for violin (a C instrument). If -this part is to be played on the A clarinet, the following -transposition will produce the appropriate part - [EMAIL PROTECTED] -\transpose a c @dots{} [EMAIL PROTECTED] example - [EMAIL PROTECTED] distinguishes between enharmonic pitches: both [EMAIL PROTECTED] c cis} or @code{\transpose c des} will transpose up -half a tone. The first version will print sharps and the second -version will print flats - [EMAIL PROTECTED],raggedright,verbatim] -mus = { \key d \major cis d fis g } -\context Staff { - \clef "F" \mus - \clef "G" - \transpose c g' \mus - \transpose c f' \mus -} [EMAIL PROTECTED] lilypond - [EMAIL PROTECTED] may also be used to input written notes for a -transposing instrument. Pitches are normally entered into LilyPond -in C (or ``concert pitch''), but they may be entered in another -key. For example, when entering music for a B-flat trumpet which -begins on concert D, one would write - [EMAIL PROTECTED] -\transpose c bes @{ e4 @dots{} @} [EMAIL PROTECTED] example - -To print this music in B-flat again (ie producing a trumpet part, -instead of a concert pitch conductor's score) you would wrap the -existing music with another @code{transpose} - [EMAIL PROTECTED] -\transpose bes c @{ \transpose c bes @{ e4 @dots{} @} @} [EMAIL PROTECTED] example - - - [EMAIL PROTECTED] - -Program reference: @internalsref{TransposedMusic}, and [EMAIL PROTECTED] - [EMAIL PROTECTED] - -If you want to use both @code{\transpose} and @code{\relative}, -you must put @code{\transpose} outside of @code{\relative}, since [EMAIL PROTECTED] will have no effect music that appears inside a [EMAIL PROTECTED] - Index: lilypond/Documentation/user/basic-notation.itely diff -u lilypond/Documentation/user/basic-notation.itely:1.19 lilypond/Documentation/user/basic-notation.itely:1.20 --- lilypond/Documentation/user/basic-notation.itely:1.19 Fri May 20 10:08:28 2005 +++ lilypond/Documentation/user/basic-notation.itely Tue May 24 19:09:20 2005 @@ -13,7 +13,7 @@ @menu * Note entry:: -* Easier music entry:: +* Alternate music entry:: * Staff notation:: * Connecting notes:: * Expressive marks:: @@ -472,8 +472,8 @@ [EMAIL PROTECTED] Easier music entry [EMAIL PROTECTED] Easier music entry [EMAIL PROTECTED] Alternate music entry [EMAIL PROTECTED] Alternate music entry @cindex Music entry This section deals with tricks and features of the input language that @@ -488,6 +488,7 @@ @menu * Relative octaves:: * Octave check:: +* Transpose:: * Bar check:: * Skipping corrected music:: * Automatic note splitting:: @@ -626,6 +627,86 @@ @end lilypond [EMAIL PROTECTED] Transpose [EMAIL PROTECTED] Transpose + [EMAIL PROTECTED] Transpose [EMAIL PROTECTED] transposition of pitches [EMAIL PROTECTED] @code{\transpose} + +A music expression can be transposed with @code{\transpose}. The +syntax is [EMAIL PROTECTED] +\transpose @var{from} @var{to} @var{musicexpr} [EMAIL PROTECTED] example + +This means that @var{musicexpr} is transposed by the interval between +the pitches @var{from} and @var{to}: any note with pitch @code{from} +is changed to @code{to}. + +For example, consider a piece written in the key of D-major. If +this piece is a little too low for its performer, it can be +transposed up to E-major with [EMAIL PROTECTED] +\transpose d e @dots{} [EMAIL PROTECTED] example + +Consider a part written for violin (a C instrument). If +this part is to be played on the A clarinet, the following +transposition will produce the appropriate part + [EMAIL PROTECTED] +\transpose a c @dots{} [EMAIL PROTECTED] example + [EMAIL PROTECTED] distinguishes between enharmonic pitches: both [EMAIL PROTECTED] c cis} or @code{\transpose c des} will transpose up +half a tone. The first version will print sharps and the second +version will print flats + [EMAIL PROTECTED],raggedright,verbatim] +mus = { \key d \major cis d fis g } +\context Staff { + \clef "F" \mus + \clef "G" + \transpose c g' \mus + \transpose c f' \mus +} [EMAIL PROTECTED] lilypond + [EMAIL PROTECTED] may also be used to input written notes for a +transposing instrument. Pitches are normally entered into LilyPond +in C (or ``concert pitch''), but they may be entered in another +key. For example, when entering music for a B-flat trumpet which +begins on concert D, one would write + [EMAIL PROTECTED] +\transpose c bes @{ e4 @dots{} @} [EMAIL PROTECTED] example + +To print this music in B-flat again (ie producing a trumpet part, +instead of a concert pitch conductor's score) you would wrap the +existing music with another @code{transpose} + [EMAIL PROTECTED] +\transpose bes c @{ \transpose c bes @{ e4 @dots{} @} @} [EMAIL PROTECTED] example + + [EMAIL PROTECTED] + +Program reference: @internalsref{TransposedMusic}, and [EMAIL PROTECTED] + + [EMAIL PROTECTED] + +If you want to use both @code{\transpose} and @code{\relative}, +you must put @code{\transpose} outside of @code{\relative}, since [EMAIL PROTECTED] will have no effect music that appears inside a [EMAIL PROTECTED] + + @node Bar check @subsection Bar check Index: lilypond/Documentation/user/changing-defaults.itely diff -u lilypond/Documentation/user/changing-defaults.itely:1.129 lilypond/Documentation/user/changing-defaults.itely:1.130 --- lilypond/Documentation/user/changing-defaults.itely:1.129 Wed May 18 04:36:41 2005 +++ lilypond/Documentation/user/changing-defaults.itely Tue May 24 19:09:20 2005 @@ -60,7 +60,6 @@ @menu * Interpretation contexts:: * The \override command:: -* Fonts:: @end menu @@ -1321,156 +1320,3 @@ is one. For example, if using this with @code{Slur}, @code{Slur::after_line_breaking} should also be called. [EMAIL PROTECTED] Fonts [EMAIL PROTECTED] Fonts - -This section details the ways that the font can be changed. - [EMAIL PROTECTED] -* Selecting font sizes:: -* Font selection:: [EMAIL PROTECTED] menu - - - [EMAIL PROTECTED] Selecting font sizes [EMAIL PROTECTED] Selecting font sizes - - -The easiest method of setting the font size of any context, is by -setting the @code{fontSize} property. - [EMAIL PROTECTED],fragment,relative=1,verbatim] -c8 -\set fontSize = #-4 -c f -\set fontSize = #3 -g [EMAIL PROTECTED] lilypond - [EMAIL PROTECTED] -It does not change the size of variable symbols, such as beams or -slurs. - -Internally, the @code{fontSize} context property will cause the [EMAIL PROTECTED] property to be set in all layout objects. The value -of @code{font-size} is a number indicating the size relative to the -standard size for the current staff height. Each step up is an -increase of approximately 12% of the font size. Six steps is exactly a -factor two. The Scheme function @code{magstep} converts a [EMAIL PROTECTED] number to a scaling factor. - [EMAIL PROTECTED],fragment,relative=1,verbatim] -c8 -\override NoteHead #'font-size = #-4 -c f -\override NoteHead #'font-size = #3 -g [EMAIL PROTECTED] lilypond - -LilyPond has fonts in different design sizes. The music fonts for -smaller sizes are chubbier, while the text fonts are relatively wider. -Font size changes are achieved by scaling the design size that is -closest to the desired size. The standard font size (for [EMAIL PROTECTED] equals 0), depends on the standard staff height. For -a 20pt staff, a 10pt font is selected. - -The @code{font-size} property can only be set on layout objects that -use fonts. These are the ones supporting the [EMAIL PROTECTED] layout interface. - [EMAIL PROTECTED] - -The following commands set @code{fontSize} for the current voice: - [EMAIL PROTECTED] @code{\tiny} [EMAIL PROTECTED], [EMAIL PROTECTED] @code{\small} [EMAIL PROTECTED], [EMAIL PROTECTED] @code{\normalsize} [EMAIL PROTECTED] - - - [EMAIL PROTECTED] magnification [EMAIL PROTECTED] cue notes - - [EMAIL PROTECTED] Font selection [EMAIL PROTECTED] Font selection - - - [EMAIL PROTECTED] font selection [EMAIL PROTECTED] font magnification [EMAIL PROTECTED] @code{font-interface} - -By setting the object properties described below, you can select a -font from the preconfigured font families. LilyPond has default -support for the feta music fonts and @TeX{}'s Computer Modern text -fonts. - - [EMAIL PROTECTED] @bullet [EMAIL PROTECTED] @code{font-encoding} -is a symbol that sets layout of the glyphs. This should only be set to -select different types of non-text fonts, eg. - [EMAIL PROTECTED] for piano staff braces, @code{fetaMusic} the -standard music font, including ancient glyphs, @code{fetaDynamic} for -dynamic signs and @code{fetaNumber} for the number font. - [EMAIL PROTECTED] @code{font-family} -is a symbol indicating the general class of the typeface. Supported are [EMAIL PROTECTED] (Computer Modern), @code{sans}, and @code{typewriter}. - [EMAIL PROTECTED] @code{font-shape} -is a symbol indicating the shape of the font. There are typically -several font shapes available for each font family. Choices are [EMAIL PROTECTED], @code{caps}, and @code{upright}. - [EMAIL PROTECTED] @code{font-series} -is a symbol indicating the series of the font. There are typically -several font series for each font family and shape. Choices are [EMAIL PROTECTED] and @code{bold}. - [EMAIL PROTECTED] itemize - -Fonts selected in the way sketched above come from a predefined style -sheet. If you want to use a font from outside the style sheet, -then set the [EMAIL PROTECTED] property, - [EMAIL PROTECTED],verbatim] -{ - \override Staff.TimeSignature #'font-name = #"Times" - \override Staff.TimeSignature #'font-size = #2 - \time 3/4 - c'1_\markup { - \override #'(font-name . "Vera Bold") - { This text is in Vera Bold } - } -} [EMAIL PROTECTED] lilypond - [EMAIL PROTECTED] -Any font can be used, as long as it is available to Pango/FontConfig. - -The size of the font may be set with the @code{font-size} -property. The resulting size is taken relative to the [EMAIL PROTECTED] as defined in the @code{\paper} block. - - [EMAIL PROTECTED] font size [EMAIL PROTECTED] font magnification - - - [EMAIL PROTECTED] - -Init files: @file{ly/@/declarations@/-init@/.ly} contains hints how new -fonts may be added to LilyPond. - - - - Index: lilypond/Documentation/user/lilypond.tely diff -u lilypond/Documentation/user/lilypond.tely:1.128 lilypond/Documentation/user/lilypond.tely:1.129 --- lilypond/Documentation/user/lilypond.tely:1.128 Tue May 24 16:10:09 2005 +++ lilypond/Documentation/user/lilypond.tely Tue May 24 19:09:20 2005 @@ -260,9 +260,9 @@ * Instrument-specific notation:: Notation that is only used for some instruments. * Advanced notation:: Less frequently used notation. +* Changing defaults:: Tuning output. * Global issues:: Non-notation commands. -* Changing defaults:: Tuning output. * Interfaces for programmers:: * LilyPond-book:: Integrating text and music. * Converting from other formats:: Converting to lilypond source format. @@ -289,9 +289,9 @@ @include basic-notation.itely @include instrument-notation.itely @include advanced-notation.itely [EMAIL PROTECTED] changing-defaults.itely @include global.itely [EMAIL PROTECTED] changing-defaults.itely @include programming-interface.itely @include lilypond-book.itely @include converters.itely _______________________________________________ Lilypond-cvs mailing list Lilypond-cvs@gnu.org http://lists.gnu.org/mailman/listinfo/lilypond-cvs