X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Fsimultaneous.itely;h=71b3a166ea86a5cd2a1ddbdbd679960078bc3828;hb=f38331f2a44d40bb22b1b0a321463d0eae05e1bf;hp=cf3beb3b78c11c6d5f7c9e5ed285ab0e6f2c600c;hpb=b47b8d7aa60e8049b397a26999e0ab45c0b7fe0e;p=lilypond.git diff --git a/Documentation/user/simultaneous.itely b/Documentation/user/simultaneous.itely index cf3beb3b78..71b3a166ea 100644 --- a/Documentation/user/simultaneous.itely +++ b/Documentation/user/simultaneous.itely @@ -9,6 +9,8 @@ @node Simultaneous notes @section Simultaneous notes +@lilypondfile[quote]{simultaneous-headword.ly} + Polyphony in music refers to having more than one voice occurring in a piece of music. Polyphony in LilyPond refers to having more than one voice on the same staff. @@ -28,7 +30,7 @@ than one voice on the same staff. @end menu @node Chorded notes -@unnumberedsubsubsec Chorded notes +@subsubsection Chorded notes @cindex Chords @@ -43,7 +45,15 @@ articulations, just like simple notes: For more information about chords, see @ref{Introducing chord names}. -@refbugs +@seealso + +Music Glossary: @rglos{chord}. + +Notation Reference: @ref{Introducing chord names}. + +Snippets: @lsrdir{Simultaneous,Simultaneous-notes}. + +@knownissues Music expressions like @code{<< @{ g8 e8 @} a4 >>} are not printed accurately. Use @code{8 8} instead. @@ -51,7 +61,7 @@ accurately. Use @code{8 8} instead. @node Clusters -@unnumberedsubsubsec Clusters +@subsubsection Clusters @cindex cluster @@ -71,11 +81,13 @@ clusters. @seealso -Program reference: @internalsref{ClusterSpanner}, +Snippets: @lsrdir{Simultaneous,Simultaneous-notes}. + +Internals Reference: @internalsref{ClusterSpanner}, @internalsref{ClusterSpannerBeacon}, @internalsref{Cluster_spanner_engraver}. -Examples: @lsr{contemporary,cluster@/.ly}. +Examples: @c @lsr{contemporary,cluster@/.ly}. @@ -89,7 +101,10 @@ Examples: @lsr{contemporary,cluster@/.ly}. @end menu @node Collision resolution -@unnumberedsubsubsec Collision resolution +@subsubsection Collision resolution + +@cindex merging notes +@cindex note collisions Normally, note heads with a different number of dots are not merged, but when the object property @@ -119,7 +134,7 @@ c8 c4. } \\ { c2 c2 } >> @noindent @code{merge-differently-headed} and @code{merge-differently-dotted} only apply to opposing stem -directions (ie. Voice 1 & 2). +directions (i.e. Voice 1 & 2). LilyPond also vertically shifts rests that are opposite of a stem, for example @@ -128,6 +143,8 @@ for example \new Voice << c''4 \\ r4 >> @end lilypond +@cindex shift note + If three or more notes line up in the same column, @code{merge-differently-headed} cannot successfully complete the merge of the two notes that should be merged. To allow the merge @@ -152,6 +169,10 @@ move the top @code{g} out of the column, and >> @end lilypond +@cindex multiple voices +@cindex polyphonic music +@cindex shifting voices + In some instances of complex polyphonic music, you may need additional voices to avoid collisions between notes. Additional voices are added by defining an variable, as shown below: @@ -169,7 +190,7 @@ voiceFive = #(context-spec-music (make-voice-props-set 4) 'Voice) -@refcommands +@predefined @funindex \oneVoice @code{\oneVoice}, @@ -182,6 +203,19 @@ voiceFive = #(context-spec-music (make-voice-props-set 4) 'Voice) @funindex \voiceFour @code{\voiceFour}. +@funindex \voiceNeutralStyle +@funindex \voiceOneStyle +@funindex \voiceTwoStyle +@funindex \voiceThreeStyle +@funindex \voiceFourStyle +@example +\voiceNeutralStyle +\voiceOneStyle +\voiceTwoStyle +\voiceThreeStyle +\voiceFourStyle +@end example + @funindex \shiftOn @code{\shiftOn}, @funindex \shiftOnn @@ -215,12 +249,14 @@ override typesetting decisions. @seealso -Program reference: the objects responsible for resolving +Snippets: @lsrdir{Simultaneous,Simultaneous-notes}. + +Internals Reference: the objects responsible for resolving collisions are @internalsref{NoteCollision} and @internalsref{RestCollision}. -@refbugs +@knownissues When using @code{merge-differently-headed} with an upstem eighth or a shorter note, and a downstem half note, the eighth note gets @@ -233,9 +269,10 @@ cluster notation (see @ref{Clusters}). @node Automatic part combining -@unnumberedsubsubsec Automatic part combining +@subsubsection Automatic part combining @cindex automatic part combining @cindex part combiner +@cindex combining parts Automatic part combining is used to merge two parts of music onto a staff. It is aimed at typesetting orchestral scores. When the @@ -253,7 +290,7 @@ The syntax for part combining is The following example demonstrates the basic functionality of the part combiner: putting parts on one staff, and setting stem -directions and polyphony +directions and polyphony. @lilypond[quote,verbatim,ragged-right,fragment] \new Staff \partcombine @@ -269,7 +306,7 @@ and @q{Solo}, while the second (called @code{two}) always gets down stems and @q{Solo II}. If you just want the merging parts, and not the textual markings, -you may set the property @code{printPartCombineTexts} to false +you may set the property @code{printPartCombineTexts} to false. @lilypond[quote,verbatim,ragged-right,fragment,relative=2] \new Staff << @@ -313,11 +350,15 @@ has no effect on the pitches of @var{musicexpr1} and @seealso -Program reference: @internalsref{PartCombineMusic}. +Music Glossary: @rglos{a due}. + +Snippets: @lsrdir{Simultaneous,Simultaneous-notes}. -@refbugs +Internals Reference: @internalsref{PartCombineMusic}, @internalsref{Voice}. -When @code{printPartCombineTexts} is set, when the two voices play +@knownissues + +When @code{printPartCombineTexts} is set, if the two voices play the same notes on and off, the part combiner may typeset @code{a2} more than once in a measure. @@ -333,12 +374,12 @@ events in those will be ignored. @node Writing music in parallel -@unnumberedsubsubsec Writing music in parallel +@subsubsection Writing music in parallel @cindex Writing music in parallel @cindex Interleaved music -Music for multiple parts can be interleaved +Music for multiple parts can be interleaved: @lilypond[quote,fragment,verbatim] \parallelMusic #'(voiceA voiceB) { @@ -353,7 +394,7 @@ Music for multiple parts can be interleaved >> @end lilypond -This works quite well for piano music +This works quite well for piano music. @c It would be nice if the first bar fit onto one 66-char line. @c Maybe simplify the example? -gp @@ -400,5 +441,7 @@ music = { } @end lilypond +@seealso +Snippets: @lsrdir{Simultaneous,Simultaneous-notes}