CVSROOT: /cvsroot/lilypond
Module name: lilypond
Branch:
Changes by: Graham Percival <[EMAIL PROTECTED]> 05/07/07 05:16:53
Modified files:
. : THANKS ChangeLog
Documentation/user: advanced-notation.itely
changing-defaults.itely
Log message:
Misc stuff.
CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/lilypond/lilypond/THANKS.diff?tr1=1.129&tr2=1.130&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/lilypond/lilypond/ChangeLog.diff?tr1=1.3850&tr2=1.3851&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/lilypond/lilypond/Documentation/user/advanced-notation.itely.diff?tr1=1.36&tr2=1.37&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/lilypond/lilypond/Documentation/user/changing-defaults.itely.diff?tr1=1.130&tr2=1.131&r1=text&r2=text
Patches:
Index: lilypond/ChangeLog
diff -u lilypond/ChangeLog:1.3850 lilypond/ChangeLog:1.3851
--- lilypond/ChangeLog:1.3850 Fri Jul 1 12:53:03 2005
+++ lilypond/ChangeLog Thu Jul 7 05:16:53 2005
@@ -1,3 +1,11 @@
+2005-07-06 Graham Percival <[EMAIL PROTECTED]>
+
+ * Documentation/user/changing-defaults.itely: add link
+ to grob-iterface.
+
+ * Documentation/user/advanced-notation.itely: add material
+ to Setting automatic beam behaviour. Thanks, Joe!
+
2005-07-01 Mats Bengtsson <[EMAIL PROTECTED]>
* Documentation/user/advanced-notation.itely (Setting automatic
Index: lilypond/Documentation/user/advanced-notation.itely
diff -u lilypond/Documentation/user/advanced-notation.itely:1.36
lilypond/Documentation/user/advanced-notation.itely:1.37
--- lilypond/Documentation/user/advanced-notation.itely:1.36 Fri Jul 1
12:53:03 2005
+++ lilypond/Documentation/user/advanced-notation.itely Thu Jul 7 05:16:53 2005
@@ -2243,40 +2243,104 @@
In normal time signatures, automatic beams can start on any note but can
only end in a few positions within the measure: beams can end on a beat,
or at durations specified by the properties in
[EMAIL PROTECTED] The defaults for @code{autoBeamSettings}
-are defined in @file{scm/@/auto@/-beam@/.scm}.
[EMAIL PROTECTED] The properties in @code{autoBeamSettings}
+consist of a list of rules for where beams can begin and end. The
+default @code{autoBeamSettings} rules are defined in
[EMAIL PROTECTED]/@/auto@/-beam@/.scm}.
-The value of @code{autoBeamSettings} is changed with three functions,
+In order to add a rule to the list, use
@example
-#(override-auto-beam-setting
- '(@var{be} @var{p} @var{q} @var{n} @var{m}) @var{a} @var{b}
- [EMAIL PROTECTED])
-#(score-override-auto-beam-setting
- '(@var{be} @var{p} @var{q} @var{n} @var{m}) @var{a} @var{b})
-#(revert-auto-beam-setting '(@var{be} @var{p} @var{q} @var{n} @var{m})
- @var{a} @var{b} [EMAIL PROTECTED])
+#(override-auto-beam-setting '(be p q n m) a b [context])
@end example
-Here, @var{be} is the symbol @code{begin} or @code{end}, and
[EMAIL PROTECTED] is an optional context (default: @code{'Voice}). It
-determines whether the rule applies to begin or end-points. The
-quantity @var{p}/@var{q} refers to the length of the beamed notes (and
[EMAIL PROTECTED] *}' designates notes of any length), @var{n}/@var{M} refers
-to a time signature (wildcards [EMAIL PROTECTED] *}' may be entered to
-designate all time signatures), @var{a}/@var{b} is a duration. By
-default, this command changes settings for the current voice. It is
-also possible to adjust settings at higher contexts, by adding a
[EMAIL PROTECTED] argument. @code{score-override-auto-beam-setting} is
-equal to @code{override-auto-beam-setting} with the argument
[EMAIL PROTECTED] set to @code{'Score}.
-For example, if automatic beams should end on the first quarter note, use
-the following
[EMAIL PROTECTED] @bullet
+
[EMAIL PROTECTED] @code{be} is either "begin" or "end".
+
[EMAIL PROTECTED] @code{b/q} is the duration of the note for which you want
+to add a rule. A beam is considered to have the duration of its
+shortest note. Set @code{p} and @code{q} to @code{'*'} to
+have this apply to any beam.
+
[EMAIL PROTECTED] @code{n/m} is the position in the time signature to which
+this rule should apply. Set @code{n} and @code{m} to @code{'*'}
+to have this apply in any time signature.
+
[EMAIL PROTECTED] @code{a/b} is the position in the bar at which the beam
should end.
+
[EMAIL PROTECTED] @code{context} is optional, and it specifies the context at
which
+the change should be made. The default is @code{'Voice}.
[EMAIL PROTECTED](score-override-auto-beam-setting '(A B C D) E F)} is
equivalent to
[EMAIL PROTECTED](override-auto-beam-setting '(A B C D) E F 'Score)}.
+
[EMAIL PROTECTED] itemize
+
+For example, if automatic beams should always end on the first quarter
+node, use
+
@example
-#(override-auto-beam-setting '(end * * * *) 1 4 'Staff)
+#(override-auto-beam-setting '(end * * * *) 1 4)
[EMAIL PROTECTED] example
+
+You can force the beam settings to only take effect on beams whose shortest
+note is a certain duration
+
[EMAIL PROTECTED],fragment,raggedright,verbatim,relative=2]
+\time 2/4
+#(override-auto-beam-setting '(end 1 16 * *) 1 16)
+a16 a a a a a a a |
+a32 a a a a16 a a a a a |
+#(override-auto-beam-setting '(end 1 32 * *) 1 16)
+a32 a a a a16 a a a a a |
[EMAIL PROTECTED] lilypond
+
+You can force the beam settings to only take effect in certain time
+signatures
+
[EMAIL PROTECTED],fragment,raggedright,verbatim,relative=2]
+\time 5/8
+#(override-auto-beam-setting '(end * * 5 8) 2 8)
+c8 c d d d
+\time 4/4
+e8 e f f e e d d
+\time 5/8
+c8 c d d d
[EMAIL PROTECTED] lilypond
+
+You can also remove a previously set beam-ending rule by using
+
[EMAIL PROTECTED]
+#(revert-auto-beam-setting '(be p q n m) a b [context])
@end example
-Since the duration of a quarter note is 1/4 of a whole note, it is
-entered as @code{(ly:make-moment 1 4)}.
[EMAIL PROTECTED]
+be, p, q, n, m, a, b and context are the same as above. Note that the
+default rules are specified in @file{scm/@/auto@/-beam@/.scm},
+so you can revert rules that you did not explicitly create.
+
[EMAIL PROTECTED],fragment,raggedright,verbatim,relative=2]
+\time 4/4
+a16 a a a a a a a a a a a a a a a
+#(revert-auto-beam-setting '(end 1 16 4 4) 1 4)
+a16 a a a a a a a a a a a a a a a
[EMAIL PROTECTED] lilypond
+
+The rule in a revert-auto-beam-setting statement must exactly match the
+original rule. That is, no wildcard expansion is taken into account.
+
[EMAIL PROTECTED],fragment,raggedright,verbatim,relative=2]
+\time 1/4
+#(override-auto-beam-setting '(end 1 16 1 4) 1 8)
+a16 a a a
+#(revert-auto-beam-setting '(end 1 16 * *) 1 8) % this won't revert it!
+a a a a
+#(revert-auto-beam-setting '(end 1 16 1 4) 1 8) % this will
+a a a a
[EMAIL PROTECTED] lilypond
+
+
+
[EMAIL PROTECTED] TODO: old material -- not covered by above stuff, I think.
If automatic beams should end on every quarter in 5/4 time, specify
all endings
@example
@@ -2298,40 +2362,14 @@
3/8 and on the fourth beat of the measure (after 3/4, that is 2 times
3/8, has passed within the measure).
-Rules can also be restricted to specific time signatures. A rule that
-should only be applied in @var{N}/@var{M} time signature is formed by
-replacing the second asterisks by @var{N} and @var{M}. For example, a
-rule for 6/8 time exclusively looks like
[EMAIL PROTECTED]
-#(override-auto-beam-setting '(begin * * 6 8) @dots{})
[EMAIL PROTECTED] example
-
-If a rule should be to applied only to certain types of beams, use the
-first pair of asterisks. Beams are classified according to the
-shortest note they contain. For a beam ending rule that only applies
-to beams with 32nd notes (and no shorter notes), use @code{(end 1 32 *
-*)}.
-
-For example,
-
[EMAIL PROTECTED],raggedright,relative=2,fragment,verbatim]
-\time 5/8
-#(override-auto-beam-setting '(end * * 5 8) 2 8)
-c8 c d d d
-\time 4/4
-e8 e f f e e d d
-\time 5/8
-c8 c d d d
[EMAIL PROTECTED] lilypond
-
@cindex automatic beam generation
@cindex autobeam
@cindex @code{autoBeaming}
@cindex lyrics
If beams are used to indicate melismata in songs, then automatic
-beaming should be switched off. This is done by setting
[EMAIL PROTECTED] to @code{#f}.
+beaming should be switched off with @code{\autoBeamOff}.
+
@refcommands
Index: lilypond/Documentation/user/changing-defaults.itely
diff -u lilypond/Documentation/user/changing-defaults.itely:1.130
lilypond/Documentation/user/changing-defaults.itely:1.131
--- lilypond/Documentation/user/changing-defaults.itely:1.130 Tue May 24
19:09:20 2005
+++ lilypond/Documentation/user/changing-defaults.itely Thu Jul 7 05:16:53 2005
@@ -1070,7 +1070,8 @@
layout object called @internalsref{Fingering}. Such an object is a
symbol within the score. It has properties that store numbers (like
thicknesses and directions), but also pointers to related objects. A
-layout object is also called @emph{grob},
+layout object is also called
[EMAIL PROTECTED],
@cindex grob
which is short for Graphical Object.
Index: lilypond/THANKS
diff -u lilypond/THANKS:1.129 lilypond/THANKS:1.130
--- lilypond/THANKS:1.129 Wed Jun 29 11:32:52 2005
+++ lilypond/THANKS Thu Jul 7 05:16:53 2005
@@ -10,6 +10,10 @@
Graham Percival - Documentation Editor
+CONTRIBUTORS
+Joe Neeman
+
+
SPONSORS
Sven Axelsson
_______________________________________________
Lilypond-cvs mailing list
Lilypond-cvs@gnu.org
http://lists.gnu.org/mailman/listinfo/lilypond-cvs
