X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fnotation%2Fpercussion.itely;h=f325de0abc5131908dcec3e823c8904d1b4b4306;hb=2055f35c47a045a50a01ff4dba8524322cfc3b48;hp=0ba1d7cbe193824b136002284443f6e6e07b7e8f;hpb=f0c8472e58eaf15aee6ca1c1f2ace1266237b035;p=lilypond.git diff --git a/Documentation/notation/percussion.itely b/Documentation/notation/percussion.itely index 0ba1d7cbe1..f325de0abc 100644 --- a/Documentation/notation/percussion.itely +++ b/Documentation/notation/percussion.itely @@ -3,10 +3,11 @@ Translation of GIT committish: FILL-IN-HEAD-COMMITTISH When revising a translation, copy the HEAD committish of the - version that you are working on. See TRANSLATION for details. + version that you are working on. For details, see the Contributors' + Guide, node Updating translation committishes.. @end ignore -@c \version "2.12.0" +@c \version "2.14.0" @node Percussion @section Percussion @@ -34,7 +35,7 @@ also be used to show the rhythms of melodies. @node References for percussion @unnumberedsubsubsec References for percussion -TODO add more. +@c TODO add more references. @itemize @@ -89,10 +90,24 @@ Each piece of percussion has a full name and an abbreviated name, and both can be used in input files. The full list of percussion note names may be found in @ref{Percussion notes}. -Note that the normal notation of pitches (such as @code{cis4}) in -a @code{DrumStaff} context will cause an error message. -Percussion clefs are added automatically to a @code{DrumStaff} -contex, but other clefs may also be used. +@cindex clef, percussion +@cindex percussion clef + +Note that the normal notation of pitches (such as @code{cis4}) in a +@code{DrumStaff} context will cause an error message. Percussion clefs +are added automatically to a @code{DrumStaff} context but they can also +be set explicitly. Other clefs may be used as well. + +@lilypond[quote,ragged-right,verbatim] +\drums { + \clef treble + hh4 hh hh hh + \break + \clef percussion + bd4 bd bd bd +} +@end lilypond + There are a few issues concerning MIDI support for percussion instruments; for details please see @ref{Percussion in MIDI}. @@ -104,7 +119,7 @@ Notation Reference: @ref{Percussion notes}. File: -@file{ly/@/drumpitch@/-init@/.ly} +@file{ly/drumpitch-init.ly} Snippets: @rlsr{Percussion}. @@ -194,13 +209,11 @@ down = \drummode { The above example shows verbose polyphonic notation. The short polyphonic notation, described in @rlearning{I'm hearing Voices}, -can also be used if the voices are instantiated by hand first. +can also be used. For example, @lilypond[quote,verbatim] \new DrumStaff << - \new DrumVoice = "1" { s1*2 } - \new DrumVoice = "2" { s1*2 } \drummode { bd4 sn4 bd4 sn4 << { @@ -216,7 +229,7 @@ There are also other layout possibilities. To use these, set the property @code{drumStyleTable} in context @code{DrumVoice}. The following variables have been predefined: -@c FIXME: decide what to do about this table. (ie verbatim or not) +@c TODO: decide what to do about this table. (ie verbatim or not) @table @code @item drums-style @@ -236,7 +249,6 @@ mus = \drummode { \remove Time_signature_engraver \override Stem #'transparent = ##t \override Stem #'Y-extent = ##f - \override VerticalAxisGroup #'minimum-Y-extent = #'(-4.0 . 5.0) } \mus \new Lyrics \nam >> @@ -365,12 +377,13 @@ own list at the top of your file. @lilypond[quote,verbatim] #(define mydrums '( - (bassdrum default #f -1) - (snare default #f 0) - (hihat cross #f 1) - (pedalhihat xcircle "stopped" 2) - (lowtom diamond #f 3))) -up = \drummode { hh8 hh hh hh hhp4 hhp } + (bassdrum default #f -1) + (snare default #f 0) + (hihat cross #f 1) + (halfopenhihat cross "halfopen" 1) + (pedalhihat xcircle "stopped" 2) + (lowtom diamond #f 3))) +up = \drummode { hh8 hh hhho hhho hhp4 hhp } down = \drummode { bd4 sn bd toml8 toml } \new DrumStaff << @@ -383,7 +396,7 @@ down = \drummode { bd4 sn bd toml8 toml } @snippets -FIXME: MOVE ALL THESE TO LSR! -gp +@c TODO: MOVE ALL THESE TO LSR! -gp Here are some examples: @@ -401,8 +414,8 @@ woodstaff = { % It also defines the positions of the two lines. \override Staff.StaffSymbol #'line-positions = #'(-2 3) - % This is neccessary; if not entered, the barline would be too short! - \override Staff.BarLine #'bar-size = #3 + % This is necessary; if not entered, the barline would be too short! + \override Staff.BarLine #'bar-extent = #'(-1.5 . 1.5) } \new DrumStaff { @@ -420,7 +433,7 @@ woodstaff = { @end lilypond Note that in this special case the length of the barline must -altered with @code{\override Staff.BarLine #'bar-size #number}. +altered with @code{\override Staff.BarLine #'bar-extent #'(from . to)}. Otherwise it would be too short. And you have also to define the positions of the two stafflines. For more information about these delicate things have a look at @ref{Staff symbol}. @@ -432,7 +445,7 @@ A tambourine, entered with @q{tamb}: tambustaff = { \override Staff.StaffSymbol #'line-positions = #'( 0 ) - \override Staff.BarLine #'bar-size = #3 + \override Staff.BarLine #'bar-extent = #'(-1.5 . 1.5) \set DrumStaff.instrumentName = #"Tambourine" } @@ -458,7 +471,7 @@ Music for Tam-Tam (entered with @q{tt}): tamtamstaff = { \override Staff.StaffSymbol #'line-positions = #'( 0 ) - \override Staff.BarLine #'bar-size = #3 + \override Staff.BarLine #'bar-extent = #'(-1.5 . 1.5) \set DrumStaff.instrumentName = #"Tamtam" } @@ -481,7 +494,7 @@ Two different bells, entered with @q{cb} (cowbell) and @q{rb} (ridebell) bellstaff = { \override DrumStaff.StaffSymbol #'line-positions = #'(-2 3) \set DrumStaff.drumStyleTable = #(alist->hash-table mydrums) - \override Staff.BarLine #'bar-size = #3 + \override Staff.BarLine #'bar-extent = #'(-1.5 . 1.5) \set DrumStaff.instrumentName = #"Different Bells" } @@ -575,7 +588,7 @@ Ghost notes for drums and percussion may be created using the However, the default @code{\drummode} does not include the @code{Parenthesis_engraver} plugin which allows this. -@lilypond[quote,ragged-right,verbatim,fragment] +@lilypond[quote,ragged-right,verbatim] \new DrumStaff \with { \consists "Parenthesis_engraver" }