1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
2 @c This file is part of lilypond-learning.tely
4 Translation of GIT committish: 5cf864d550e7148412d594cf336841791bff6f76
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. See TRANSLATION for details.
13 @chapter Tweaking output
15 In diesem Kapitel wird erklärt, wie man die Notenausgabe verändern
16 kann. In LilyPond kann man sehr viel konfigurieren, fast jedes
17 Notenfragment kann geändert werden.
22 * The Internals Reference manual::
23 * Appearance of objects::
24 * Placement of objects::
25 * Collisions of objects::
31 @section Tweaking basics
34 * Introduction to tweaks::
35 * Objects and interfaces::
36 * Naming conventions of objects and properties::
40 @node Introduction to tweaks
41 @subsection Introduction to tweaks
43 @qq{Optimierung} (engl. tweaking) ist ein LilyPond-Begriff für die
44 verschiedenen Methoden, die Aktionen zu beeinflussen, die während
45 der Kompilation einer Notationsdatei vorgenommen werden sowie auf
46 das Notenbild einzuwirken. Einige dieser Opitmierungen sind sehr
47 einfach, andere dagegen recht komplex. Aber insgesamt erlaubt das
48 System an Optimierungen so gut wie alle möglichen Erscheindungsformen
51 In diesem Abschnitt werden die grundlegenden Konzepte vorgestellt,
52 um die Optimierung zu verstehen. Später soll eine Anzahl von fertigen
53 Befehlen bereitgestellt werden, die einfach in die Quelldatei
54 kopiert werden können um den selben Effekt wie im Beispiel
55 zu erhalten. Gleichzeitig zeigen diese Beispiele, wie die Befehle
56 konstruiert werden, so dass Sie in der Lage sein werden, eigene
57 Befehle auf dieser Grundlage zu entwickeln.
59 Bevor Sie mit diesem Kapitel beginnen, könnte Sie ein Blick in den
60 Abschnitt @ref{Contexts and engravers} interessieren, dann
61 Kontexte und Engraver sowie die Eigenschaften, die mit ihnen
62 verknüpft sind, sind die Voraussetzung, um die Funktionsweise
63 von Optimierungen verstehen zu können.
66 @node Objects and interfaces
67 @subsection Objects and interfaces
74 @cindex Schnittstellen
75 @cindex graphische Objekte (Grob)
76 @cindex Objekteigenschaften
78 @cindex Objekt, Layout-
79 @cindex Eigenschaften von Objekten
81 Optimierung bedeutet, die internen Operationen und Strukturen
82 des LilyPond-Programmes zu verändern, darum sollen hier
83 zunächst die wichtigesten Begriffe erklärt werden, die zur
84 Beschreibung dieser Operationen und Strukturen benutzt werden.
86 Der Begriff @qq{Objekt} ist ein allgemeiner Begriff, mit dem
87 die Vielzahl an internen Strukturen bezeichnet wird, die LilyPond
88 während der Bearbeitung des Quelltextes erstellt. Wenn etwa
89 ein Befehl wie @code{\new Staff} auftritt, wird ein neues Objekt
90 vom Typ @code{Staff} erstellt. Dieses Objekt @code{Staff} enthält
91 dann alle Eigenschaften, die mit diesem speziellen Notensystem
92 verknüpft sind, wie beispielsweise seine Bezeichnung, Tonart und
93 spezifische Angaben über die Engraver, die innerhalb dieses Systems
94 eingesetzt werden. Für alle anderen Kontexte gibt es genauso
95 Objekte, die deren Eigenschaften beinhalten, beispielsweise für
96 @code{Voice}-Objekte, @code{Score}-Objekte, @code{Lyrics}-Objekte,
97 aber auch für Objekte, die Notationselemente wie die Taktlinien,
98 Notenköpfe, Bögen und Dynamikbezeichnung enthalten. Jedes
99 Objekt hat eine eigene Gruppe an Eigenschaftswerten.
101 Bestimmte Objekttypen tragen besondere Bezeichnungen. Objekte, die
102 Notationselemente der gesetzten Ausgabe repräsentieren, also
103 Notenköpfe, Hälse, Bögen, Fingersatz, Schlüssel usw., werden
104 @qq{Layout-Objekte}, oft auch @qq{Graphische Objekte} genannt.
105 Daraus resultiert die künstliche Abkürzung @qq{Grob}.
106 Diese sind auch Objekte im allgemeinen Sinn und haben genauso
107 Eigenschaften, die mit ihnen verknüpft sind, wie etwa Größe, Position,
110 Einige Layout-Objekte sind etwas spezieller. Phrasierungsbögen,
111 Crescendo-Klammern, Oktavierungszeichen und viele andere
112 Grobs sind nicht an einer Stelle plaziert -- sie haben vielmehr
113 einen Anfangspunkt, einen Endpunkt und eventuell noch andere
114 Eigenschaften, die ihre Form bestimmen. Objekte mit solch
115 einer erweiterten Gestalt werden als @qq{Strecker} (engl. Spanners)
118 Es bleibt uns noch übrig zu erklären, was @qq{Schnittstellen}
119 (engl. interface) sind. Wenn auch viele Objekte sehr unterschiedlich
120 sind, haben sie doch oft gemeinsame Eigenschaften, die auf
121 die gleiche Weise verarbeitet werden. Alle Grobs beispielsweise
122 haben eine Farbe, eine Größe, eine Position usw. und alle
123 diese Eigenschaften werden von LilyPond auf die gleiche Weise
124 verarbeitet, während der Quelltext in Notensatz umgesetzt wird.
125 Um die internen Operationen zu vereinfachen, sind alle diese
126 gemeinsamen Prozesse und Eigenschaften in einem Objekt
127 mit der Bezeichnung @code{grob-interface} (Schnittstelle eines
128 graphischen Objektes) zusammengefasst. Es gibt viele andere
129 Gruppen gemeinsamer Eigenschaften, die jede eine Bezeichnung
130 besitzen, welche auf @code{-interface} endet. Insgesamt
131 gibt es über 100 dieser Schnittstellen. Wir werden später sehen,
132 was es damit auf sich hat.
134 Dies waren die Hauptbegriffe, die in diesem Kapitel zur Anwendung
138 @node Naming conventions of objects and properties
139 @subsection Naming conventions of objects and properties
141 @cindex Benennungskonventionen für Objekte
142 @cindex Benennungskonventionen für Eigenschaften
143 @cindex Objekte, Benennungskonventionen
144 @cindex Eigenschaften, Benennungskonventionen
145 @cindex Regeln zur Benennung von Objekten/Eigenschaften
147 Es wurden schon früher einige Regeln zur Benennung von
148 Objekten vorgestellt, siehe
149 @ref{Contexts and engravers}. Hier eine Referenzliste der
150 häufigsten Objekt- und Eigenschaftsbezeichnungen mit
151 den Regeln für ihre Bezeichnung und
152 illustrierenden echten Bezeichnungen. Es wurde @qq{A}
153 für einen beliebigen Großbuchstaben und @qq{aaa} für eine
154 beliebige Anzahl an Kleinbuchstaben eingesetzt. Andere
155 Zeichen werden explizit angegeben.
157 @multitable @columnfractions .33 .33 .33
158 @headitem Objekt-/Eigenschaftstyp
159 @tab Naming convention
162 @tab Aaaa oder AaaaAaaaAaaa
163 @tab Staff, GrandStaff
165 @tab Aaaa oder AaaaAaaaAaaa
168 @tab Aaaa_aaa_engraver
169 @tab Clef_engraver, Note_heads_engraver
171 @tab aaa-aaa-interface
172 @tab grob-interface, break-aligned-interface
173 @item Kontext-Eigenschaften
174 @tab aaa oder aaaAaaaAaaa
175 @tab alignAboveContext, skipBars
176 @item Layout-Objekt-Eigenschaften
177 @tab aaa oder aaa-aaa-aaa
178 @tab direction, beam-thickness
181 Es wird bald ersichtlich werden, dass die Eigenschaften von
182 unterschiedlichen Objekttypen mit unterschiedlichen Befehlen
183 geändert werden. Deshalb ist es nützlich, aus der
184 Schreibweise zu erkennen, um was
185 für ein Objekt es sich handelt, um den entsprechenden
186 Befehl einsetzen zu können.
189 @node Tweaking methods
190 @subsection Tweaking methods
192 @cindex override-Befehl
196 @strong{Der \override-Befehl}
198 Wir haben uns schon mit den Befehlen @code{\set}
199 und @code{\with} bekannt gemacht, mit welchen
200 Eigenschaften von @strong{Kontexten} verändert
201 und @strong{Engraver} entfernt oder hinzugefügt
202 werden können. Siehe dazu
203 @ref{Modifying context properties} und @ref{Adding
204 and removing engravers}. Jetzt wollen wir uns weitere
205 wichtige Befehle anschauen.
207 Der Befehl, um die Eigenschaften von @strong{Layout-Objekten}
208 zu ändern, ist @code{\override}. Weil dieser Befehl interne
209 Eigenschaften tief in der Programmstruktur von LilyPond
210 verändern muss, ist seine Syntax nicht so einfach wie die der
211 bisherigen Befehle. Man muss genau wissen, welche Eigenschaft
212 welches Objektes in welchem Kontext geändert werder soll,
213 und welches der neu zu setzende Wert dann ist. Schauen wir
214 uns an, wie das vor sich geht.
216 Die allgemeine Syntax dieses Befehles ist:
219 \override @var{Kontext}.@var{LayoutObjekt} #'@var{layout-eigenschaft} =
224 Damit wir die Eigenschaft mit der Bezeichnung @var{layout-property}
225 das Layout-Objektes mit der Bezeichnung@var{LayoutObject},
226 welches ein Mitglied des @var{Kontext}-Kontextes ist, auf den
229 Der @var{Kontext} kann (und wird auch normalerweise) ausgelassen
230 werden, wenn der benötigte Kontext eindeutig impliziert ist und einer
231 der untersten Kontexte ist, also etwa @code{Voice}, @code{ChordNames}
232 oder @code{Lyrics}. Auch in diesem Text wird der Kontext oft ausgelassen
233 werden. Später soll gezeigt werden, in welchen Fällen er ausdrücklich
234 definiert werden muss.
236 Spätere Abschnitte behandeln umfassend Eigenschaften und ihre
237 Werte, aber um ihre Funktion und ihr Format zu demonstrieren,
238 werden wir hier nur einige einfache Eigenschaften und Werte einsetzen,
239 die einfach zu verstehen sind.
241 Für den Moment könne Sie die @code{#'}-Zeichen ignorieren, die vor jeder
242 Layout-Eigenschaft, und die @code{#}-Zeichen, die vor jedem Wert
243 stehen. Sie müssen immer in genau dieser Form geschrieben werden.
244 Das ist der am häufigsten gebrauchte Befehl für die Optimierung,
245 und der größte Teil dieses Abschnittes wird dazu benutzt, seine Benutzung
246 zu erläutern. Hier ein einfaches Beispiel, um die Farbe des Notenkopfes
249 @cindex color-Eigenschaft, Beispiel
250 @cindex Farb-Eigenschaft, Beispiel
251 @cindex NoteHead, Beispiel für override
252 @cindex Notenkopf, Beispiel für Veränderung
254 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
256 \override NoteHead #'color = #red
258 \override NoteHead #'color = #green
263 @strong{Der \revert-Befehl}
265 @cindex revert-Befehl
269 Wenn eine Eigenschaft einmal überschrieben wurde, wird ihr
270 neuer Wert so lange bewahrt, bis er noch einmal überschrieben
271 wird oder ein @code{\revert}-Befehl vorkommt. Der
272 @code{\revert}-Befehl hat die folgende Syntax und setzt den
273 Wert der Eigenschaft zurück auf den Standardwert, nicht
274 jedoch auf den vorigen Wert, wenn mehrere
275 @code{\override}-Befehle benutzt wurden.
278 \revert @var{Kontext}.@var{LayoutObjekt} #'@var{layout-eigenschaft}
281 Wiederum, genauso wie der @var{Kontext} bei dem @code{\override}-Befehl,
282 wird @var{Kontext} oft nicht benötigt. Er wird in vielen der folgenden
283 Beispiele ausgelassen. Im nächsten Beispiel wird die Farbe des Notenkopfes
284 wieder auf den Standardwert für die letzten zwei Noten gesetzt.
286 @cindex color-Eigenschaft, Beispiel
287 @cindex Farb-Eigenschaft, Beispiel
288 @cindex NoteHead, Beispiel für override
289 @cindex Notenkopf, Beispiel für Veränderung
291 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
293 \override NoteHead #'color = #red
295 \override NoteHead #'color = #green
297 \revert NoteHead #'color
301 @strong{\once-Präfix}
306 Sowohl der @code{\override}-Befehl als auch der @code{\set}-Befehl können mit
307 dem Präfix @code{\once} (@emph{einmal}) versehen werden. Dadurch wird
308 der folgende @code{\override}- oder @code{\set}-Befehl nur für den aktuellen
309 Musik-Moment wirksam, bevor sich wieder der Standard einstellt. Am gleichen
310 Beispiel demonstriert, kann damit die Farbe eines einzelnen Notenkopfes
313 @cindex color-Eigenschaft, Beispiel
314 @cindex Farb-Eigenschaft, Beispiel
315 @cindex NoteHead, Beispiel für override
316 @cindex Notenkopf, Beispiel für Veränderung
318 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
320 \once \override NoteHead #'color = #red
322 \once \override NoteHead #'color = #green
327 @strong{Der \overrideProperty-Befehl}
329 @cindex overrideProperty-Befehl
331 @funindex \overrideProperty
332 @funindex overrideProperty
334 Es gibt eine andere Form des @code{override}-Befehls,
335 @code{\overrideProperty} (überschreibe Eigenschaft),
336 welcher ab und zu benötigt wird. Es wird hier nur der
337 Vollständigkeit halber erwähnt, sein Einsatz wird demonstriert
338 in @ruser{Difficult tweaks}.
339 @c Maybe explain in a later iteration -td
342 @strong{Der \tweak-Befehl}
348 Der letzte Optimierungsbefehl in LilyPond ist @code{\tweak}
349 (engl. optimieren). Er wird eingesetzt um Eigenschaften
350 von Objekten zu verändern, die zum selben Musik-Moment
351 auftreten, wie etwa die Noten eines Akkordes. Ein
352 @code{\override} würde alle Noten des Akkords beeinflussen,
353 während mit @code{\tweak} nur das nächste Objekt der
354 Eingabe geändert wird.
356 Hier ein Beispiel. Angenommen, die Größe des mittleren
357 Notenkopfes (ein E) in einem C-Dur-Akkord soll geändert
358 werden. Schauen wir zuerst, was wir mit
359 @code{\once \override} erhalten:
361 @cindex Schriftgröße, Beispiel
362 @cindex NoteHead, Beispiel für override
363 @cindex Notenkopf, Beispiel für Veränderung
365 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
367 \once \override NoteHead #'font-size = #-3
372 Wie man sehen kann, beeinflusst @code{override} @emph{alle}
373 Notenköpfe des Akkordes. Das liegt daran, dass alle die Noten
374 eines Akkordes zum selben Musik-Moment auftreten und
375 die Funktion von @code{\once} ist es, die Optimierung auf
376 an allen Objekten auszuführen, die zum selben Musik-Moment
377 auftreten wie der @code{\override}-Befehl.
379 Der @code{\tweak}-Befehl funktioniert anders. Er bezieht sich
380 auf das direkt folgende Element in der Eingabe-Datei. Es wirkt
381 aber auch nur mit Objekten, die direkt von der Eingabe kreirt
382 werden, insbesondere Notenköpfe und Artikulationszeichen.
383 Objekte wie etwa Hälse oder Versetzungszeichen werden erst
384 später erstellt und lassen sich nicht auf diese Weise ändern.
385 Zusätzlich @emph{müssen} sich etwa Notenköpfe innerhalb
386 eines Akkordes befinden, d. h. sie müssen von einfachen spitzen
387 Klammern umschlossen sein. Um also eine einzelne Note
388 mit @code{\tweak} zu verändern, muss der Befehl innerhalb
389 der spitzen Klammern zusammen mit der Note eingegeben werden.
391 Um also zu unserem Beispiel zurückzukommen, könnte man die
392 mittlere Note eines Akkordes auf diese Weise ändern:
394 @cindex font-size-Eigenschaft, Beispiel
395 @cindex Schriftgröße, Beispiel
396 @cindex @code{\tweak}-Beispiel
398 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
400 <c \tweak #'font-size #-3 e g>4
403 Beachten Sie, dass die Syntax des @code{\tweak}-Befehls sich
404 von der des @code{\override}-Befehls unterscheidet. Weder
405 Kontext noch Layout-Objekt konnen angegeben werden, denn
406 das würde zu einem Fehler führen. Beide Angaben sind
407 durch das folgende Element impliziert. Hier sollte auch
408 kein Gleichheitzeichen vorhanden sein. Die verallgemeinerte
409 Syntax des @code{\tweak}-Befehls ist also einfach
412 \tweak #'@var{layout-eigenschaft} #@var{Wert}
415 Ein @code{\tweak}-Befehl kann auch benutzt werden, um nur
416 eine von mehreren Artikulationen zu ändern, wie im nächsten
417 Beispiel zu sehen ist.
419 @cindex Farb-Eigenschaft, Beispiel
420 @cindex @code{\tweak}-Beispiel
422 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
424 -\tweak #'color #red ^Red
425 -\tweak #'color #green _Green
429 Beachten Sie, dass dem @code{\tweak}-Befehl ein Artikulationsmodifikartor
430 vorangestellt werden muss, ganz als ob er selbst ein Artikulationszeichen
433 @cindex Triolen, geschachtelt
434 @cindex N-tolen, geschachtelt
435 @cindex Klammer, Triole
436 @cindex Triolenklammer
437 @cindex N-tolenklammer
438 @cindex Komplizierte Rhythmen, Schachtelung von
439 @funindex TupletBracket
441 Der @code{\tweak}-Befehl muss auch benutzt werden, wenn das
442 Aussehen einer vor mehreren geschachtelten Triolenklammern
443 geändert werden soll, die zum selben Zeitpunkt beginnen.
444 Im folgenden Beispiel beginnen die lange Klammer und die
445 erste Triolenklammer zum selben Zeitpunkt, sodass ein
446 @code{\override}-Befehl sich auf beide beziehen würde.
447 In dem Beispiel wird @code{\tweak} benutzt, um zwischen
448 ihnen zu unterscheiden. Der erste @code{\tweak}Befehl
449 gibt an, dass die lange Klammer über den Noten gesetzt
450 werden soll, und der zweite, dass die Zahl der rhythmischen
451 Aufteilung für die erste der kurzen Klammern in rot
454 @cindex Farb-Eigenschaft, Beispiel
455 @cindex @code{\tweak}-Beispiel
456 @cindex Richtungs-Eigenschaft, Beispiel
457 @cindex color-Eigenschaft, Beispiel
458 @cindex direction-Eigenschaft, Beispiel
460 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
461 \tweak #'direction #up
464 \times 2/3 { c8[ c8 c8] }
465 \times 2/3 { c8[ c8 c8] }
466 \times 2/3 { c8[ c8 c8] }
470 Wenn geschachtelte N-tolen nicht zum gleichen Zeitpunkt
471 beginnen, kann ihr Aussehen auf die übliche Art mit dem
472 @code{\override}-Befehl geändert werden:
474 @cindex text-Eigenschaft, Beispiel
475 @cindex tuplet-number-Funktion, Beispiel
476 @cindex transparent-Eigenschaft, Beispiel
477 @cindex TupletNumber, Beispiel zur Veränderung
478 @cindex Triolennummer, Beispiel zur Veränderung
479 @cindex Triolen-Nummer-Funktion, Beispiel
481 @c NOTE Tuplet brackets collide if notes are high on staff
483 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
484 \times 2/3 { c8[ c c]}
485 \once \override TupletNumber
486 #'text = #tuplet-number::calc-fraction-text
490 \once \override TupletNumber #'transparent = ##t
491 \times 2/3 { c8[ c c] }
492 \times 2/3 { c8[ c c]}
499 @ruser{The tweak command}.
502 @node The Internals Reference manual
503 @section The Internals Reference manual
506 * Properties of layout objects::
507 * Properties found in interfaces::
508 * Types of properties::
511 @node Properties of layout objects
512 @subsection Properties of layout objects
514 @cindex Eigenschaften von Layout-Objekten
515 @cindex Eigenschaften von Grobs
516 @cindex Grobs, Eigenschaften von
517 @cindex Layout-Objekte, Eigenschaften von
518 @cindex Property (Layout-Objekte, Grobs)
519 @cindex Regerenz der Interna
521 Angenommen, in Ihrer Partitur tritt ein Legatobogen
522 auf, der Ihrer Meinung nach zu dünn ausgefallen ist.
523 Sie würden ihn gerne etwas schwerer gezeichnet
524 sehen. Wie gehen Sie vor? Von den Anmerkungen in
525 früheren Abschnitten wissen Sie schon, dass LilyPond
526 sehr flexibel ist und eine derartige Modifikation
527 möglich sein sollte, und Sie erraten vielleicht,
528 dass ein @code{\override}-Befehl angebracht ist.
529 Aber gibt es eine Eigenschaft für die Dicke eines
530 Legatobogens (engl. slur), und wenn es sie gibt,
531 auf welche Weise lässt sie sich verändern? Hier
532 kommt die Referenz der Interna zur Geltung. Dort
533 finden sich alle Informationen, um den beschriebenen
534 und alle anderen @code{\override}-Befehle zu
537 Bevor Sie jetzt in die Referenz der Interna wechseln, ist
538 eine Warnung angebracht. Es handelt sich um ein
539 @strong{Referenz}dokument, was heißt, dass es sehr
540 wenig oder gar keine Erklärungen enthält: seine Aufgabe
541 ist es, Information klar und genau darzustellen. Das
542 bedeutet, dass es auf den ersten Blick entmutigend
543 wirkt. Die Einführung und Erklärung in diesem Abschnitt
544 wird Ihnen aber schnell ermöglichen, genau die Information
545 aus der Referenz zu entnehmen, die Sie benötigen.
547 Beachten Sie, dass die Referenz der Interna nur auf Englisch
548 existiert. Um die Eigenschaftsbezeichnung eines bestimmten
549 Objektes zu finden, können Sie das Glossar (siehe
550 @rglosnamed{Top,Musikglossar})
552 die englischen Begriffe in viele andere Sprachen übersetzt sind.
554 @cindex Override-Beispiel
555 @cindex Referenz der Interna, Benutzung
556 @cindex IR (Referenz der Interna), Benutzung
557 @cindex @code{\addlyrics}-Beispiel
559 Das Vorgehen soll an einem konkreten Beispiel einer echten
560 Komposition demonstriert werden. Hier das Beispiel:
562 @lilypond[quote,verbatim,relative=2]
567 g[( e]) e d[( f]) a |
571 The man who feels love's sweet e -- mo -- tion
576 Angenommen also, wir wollen die Legatobögen etwas
577 dicker setzten. Ist das möglich? Die Legatobögen sind mit
578 Sicherheit ein Layout-Objekt, die Frage muss also lauten:
579 @qq{Gibt es eine Eigenschaft von Legatobögen, die die
580 Dicke bestimmt?} Um diese Frage zu beantworten, müssen
581 wir in der Referenz der Interna ( kurz IR) nachschauen.
583 Die IR für die LilyPond-Version, die Sie benutzen, findet sich
584 auf der LilyPond-Webseite unter der Adresse
585 @uref{http://lilypond.org}. Gehen Sie zur Dokumentationsseite
586 und klicken Sie auf den Link zur Referenz der Interna.
587 @c Addition for German users
588 Die Sprache ändert sich ab hier nach englisch. Für diese Übung
589 sollten Sie die HTML-Version benutzen, nicht die
590 @qq{auf einer großen Seite} oder die PDF-Version.
591 Damit Sie die nächsten Absätze verstehen können, müssen Sie
592 genauso vorgehen, während Sie weiterlesen.
594 Unter der Überschrift @strong{Top} befinden sich fünf Links.
595 Wählen Sie den Link zum @emph{Backend}, wo sich die Information
596 über Layout-Objekte befindet. Hier, unter der Überschrift
597 @strong{Backend}, wählen Sie den Link @emph{All layout objects}.
598 Die Seite, die sich öffnet, enthält ein Liste aller Layout-Objekte,
599 die in Ihrerer LilyPond-Version benutzt werden, in alphabetischer
600 Ordnung. Wählen Sie den Link @emph{Slur} und die Eigenschaften
601 der Legatobögen (engl. slur) werden aufgelistet.
603 Eine alternative Methode, auf diese Seite zu gelangen, ist von
604 der Notationsreferenz aus. Auf einer der Seiten zu Legatobögen
605 findet sich ein Link zur Referenz der Interna. Dieser Link führt
606 Sie direkt auf diese Seite. Wenn Sie aber eine Ahnung haben,
607 wie die Bezeichnung des Layout-Objektes lauten könnte, das sie
608 ändern wollen, ist es oft schneller, direkt zur IR zu gehen und
611 Aus der Slur-Seite in der IR könne wir entnehmen, dass
612 Legatobögen (Slur-Objekte) durch den Slur_engraver erstellt
613 werden. Dann werden die Standardeinstellungen aufgelistet.
614 Beachten Sie, dass diese @strong{nicht} in alphabetischer Reihenfolge
615 geordnet sind. Schauen Sie sich die Liste an, ob sie eine Eigenschaft
616 enthält, mit der die Dicke von Legatobögen kontrolliert werden kann.
617 Sie sollten folgendes finden:
620 @code{thickness} (number)
622 Line thickness, generally measured in @code{line-thickness}
625 Das sieht ganz danach aus, als ob damit die Dicke geändert
626 werden kann. Es bedeutet, dass der Wert von
627 @code{thickness} einfach eine Zahl (@emph{number}) ist,
628 dass der Standardwert 1.2 ist, und dass die Einheit
629 für die Dicke eine andere Eigenschaft mit der
630 Bezeichnung @code{line-thickness} ist.
632 Wie schon früher gesagt, gibt es wenig bis gar keine Erklärungen
633 in der IR, aber wir haben schon genug Informationen, um
634 zu versuchen, die Dicke eines Legatobogens zu ändern. Die
635 Bezeichnung des Layout-Objekts ist offensichtlich
636 @code{Slur} und die Bezeichnung der Eigenschaft, die geändert
638 @code{thickness}. Der neue Wert sollte etwas mehr als 1.2 sein,
639 denn der Bogen soll ja dicker werden.
641 Den benötigten @code{\override}-Befehl können wir jetzt einfach
642 konstruieren, indem wir die Werte für die Bezeichnungen in den
643 Modellbefehl einfügen und den Kontext auslassen. Setzen wir
644 einmal einen sehr großen Wert für die Dicke um zu sehen, ob der
645 Befehl auch funktioniert. Also:
648 \override Slur #'thickness = #5.0
651 Vergessen Sie nicht das Rautenzeichen und Apostroph
652 (@code{#'}) vor der Eigenschaftsbezeichnung und das
653 Rautenzeichen vor dem neuen Wert!
655 Die nächste Frage ist nun: @qq{Wohin soll dieser Befehl geschrieben
656 werden?} Solange wir uns noch im Lernstadium befinden, ist
657 die beste Antwort: @qq{Innerhalb der Noten, vor den ersten
658 Legatobogen und nahe bei ihm.} Also etwa so:
660 @cindex Legatobogen, Beispiel für Veränderung
661 @cindex thickness-Eigenschaft, Beispiel
662 @cindex Dicke-Eigenschaft, Beispiel
664 @lilypond[quote,verbatim,relative=2]
668 % Increase thickness of all following slurs from 1.2 to 5.0
669 \override Slur #'thickness = #5.0
671 g[( e]) e d[( f]) a |
675 The man who feels love's sweet e -- mo -- tion
681 und wirklich wird der Legatobogen dicker.
683 Das ist also die grundlegende Herangehensweise,
684 @code{\override}-Befehl zu formulieren. Es gibt einige
685 zusätzliche Komplikationen, denen wir uns später widmen
686 werden, aber Sie haben jetzt das Handwerkszeug, um Ihre
687 eigenen Befehle zu konstruieren -- wenn Sie auch noch etwas
688 Übung benötigen. Die sollen Sie durch die folgenden Übungen
692 @subheading Finding the context
694 @cindex Kontext, Finden und identifizieren
696 Manchmal muss dennoch der Kontext spezifiziert werden.
697 Welcher aber ist der richtige Kontext? Wir könnten raten,
698 dass Legatobögen sich im @code{Voice}-Kontext befinden,
699 denn sie sind immer einzelnen Melodielinien zugewiesen.
700 Aber wir können uns dessen nicht sicher sein. Um unsere
701 Annahme zu überprüfen, gehen wir wieder zu der Seite im
702 IR, die die Legatobögen beschreibt und die Überschrift
703 @emph{Slur} hat. Dort steht: @qq{Slur objects are created
704 by: Slur engraver}. Legatobögen werden also in dem Kontext
705 erstellt, in dem sich der @code{Slur_engraver} befindet.
706 Folgen Sie dem Link zu der @code{Slur_engraver}-Seite.
707 Unten auf der Seite steht, dass der @code{Slur_engraver}
708 sich in fünf Stimmen-Kontexten befindet, unter anderem
709 auch im normalen @code{Voice}-Kontext. Unsere Annahme
710 war also richtig. Und weil @code{Voice} einer der Kontexte
711 der untersten Ebene ist, welcher eindeutig schon dadurch
712 definiert ist, dass wir Noten eingeben, kann er an dieser Stelle
713 auch weggelassen werden.
716 @subheading Overriding once only
718 @cindex Override nur einmal
719 @cindex once override
723 Im Beispiel oben wurden @emph{alle} Legatobögen dicker
724 gesetzt. Vielleicht wollen Sie aber nur den ersten Bogen
725 dicker haben. Das können Sie mit dem @code{\once}-Befehl
726 erreichen. Er wird direkt vor den @code{\override}-Befehl
727 gesetzt und bewirkt, dass nur der Bogen geändert wird, der
728 @strong{unmittelbar an der nächsten Note beginnt.} Wenn
729 die nächste Note keinen Bogenbeginn hat, dann passiert
730 gar nichts -- der Befehl wird nicht gespeichert, sondern einfach
731 vergessen. Der Befehl, mit @code{\once} zusammen benutzt,
732 muss also wie folgt positioniert werden:
734 @cindex Legatobogen, Beispiel zur Veränderung
735 @cindex thickness-Eigenschaft, Beispiel
737 @lilypond[quote,verbatim,relative=2]
742 % Increase thickness of immediately following slur only
743 \once \override Slur #'thickness = #5.0
745 g[( e]) e d[( f]) a |
749 The man who feels love's sweet e -- mo -- tion
755 Jetzt bezieht er sich nur noch auf den ersten Legatobogen.
757 Der @code{\once}-Befehl kann übrigens auch vor einem @code{\set}-Befehl
761 @subheading Reverting
764 @cindex Rückgängig machen
765 @cindex Wiederherstellen von Standardeinstellungen
766 @cindex Standardeinstellungen, Wiederherstellen
770 Eine weitere Möglichkeit: nur die beiden ersten Legatobögen sollen
771 dicker gesetzt werden. Gut, wir könnten jetzt zwei Befehle benutzen,
772 jeden mit dem @code{\once}-Präfix und direkt vor die entsprechende
773 Note gestellt, an welcher der Bogen beginnt:
775 @cindex Legatobogen, Beispiel zur Veränderung
776 @cindex thickness-Eigenschaft, Beispiel
778 @lilypond[quote,verbatim,relative=2]
783 % Increase thickness of immediately following slur only
784 \once \override Slur #'thickness = #5.0
786 % Increase thickness of immediately following slur only
787 \once \override Slur #'thickness = #5.0
788 g[( e]) e d[( f]) a |
792 The man who feels love's sweet e -- mo -- tion
798 Wir könnten aber auch den @code{\once}-Befehl weglassen und anstelle
799 dessen später den @code{\revert}-Befehl einsetzen, um die
800 @code{thickness}-Eigenschaft wieder auf ihren Standardwert zurückzusetzen:
802 @cindex Legatobogen, Beispiel zur Veränderung
803 @cindex thickness-Eigenschaft, Beispiel
805 @lilypond[quote,verbatim,relative=2]
810 % Increase thickness of all following slurs from 1.2 to 5.0
811 \override Slur #'thickness = #5.0
814 % Revert thickness of all following slurs to default of 1.2
815 \revert Slur #'thickness
820 The man who feels love's sweet e -- mo -- tion
826 Der @code{\revert}-Befehl kann benutzt werden, um eine beliebige
827 Eigenschaft, die mit @code{\override} geändert worden ist, wieder in
828 ihre Standardeinstellungen zurückzuversetzen. In unserem Beispiel können
829 Sie die Methode benutzen, die Ihnen lieber ist, beide haben das gleiche
832 Damit endet die Einleitung in die Referenz der Interna (IR) und die
833 grundlegenden Optimierungsmethoden. Einige Beispiele folgen in späteren
834 Abschnitten dieses Kapitel, einerseits um Sie mit weiteren Möglichkeiten
835 der IR bekanntzumachen, andererseits um Ihnen mehr Übungsmöglichkeiten
836 zu geben, die relevante Information dort zu finden. Die Beispiele werden
837 Schritt für Schritt immer weniger Erklärungen beinhalten.
840 @node Properties found in interfaces
841 @subsection Properties found in interfaces
843 @cindex Interface-Eigenschaften
844 @cindex Eigenschaften von Interfaces
845 @cindex Schnittstellen, Eigenschaften von
846 @cindex Eigenschaften von Schnittstellen
848 Der Text unseres Beispiels soll jetzt kursiv gesetzt werden. Was für
849 ein @code{\override}-Befehl wird dazu benötigt? Schauen wir
850 uns zunächst das Inhaltsverzeichnis in der IR an: @qq{All layout objects},
851 wie auch schon zuvor. Welches Objekt könnte die Darstellung des
852 Textes (engl. lyrics) beeinflussen? Es gibt den Eintrag @code{LyricText},
853 das hört sich schon sehr gut an. Ein Klick hierauf zeigt alle Eigenschaften
854 an, die verändert werden können. Dazu gehört
855 @code{font-series} und @code{font-size}, aber nichts, womit man kursiven
856 Text erreichen könnte. Das liegt daran, dass die Schnitteigenschaft allen
857 Schrift-Objekten gemeinsam ist. Sie findet sich also nicht in jedem einzlenen
858 Layout-Objekt aufgelistet, sondern ist mit anderen ähnlichen Eigenschaften
859 zusammen in einem @strong{Interface} -- einer Schnittstelle -- verortet;
861 @code{font-interface}.
863 Jetzt müssen wir also lernen, wie wir Eigenschaften von Schnittstellen finden
864 und wie wir herausfinden, welche Objekte diese Schnittstelleneigenschaften
867 Schauen Sie sich noch einmal die Seite in der IR an, die @code{LyricText}
868 beschreibt. Unten auf der Seite ist eine klickbare Liste (in der HTML-Version
869 der IR) an Eigenschaften, die von @code{LyricText} unterstützt
870 werden. Diese Liste enthält sieben Einträge, darunter auch
871 @code{font-interface}. Ein Klick hierauf bringt uns zu den Eigenschaften,
872 die mit dieser Schnittstelle verbunden sind, also auch @code{LyricText}.
874 Jetzt sehen wir alle die Eigenschaften, die der Benutzer verändern kann,
875 um die Schriftartendarstellung zu beeinflussen. Dazu gehört nun auch
876 @code{font-shape(symbol)}, wobei @code{symbol} auf die Werte
877 @code{upright} (gerade), @code{italics} (kursiv) oder @code{caps}
878 (Kapitälchen) gesetzt werden kann.
880 Sie werden gemerkt haben, dass @code{font-series} und @code{font-size}
881 hier auch aufgelistet sind. Es stellt sich die Frage, warum diese
882 allgemeinen Schriftarteigenschaften @code{font-series} und
883 @code{font-size} sowohl unter der Überschrift
884 @code{LyricText} als unter dem @code{font-interface} aufgelistet
885 sind, aber @code{font-shape} befindet sich nur im
886 @code{font-interface}? Die Antwort ist: Die globalen Einstellungen
887 von @code{font-series} und @code{font-size} werden geändert, wenn
888 ein @code{LyricText}-Objekt erstellt wird, aber @code{font-shape}
889 wird davon nicht beeinflusst. Die zusätzlichen Einträge unter der
890 Überschrift @code{LyricText} beinhalten dann die Werte der
891 Standardeinstellungen dieser zwei Eigenschaften, wenn es sich
892 um ein @code{LyricText}-Objekt handelt. Andere Objekte,
893 die auch das @code{font-interface} unterstützen, setzen diese
894 Eigenschaften anders, wenn sie erstellt werden.
896 Versuchen wir nun einen @code{\override}-Befehl zu konstruieren,
897 der den Gesantext kursiv setzt. Das Objekt hat die Bezeichnung
898 @code{LyricText}, die Eigenschaft ist @code{font-shape}
899 und der Wert @code{italic}. Wie vorher schon lassen wir den
902 Am Rande sei angemerkt, dass die Werte der @code{font-shape}-Eigenschaft
903 mit einem Apostroph (@code{'}) gekennzeichnet werden
904 müssen, weil es sich um Symbole handelt. Aus dem gleichen
905 Grund mussten auch für @code{thickness} weiter oben im
906 Text ein Apostroph gesetzt werden. Symbole sind besondere
907 Bezeichnungen, die LilyPond intern bekannt sind. Einige
908 sind Bezeichnungen von Eigenschaften, wie eben @code{thickness}
909 oder @code{font-shape}. Andere sind besondere Werte,
910 die an Eigenschaften übergeben werden können, wie
911 @code{italic}. Im Unterschied hierzu gibt es auch beliebige
912 Zeichenketten, die immer mit Anführungszeichen, also
913 als @code{"Zeichenkette"} auftreten. Für weitere
914 Einzelheiten zu Zeichenketten und Werten, siehe
915 @ref{Scheme tutorial}.
917 Gut, der @code{\override}-Befehl, mit dem der Gesangstext
918 kursiv gesetzt wird, lautet:
921 \override LyricText #'font-shape = #'italic
925 und er muss direkt vor den Text gesetzt werden, auf den er sich
928 @cindex font-shape-Eigenschaft, Beispiel
929 @cindex LyricText, Beispiel zur Veränderung
930 @cindex kursiv, Beispiel
931 @cindex @code{\addlyrics}, Beispiel
933 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
938 g[( e]) e d[( f]) a |
942 \override LyricText #'font-shape = #'italic
943 The man who feels love's sweet e -- mo -- tion
949 Jetzt wird der Text kursiv gesetzt.
952 @subheading Specifying the context in lyric mode
955 @cindex Kontext im Gesangstextmodus angeben
956 @cindex Gesangstextmodus, Kontext angeben
958 Bei Gesangstexten funktioniert der @code{\override}-Befehl
959 nicht mehr, wenn Sie den Kontext im oben dargestellten
960 Format angeben. Eine Silbe wird im Gesangtextmodus
961 (lyricmode) entweder von einem Leerzeichen, einer
962 neuen Zeile oder einer Zahl beendet. Alle anderen
963 Zeichen werden als Teil der Silbe integriert. Aus diesem
964 Grund muss auch vor der schließenden Klammer
965 @code{@}} ein Leerzeichen gesetzt oder eine neue
966 Zeile begonnen werden. Genauso müssen Leerzeichen
967 vor und nach einem Punkt benutzt werden, um die
968 Kontext-Bezeichnung von der Objekt-Bezeichnung zu
969 trennen, denn sonst würden beide Bezeichnungen als
970 ein Begriff interpretiert und von LilyPond nicht verstanden
971 werden. Der Befehl muss also lauten:
974 \override Lyrics . LyricText #'font-shape = #'italic
977 @warning{Innerhalb von Gesangstext muss immer ein
978 Leerzeichen zwischen der letzten Silbe und der schließenden
979 Klammer gesetzt werden.}
981 @warning{Innerhalb von @code{\override}-Befehlen in
982 Gesangstexten müssen Leerzeichen um Punkte zwischen
983 Kontext- und Objektbezeichnungen gesetzt werden.}
986 @node Types of properties
987 @subsection Types of properties
989 @cindex Eigenschaftsarten
991 Bis jetzt hatten wir es mit zwei Arten von Eigenschaften zu
992 tun: @code{number} (Zahl) und @code{symbol}. Damit
993 ein Befehl funktioniert, muss der Wert einer Eigenschaft
994 vom richtigen Typ sein und die Regeln befolgen, die
995 für diesen Typ gelten. Der Eigenschaftstyp ist in der
996 IR in Klammern hinter der Eigenschaftsbezeichnung
997 angegeben. Hier eine Liste der Typen, die Sie vielleicht
998 benötigen werden, mit den Regeln, die für den jeweiligen
999 Typ gelten und einigen Beispielen. Sie müssen immer
1000 ein Rautenzeichen (@code{#}) vor den Typeintrag setzen,
1001 wenn sie in einem @code{\override}-Befehl benutzt werden.
1003 @multitable @columnfractions .2 .45 .35
1004 @headitem Eigenschaftstyp
1008 @tab Entweder wahr oder falsch, dargestellt als #t oder #f
1009 @tab @code{#t}, @code{#f}
1010 @item Dimension (in Notenlinienabständen)
1011 @tab Eine positive Dezimalzahl (in Notenlinienabstand-Einheiten)
1012 @tab @code{2.5}, @code{0.34}
1014 @tab Eine gültige Richtungskonstante oder das numerische Äquivalent
1015 @tab @code{LEFT}, @code{CENTER}, @code{UP},
1018 @tab Eine positive ganze Zahl
1019 @tab @code{3}, @code{1}
1021 @tab Eine eingeklammerte Anzahl von Einträgen, mit Klammern getrennt
1022 und angeführt von einem Apostroph
1023 @tab @code{'(left-edge staff-bar)}, @code{'(1)},
1024 @code{'(1.0 0.25 0.5)}
1025 @item Textbeschriftung (markup)
1026 @tab Beliebige gültige Beschriftung
1027 @tab @code{\markup @{ \italic "cresc." @}}
1029 @tab Ein Bruch einer ganzen Note, mit der make-moment-Funktion
1031 @tab @code{(ly:make-moment 1 4)},
1032 @code{(ly:make-moment 3 8)}
1034 @tab Eine beliebige positive oder negative Dezimalzahl
1035 @tab @code{3.5}, @code{-2.45}
1036 @item Paar (Zahlenpaar)
1037 @tab Zwei Zahlen getrennt von @qq{Leerzeichen . Leerzeichen}, eingeklammert
1038 und angeführt von einem Apostroph
1039 @tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
1041 @tab Eine beliebige Anzahl von Symbolen, die für die Eigenschaft
1042 gültig sind, angeführt von einem Apostroph
1043 @tab @code{'italic}, @code{'inside}
1045 @tab Eine Prozedur oder @code{#f} (um keine Aktion hervorzurufen)
1046 @tab @code{bend::print}, @code{ly:text-interface::print},
1049 @tab Eine Liste mit drei Einträgen, eingeklammert und mit
1050 Apostroph-Raute ( @code{'#}) angeführt.
1051 @tab @code{'#(#t #t #f)}
1056 Handbuch zum Lernen: @ref{Scheme tutorial}.
1059 @node Appearance of objects
1060 @section Appearance of objects
1062 In diesem Abschnitt wollen wir zeigen, wie die Kenntnisse der
1063 vorigen Abschnitte in der Praxis angewandt werden können,
1064 um das Aussehen des Musiksatzes zu beeinflussen.
1067 * Visibility and color of objects::
1069 * Length and thickness of objects::
1073 @node Visibility and color of objects
1074 @subsection Visibility and color of objects
1076 In Unterrichtsmaterial für den Musikunterricht wird oft
1077 eine Partitur dargestellt, in der bestimmte Notationselemente
1078 fehlen, so dass der Schüler die Aufgabe bekommt, die
1079 nachzutragen. Ein einfaches Beispiel ist etwa, die
1080 Taktlinien zu entfernen, damit der Schüler sie selber zeichnen
1081 kann. Aber die Tatklinien werden normalerweise automatisch
1082 eingefügt. Wie verhindern wir, dass sie ausgegeben werden?
1084 Bevor wir uns hieran machen, sei daran erinnert, dass
1085 Objekteigenschaften in sogenannten @emph{Schnittstellen}
1086 -- engl. interface -- gruppiert sind, siehe auch
1087 @ref{Properties found in interfaces}. Das dient ganz einfach
1088 dazu, die Eigenschaften zusammenzufassen, die üblicherweise
1089 zusammen benötigt werden -- wenn eine davon für ein Objekt
1090 gilt, dann auch die anderen. Manche Objekte brauchen die
1091 Eigenschaften von der einen Schnittstelle, andere von einer
1092 anderen. Die Schnittstellen, die die Eigenschaften von einem
1093 bestimmten Grob beinhalten, sind in der IR unten auf der
1094 Seite aufgelistet, die dieses Grob beschreibt. Die Eigenschaften
1095 können betrachtet werden, indem die Seite der entsprechenden
1096 Schnittstelle geöffnet wird.
1098 Zu Information, wie man Eigenschaften von Grobs findet, siehe
1099 @ref{Properties of layout objects}. Wir benutzen also jetzt
1100 die selbe Methode um in der IR das Layout-Objekt zu finden,
1101 dass für die Tatklinien zuständig ist. Über die Überschriften
1102 @emph{Backend} und @emph{All layout objects} kommen
1103 wir zu einem Layout-Objekt mit der Bezeichnung
1104 @code{BarLine} (engl. TaktLinie). Seine Eigenschaften
1105 beinhalten zwei, die über die Sichtbarkeit entscheiden:
1106 @code{break-visibility} und @code{stencil}.
1107 @code{BarLine} unterstützt auch einige Schnittstellen,
1108 unter anderem @code{grob-interface}, wo wir eine
1109 @code{transparent} und eine @code{color}-Eigenschaft
1110 finden. Alle können die Sichtbarkeit von Taktlinien (und
1111 natürlich auch die Sichtbarkeit von vielen anderen Objekten)
1112 beeinflussen. Schauen wir uns diese Eigenschaften eine
1113 nach der anderen an.
1117 @cindex Stencil-Eigenschaft
1118 @cindex Matrizen-Eigenschaft
1120 Diese Eigenschaft kontrolliert die Erscheinung der Taktlinien,
1121 indem sie das Symbol bestimmt, das ausgegeben werden soll.
1122 Wie bei vielen anderen Eigenschaften auch, kann sie so
1123 eingestellt werden, dass sie nichts ausgibt, indem ihr Wert
1124 auf @code{#f} (falsch) gesetzt wird. Ein Versuch also,
1125 wie vorher, indem wir den impliziten Kontext (@code{Voice})
1128 @cindex Taktlinie, Beispiel zur Veränderung
1129 @cindex stencil-Eigenschaft, Beispiel
1131 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1134 \override BarLine #'stencil = ##f
1136 g, a16 b8 c d4 e16 |
1141 Die Taktlinien werden aber immer noch angezeigt. Was ist da
1142 falsch gelaufen? Gehen Sie zurück zur IR und schauen Sie auf
1143 die Seite, die die Eigenschafter für @code{BarLine} angibt.
1144 Oben auf der Seite steht: @qq{Barline objects are created
1145 by: Bar_engraver}. Schauen Sie sich die
1146 @code{Bar_engraver}-Seite an. Unten auf der Seite steht
1147 eine Liste der Kontexte, in denen der Takt-Engraver
1148 funktioniert. Alle Kontexte sind @code{Staff}-Typen (also
1149 Notensystem-Typen). Der Grund, warum der
1150 @code{\override}-Befehl nicht funktioniert hat, liegt
1151 also darin, dass das Taktlinie-Objekt (@code{BarLine}) sich nicht
1152 im @code{Voice}-Kontextbefindet. Wenn der Kontext
1153 falsch angegeben wird, bewirkt der Befehl einfach gar
1154 nichts. Keine Fehlermeldung wird ausgegeben und auch
1155 nichts in die Log-Datei geschrieben. Versuchen wir also,
1156 den richtigen Kontext mitanzugeben:
1158 @cindex Taktlinie, Beispiel zur Veränderung
1159 @cindex stencil-Eigenschaft, Beispiel
1161 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1164 \override Staff.BarLine #'stencil = ##f
1166 g, a16 b8 c d4 e16 |
1172 Jetzt sind die Taktlinien wirklich verschwunden.
1174 Es sollte jedoch beachtet werden, dass das Setzen der
1175 @code{stencil}-Eigenschaft auf @code{#f} zu Fehlerhinweisen führen
1176 kann, wenn die Dimensionen des Objekts für die richtige Behandlung
1177 benötigt werden. Zum Beispiel werden Fehler ausgegeben, wenn
1178 die @code{stencil}-Eigenschaft des @code{NoteHead}-Objekts auf
1179 @code{#f} gesetzt wird. Wenn dieser Fall auftritt, kann anstatt
1180 dessen die @code{point-stencil}-Funktion benutzt werden, welche
1181 den Stencil auf ein Objekt mit der Größe Null setzt:
1183 @lilypond[quote,verbatim,relative=2]
1186 \once \override NoteHead #'stencil = #point-stencil
1192 @subheading break-visibility
1194 @cindex break-visibility-Eigenschaft
1195 @cindex Unsichtbar machen (break-visibility)
1197 Aus der Beschreibung der Eigenschaften für @code{BarLine}
1198 in der IR geht hervor, dass die @code{break-visibility}-Eigenschaft
1199 einen Vektor mit drei Booleschen Werten benötigt. Diese
1200 kontrollieren jeweils, ob die Taktlinien am Ende einer Zeile,
1201 in der Mitte einer Zeile und am Anfang einer Zeile ausgegeben
1202 werden. Wenn also alle Taktlinien unsichtbar sein sollen, wie in
1203 unserem Beispiel, brauchen wir den Wert @code{'#(#f #f #f)}.
1204 Versuchen wir es also, und berücksichtigen wir auch den
1205 @code{Staff}-Kontext. Beachten Sie auch, dass Sie @code{#'#}
1206 vor der öffnenden Klammer schreiben müssen:
1207 @code{'#} wird benötigt als Teil des Wertes, um einen Vektor zu
1208 signalisieren, und das erste @code{#} wird benötigt, um
1209 den Wert in einem @code{\override}-Befehl anzuführen.
1211 @cindex Taktlinie, Beispiel zur Veränderung
1212 @cindex break-visibility-Eigenschaft, Beispiel
1214 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1217 \override Staff.BarLine #'break-visibility = #'#(#f #f #f)
1219 g, a16 b8 c d4 e16 |
1225 Auch auf diesem Weg gelingt es, die Taktlinien unsichtbar zu machen.
1228 @subheading transparent
1230 @cindex transparent-Eigenschaft
1231 @cindex Durchsichtig machen (transparent)
1233 Aus den Eigenschaftsdefinitionen auf der @code{grob-interface}-Seite
1234 in der IR geht hervor, dass die @code{transparent}-Eigenschaft
1235 boolesch ist. Mit @code{#t} (wahr) wird also ein Grob durchsichtig
1236 gemacht. Im unserem Beispiel soll jetzt die Taktart durchsichtig
1237 gemacht werden, anstatt die Taktlinien durchsichtig zu machen.
1238 Wir brauchen also wieder die Grob-Bezeichnung für die Taktart.
1239 Auf der @qq{All layout objects}-Seite in der IR müssen wir die
1240 Eigenschaften des @code{TimeSignature}-Layout-Objekts suchen
1241 Das Objekt wird vom @code{Time_signature_engraver} erstellt,
1242 der sich auch im @code{Staff}-Kontext befindet und genauso das
1243 @code{grob-interface} unterstützt, wie Sie sich
1244 überzeugen können. Der Befehl, um die Taktangabe unsichtbar zu
1247 @cindex Taktart, Beispiel zur Veränderung
1248 @cindex transparent-Eigenschaft, Beispiel
1250 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1253 \override Staff.TimeSignature #'transparent = ##t
1255 g, a16 b8 c d4 e16 |
1261 Die Taktangabe ist verschwunden, aber mit diesem Befehl wird ein
1262 freier Platz gelassen, wo sich die Taktangabe eigentlich befinden
1263 würde. Das braucht man vielleicht für eine Schulaufgabe, in der
1264 die richtige Taktangabe eingefügt werden soll, aber in anderen
1265 Fällen ist diese Lücke nicht schön. Um auch die Lücke zu entfernen,
1266 muss die Matrize (stencil) der Taktangabe auf @code{#f} (falsch)
1269 @cindex Taktart, Beispiel zur Veränderung
1270 @cindex stencil-Eigenschaft, Beispiel
1272 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1275 \override Staff.TimeSignature #'stencil = ##f
1277 g, a16 b8 c d4 e16 |
1283 Und der Unterschied wird deutlich: hiermit wird das gesamte Objekt
1284 entfernt, während man mit @code{transparent} ein Objekt
1285 unsichtbar machen kann, es aber an seinem Platz gelassen wird.
1290 @cindex color-Eigenschaft
1291 @cindex Farb-Eigenschaft
1293 Abschließend wollen wir die Taktlinien unsichtbar machen, indem
1294 wir sie weiß einfärben. (Es gibt hier eine Schwierigkeit: die weiße
1295 Taktlinie übermalt manchmal die Taktlinienen, wo sie sie kreuzt,
1296 manchmal aber auch nicht. Sie können in den Beispielen unten
1297 sehen, dass das nicht vorhersagbar ist. Die Einzelheiten dazu, warum
1298 das passiert und wie sie es kontrollieren können, werden dargestellt
1299 in @ruser{Painting objects white}. Im Moment wollen wir lernen, wie
1300 man mit Farbe arbeitet, akzeptieren Sie bitte an dieser Stelle die
1303 Das @code{grob-interface} bestimmt, dass der Wert der Farb-Eigenschaft
1304 eine Liste ist, aber es gibt keine Erklärung, was für eine Liste das
1305 sein soll. Die Liste, die benötigt wird, ist eine Liste mit Werten in
1306 internen Einheiten, aber damit Sie nicht wissen müssen, wie diese
1307 aussehen, gibt es mehrere Wege, Farben anzugeben. Der erste
1308 Weg ist es, @qq{normale} Farben zu benutzen, wie sie in der
1309 Tabelle in @ruser{List of colors} aufgelistet sind. Beachten Sie,
1310 dass die Bezeichnungen auf English sind. Um die Taktlinien auf
1311 weiß zu setzen, können Sie schreiben:
1313 @cindex Taktlinie, Beispiel zur Veränderung
1314 @cindex color-Eigenschaft, Beispiel
1316 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1319 \override Staff.BarLine #'color = #white
1321 g, a16 b8 c d4 e16 |
1327 und die Taktlinien verschwinden in der Tat. Beachten Sie,
1328 dass @emph{white} nicht mit einem Apostroph angeführt
1329 wird -- es ist kein Symbol, sondern eine @emph{Funktion}.
1330 Wenn sie aufgerufen wird, stellt sie eine Liste mit internen
1331 Werten zu Verfügung, mit welcher die Farbe auf weiß
1332 gestellt wird. Die anderen Farben in der Liste sind auch
1333 Funktionen. Um sich zu überzeugen, dass der Befehl auch
1334 wirklich funktioniert, können Sie die Farbe auf eine der
1335 anderen Funktionen dieser Liste abändern.
1341 Die zweite Art die Farbe zu ändern geschieht, indem die Liste
1342 der X11-Farbbezeichnungen einzusetzen, siehe die zweite Liste
1343 in @ruser{List of colors}. Diesen Farben muss jedoch eine
1344 andere Funktion vorangestellt werden, die die X11-Farbbezeichnungen
1345 in interne Werte konvertiert:
1346 @code{x11-color}. Das geschieht wie folgt:
1348 @cindex Taktlinie, Beispiel zur Veränderung
1349 @cindex color-Eigenschaft, Beispiel
1351 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1354 \override Staff.BarLine #'color = #(x11-color 'white)
1356 g, a16 b8 c d4 e16 |
1362 In diesem Fall hat die Funktion @code{x11-color} ein Symbol
1363 als Argument, darum muss dem Symbol ein Apostroph vorangestellt
1364 und beide zusammen in Klammern gesetzt werden.
1370 Es gibt noch eine dritte Funktion, die RGB-Werte in die
1371 internen Werte übersetzt -- die @code{rgb-color}-Funktion. Sie
1372 braucht drei Argumente, um die Stärke von Rot, Grün und
1373 Blau darzustellen. Die Werte befinden sich zwischen
1374 0 und 1. Um also die Farbe Rot darzustellen, muss der
1375 Wert der Funktion lauten: @code{(rgb-color 1 0 0)}, weiß
1376 würde sein: @code{(rgb-color 1 1 1)}.
1378 @cindex Taktlinie, Beispiel zur Veränderung
1379 @cindex color-Eigenschaft, Beispiel
1381 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1384 \override Staff.BarLine #'color = #(rgb-color 1 1 1)
1386 g, a16 b8 c d4 e16 |
1391 Schließlich gibt es noch eine Grauskala, die zu den X11-Farben
1392 gehört. Sie reicht von schwarz (@code{'grey0'}) bis
1393 weiß (@code{'grey100}), in Einserschritten. Wir wollen das
1394 illustrieren, indem alle Layout-Objekte im Beispiel
1395 verschiede Grauschattierungen erhalten:
1397 @cindex StaffSymbol, Beispiel zur Veränderung
1398 @cindex TimeSignature, Beispiel zur Veränderung
1399 @cindex Schlüssel, Beispiel zur Veränderung
1400 @cindex Notenhals, Beispiel zur Veränderung
1401 @cindex Taktlinie, Beispiel zur Veränderung
1402 @cindex Farbeigenschaft, Beispiel
1403 @cindex x11-Farben, Beispiel
1404 @cindex Taktlinien, Beispiel zur Veränderung
1405 @cindex Taktart, Beispiel zur Veränderung
1406 @cindex Clef, Beispiel zur Veränderung
1407 @cindex Stem, Beispiel zur Veränderung
1408 @cindex NoteHead, Beispiel zur Veränderung
1409 @cindex Notenkopf, Beispiel zur Veränderung
1411 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1414 \override Staff.StaffSymbol #'color = #(x11-color 'grey30)
1415 \override Staff.TimeSignature #'color = #(x11-color 'grey60)
1416 \override Staff.Clef #'color = #(x11-color 'grey60)
1417 \override Voice.NoteHead #'color = #(x11-color 'grey85)
1418 \override Voice.Stem #'color = #(x11-color 'grey85)
1419 \override Staff.BarLine #'color = #(x11-color 'grey10)
1421 g, a16 b8 c d4 e16 |
1427 Beachten Sie die Kontexte, die mit jedem einzelnen Layout-Objekt
1428 verbunden sind. Es ist wichtig, den richtigen Kontext einzusetzen,
1429 damit die Befehle funktionieren. Denken Sie daran, dass der
1430 Kontext sich daran orientiert, wo sich der entsprechende
1431 Engraver befindet. Den Standardkontext für Engraver finden
1432 Sie, indem Sie beim Layout-Objekt beginnen, zum Engraver
1433 gehen, der es produziert und auf der Seite des Engravers in der
1434 IR finden Sie Information, in welchem Kontext sich der
1435 Engraver normalerweise befindet.
1438 @node Size of objects
1439 @subsection Size of objects
1441 @cindex Veränderung von Objektgrößen
1442 @cindex Objektgrößen, verändern
1443 @cindex Größen von Objekten verändern
1445 Als Startpunkt wollen wir wieder ein früheres Beispiel
1446 wählen, siehe @ref{Nesting music expressions}. Hier wurde
1447 ein neues Notensystem erstellt, wie man es für ein @rglos{ossia}
1450 @cindex alignAboveContext-Eigenschaft, Beispiel
1451 @cindex über dem System anordnen, Beispiel
1452 @cindex @code{\with}-Beispiel
1454 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1455 \new Staff ="main" {
1462 alignAboveContext = #"main" }
1470 Ossia-Systeme werden normalerweise ohne Schlüssel und Taktangabe
1471 geschrieben, und sie werden etwas kleiner als das Hauptsystem gesetzt.
1472 Wie man Schlüssel und Taktangabe entfernt, wissen wir schon:
1473 wir setzen den Stencil von beiden auf @code{#f}:
1475 @cindex alignAboveContext-Eigenschaft, Beispiel
1476 @cindex über dem System anordnen, Beispiel
1477 @cindex @code{\with}-Beispiel
1478 @cindex stencil-Eigenschaft, Beispiel
1479 @cindex Schlüssel, Beispiel zur Veränderung
1480 @cindex Taktart, Beispiel zur Veränderung
1482 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1483 \new Staff ="main" {
1490 alignAboveContext = #"main"
1493 \override Staff.Clef #'stencil = ##f
1494 \override Staff.TimeSignature #'stencil = ##f
1504 wobei ein zusätzliches Klammerpaar nach der @code{\with}-Konstruktion
1505 erforderlich ist um sicherzugehen, dass die Modifikation und
1506 die Noten sich auch auf das Ossia-System beziehen.
1508 Was für einen Unterschied macht es, ob man den @code{Staff}-Kontext
1509 mit @code{\with} verändert, oder ob man die Stencils mit
1510 @code{\override} beeinflusst? Der größte Unterschied liegt
1511 darin, dass Änderungen, die mit @code{\with} eingeführt werden,
1512 während der Erstellung des Kontextes miterzeugt werden und
1513 als @strong{Standardeinstellungen} für diesen Kontext während seiner
1514 gesamten Dauer gelten, während @code{\set}- oder @code{\override}-Befehle
1515 dynamisch in die Noten eingebettet werden -- sie führen die
1516 Änderungen synchron mit einem bestimmten Zeitpunkt in
1517 der Musik aus. Wenn die Änderungen mit @code{\unset}
1518 oder @code{\revert} rückgängig gemacht werden, werden
1519 wieder die Standardwerte eingesetzt, die also die sind, die
1520 mit einer @code{\with}-Konstruktion definiert wurden, oder
1521 wenn hier keine definiert worden sind, die normalen
1524 Manche Kontexteigenschaften können nur ein einer
1525 @code{\with}-Konstruktion verändert werden. Das sind
1526 Eigenschaften, die nicht sinnvoll mitten im System geändert
1527 werden können. @code{alignAboveContext} (Orientierung
1528 über dem Kontext) und die Parallele,
1529 @code{alignBelowContext} (Orientierung unter dem Kontext)
1530 sind zwei derartige Eigenschaften -- wenn das Notensystem
1531 einmal erstellt wurde, ist die Orientierung schon bestimmt
1532 und es wäre nicht sinnvoll, sie später zu ändern.
1534 Die Standardwerte für Layout-Objekt-Eigenschaften können
1535 auch in der @code{\with}-Konstruktion gesetzt werden.
1536 Benutzen Sie einfach den normalen @code{\override}-Befehl
1537 ohne den Kontext, denn der Kontext ist eindeutig definiert
1538 durch die Stelle, an welcher sich @code{\with} befindet.
1539 Wenn an dieser Stelle ein Kontext angegeben wird, produziert LilyPond
1542 Das obige Beispiel könnte also auch so aussehen:
1544 @cindex alignAboveContext-Eigenschaft, Beispiel
1545 @cindex über dem System anordnen, Beispiel
1546 @cindex @code{\with}-Beispiel
1547 @cindex stencil-Eigenschaft, Beispiel
1548 @cindex Schlüssel, Beispiel zur Veränderung
1549 @cindex Taktart, Beispiel zur Veränderung
1551 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1552 \new Staff ="main" {
1559 alignAboveContext = #"main"
1560 % Don't print clefs in this staff
1561 \override Clef #'stencil = ##f
1562 % Don't print time signatures in this staff
1563 \override TimeSignature #'stencil = ##f
1572 Nun können wir daran gehen, auch wirklich die
1573 Größe der Objekte zu ändern.
1575 Manche Layout-Objekte werden aus Glyphen erstellt,
1576 die sich in einer Schriftartdatei befinden. Dazu gehören
1577 die Notenköpfe, Versetzungszeichen, Text, Schlüssel,
1578 Taktbezeichnung, Dynamik und Gesangstext. Ihre
1579 Größe wird verändert, indem die
1580 @code{font-size}- (Schriftgröße)-Eigenschaft geändert wird, wie
1581 wir bald sehen werden. Andere Layout-Objekte, wie
1582 Bögen -- oder allgemein Strecker-Objekte -- werden
1583 individuell gezeichnet, es gibt dazu also keine
1584 @code{font-size}, die mit ihnen verknüpft wäre.
1585 Weitere Eigenschaften wie die Länge von Hälsen und
1586 Taktlinien, Dicke von Balken und anderen Linien und
1587 der Abstand der Notenlinien voneinander müssen auf
1588 spezielle Weise verändert werden.
1590 In unserem Ossia-Beispiel wollen wir zuerst die
1591 Schriftgröße verändern. Das ist auf zwei Arten möglich.
1592 Entweder wir ändern die Schriftgröße für jede Objektart
1593 mit einem eigenen Befehl, etwa:
1596 \override NoteHead #'font-size = #-2
1600 oder wir ändern die Größe aller Schriftobjekte, indem wir
1601 den Wert einer besonderen Eigenschaft, @code{fontSize},
1602 mit dem @code{\set}-Befehl bestimmen oder sie in
1603 eine @code{\with}-Konstruktion (ohne @code{\set} einschließen.
1609 Beide Beispiele reduzieren die Schriftgröße um zwei Schritte
1610 im Vergleich zum vorigen Wert, wobei jeder Schritt die
1611 Schriftgröße um etwa 12% verändert.
1613 Setzen wir das also in unserem Ossia-Beispiel ein:
1615 @cindex alignAboveContext-Eigenschaft, Beispiel
1616 @cindex über dem System anordnen, Beispiel
1617 @cindex @code{\with}-Beispiel
1618 @cindex stencil-Eigenschaft, Beispiel
1619 @cindex Schlüssel, Beispiel zur Veränderung
1620 @cindex Taktart, Beispiel zur Veränderung
1622 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
1623 \new Staff ="main" {
1630 alignAboveContext = #"main"
1631 \override Clef #'stencil = ##f
1632 \override TimeSignature #'stencil = ##f
1633 % Reduce all font sizes by ~24%
1643 Das sieht aber immer noch nicht richtig aus. Die Notenköpfe
1644 und Fähnchen sind kleiner, aber die Hälse im Vergleich
1645 dazu zu lang und die Notenlinien zu weit auseinander.
1646 Sie müssen auch proportional zur Schriftart verkleinert
1647 werden. Der nächste Abschnitt behandelt diese Anpassung.
1650 @node Length and thickness of objects
1651 @subsection Length and thickness of objects
1653 @cindex Entfernungen
1657 @cindex Größe, verändern
1658 @cindex Notenhalslänge, verändern
1659 @cindex Hälse, Länge verändern
1660 @cindex Notenlinien, Länge verändern
1662 Abstände und Längen werden in LilyPond üblicherweise
1663 in Notenlinienabständen (engl. staff-spaces) gemessen.
1664 Das ist der Abstand zwischen zwei Notenlinien im System.
1665 Die meisten Dicken (engl. thickness) dagegen werden in
1666 einer internen Einheit Linien-Dicke (engl. line-thickness)
1667 gemessen. Die Linien von Dynamikklammern zum Beispiel
1668 haben standardmäßig eine Dicke von einer Einheit
1669 @code{line-thickness}, während die Dicke eines
1670 Notenhalses 1,3 ist. Beachten Sie jedoch, dass sich
1671 manche Dicken anders verhalten: die Dicke von
1672 Balken etwa wird in Notenlinienabständen gemessen.
1674 Wie also werden Längen skaliert um der Schriftgröße
1675 zu entsprechen? Das kann mit einer besonderen Funktion
1676 @code{magstep} vorgenommen werden, die genau für
1677 diesen Zweck vorhanden ist. Sie nimmt ein Argument auf,
1678 die Änderung der Schriftgröße (#-2 im obigen Beispiel)
1679 und gibt einen Skalierungsfaktor aus, der dazu dient,
1680 Objekte proportionell zueinander zu verändern. So wird
1683 @cindex alignAboveContext-Eigenschaft, Beispiel
1684 @cindex über dem System anordnen, Beispiel
1685 @cindex @code{\with}-Beispiel
1686 @cindex stencil-Eigenschaft, Beispiel
1687 @cindex Schlüssel, Beispiel zur Veränderung
1688 @cindex Taktart, Beispiel zur Veränderung
1689 @cindex Notenlinienabstände verändern
1690 @cindex staff-space-Eigenschaft verändern
1691 @cindex magstep-Funktion, Beispiel
1692 @cindex Schriftart-Eigenschaft, Beispiel
1694 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
1695 \new Staff ="main" {
1702 alignAboveContext = #"main"
1703 \override Clef #'stencil = ##f
1704 \override TimeSignature #'stencil = ##f
1706 % Reduce stem length and line spacing to match
1707 \override StaffSymbol #'staff-space = #(magstep -2)
1717 Da die Länge eines Halses und viele andere Längeneigenschaften
1718 relativ zum Wert des Notenlinienabstands (@code{staff-space})
1719 errechnet werden, werden sie auch automatisch verkleinert.
1720 Das wirkt sich jedoch nur auf die vertikale Skalierung des Ossias
1721 aus -- die horizontale Skala ist durch das Layout des Haupsystems
1722 bestimmt und wird also von diesen Größenänderungen nicht
1723 betroffen. Wenn natürlich die Größe der gesamten Noten reduziert
1724 würde, würde sich auch die horizontalen Abstände ändern. Dass
1725 wird später im Layout-Abschnitt betrachtet.
1727 Mit dieser Änderung ist unser Ossia fertig. Die Größen und Längen
1728 aller anderen Objekte können auf analoge Weise geändert
1731 Für kleine Größenänderungen, wie in dem obigen Beispiel,
1732 braucht die Dicke der verschiedenen Linien, wie Taktlinien,
1733 Notenlinien, Balken, Dynamikklammern usw. normalerweise
1734 keine spezielle Anpassung. Wenn die Dicke eines bestimmten
1735 Layout-Objektes angepasst werden muss, kann man das erreichen,
1736 indem die entsprechende @code{thickness}-Eigenschaft des
1737 Objekts mit @code{\override} verändert wird. Ein Beispiel,
1738 wie man die Dicke von Bögen ändert, wurde schon gezeigt,
1739 siehe @ref{Properties of layout objects}. Die Dicke aller
1740 gezeichneten Objekte (die also nicht aus einer Schriftart
1741 stammen) können auf gleiche Weise geändert werden.
1744 @node Placement of objects
1745 @section Placement of objects
1748 * Automatic behavior::
1749 * Within-staff objects::
1750 * Outside-staff objects::
1754 @node Automatic behavior
1755 @subsection Automatic behavior
1757 @cindex within-staff-Objekte
1758 @cindex outside-staff-Objekte
1759 @cindex Objekte innerhalb des Notensystems
1760 @cindex Objekte außerhalb des Notensystems
1762 Es gibt Objekte der Notation, die zum Notensystem gehören, und
1763 andere, die außerhalb des Systems gesetzt werden müssen. Sie
1764 werden @code{within-staff}-Objekte bzw.
1765 @code{outside-staff}-Objekte genannt.
1767 @code{within-staff}-Objekte werden innerhalb des Notensystems
1768 (engl. staff) gesetzt: Notenköpfe, Hälse, Versetzungszeichen
1769 usw. Ihre Position ist üblicherweise durch die notierte Musik
1770 bestimmt -- sie werden vertikal auf bestimmten Linien notiert
1771 oder sind an andere Objekte gebunden, die vertikal festgelegt
1772 sind. Kollisionen von Notenköpfen, Hälsen und Versetzungszeichen
1773 werden normalerweise automatisch vermieden. Es gibt
1774 Befehle, um dieses automatische Verhalten zu verändern, wie
1775 unten gezeigt werden soll.
1777 Objekte, die außerhalb des Notensystems gesetzt werden, sind
1778 unter Anderem Übungsmarkierungen, Text und Dynamikzeichen.
1779 LilyPonds Regel für ihre vertikale Positionierung lautet, sie so nah wie
1780 möglich am Notensystem zu setzen, aber nicht so nah, dass
1781 sie mit anderen Objekten kollidieren. Dabei wird die
1782 @code{outside-staff-priority}-(Priorität außerhalb des Notensystems)-Eigenschaft
1783 eingesetzt, um die Reihenfolge zu bestimmen, in denen Objekte gesetzt werden
1786 Zuerst werden alle Innersystemobjekte von LilyPond gesetzt.
1787 Dann werden die Objekte außerhalb des Systems nach
1789 @code{outside-staff-priority} geordnet. Die @code{outside-staff}-Objekte
1790 werden dann nacheinander gesetzt, mit der niedrigsten
1791 Priorität beginnend, und so gesetzt, dass sie nicht mit anderen
1792 Objekten kollidieren, die schon gesetzt wurden. Wenn also zwei
1793 @code{outside-staff}-Objekte um den selben Platz streiten,
1794 wird das mit der geringeren @code{outside-staff-priority} näher
1795 am System gesetzt werden. Wenn zwei Objekte die selbe Priorität
1796 haben, wird das näher am System gesetzt, welches zuerst
1799 Im folgenden Beispiel haben alle Textbeschriftungen die gleiche
1800 Priorität (weil sie nicht explizit gesetzt worden ist). Beachten Sie,
1801 dass @qq{Text3} wieder dicht am System gesetzt wurde, weil
1802 er unter @qq{Text2} passt.
1804 @cindex Textbeschriftungsbeispiel
1806 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
1813 Notensysteme werden in den Standardeinstellungen auch so dicht
1814 beeinander gesetzt wie es möglich ist (mit einem minimalen Abstand).
1815 Wenn Noten sehr weit aus einem System herausragen, zwingen sie
1816 das nächste System weiter weg, wenn eine Kollision drohen würde.
1817 Im nächsten Beispiel sehen Sie, wie Noten auf zwei Systemen
1818 @qq{ineinander greifen}.
1820 @lilypond[quote,ragged-right,verbatim]
1823 \relative c' { c a, }
1826 \relative c'''' { c a, }
1832 @node Within-staff objects
1833 @subsection Within-staff objects
1835 Es wurde schon gezeigt, wie die Befehle @code{\voiceXXX} die Richtung
1836 von Bögen, Fingersatz und allen anderen Objekten beeinflusst,
1837 die von der Richtung der Notenhälsen abhängen. Diese Befehle
1838 sind nötig, wenn polyphone Musik geschrieben wird, damit sich
1839 die einzelnen Melodielinien klar abzeichnen. Es kann aber von Zeit
1840 zu Zeit nötig sein, dieses automatische Verhalten zu verändern. Das
1841 kann entweder für ganze Abschnitte, aber genauso auch nur für eine
1842 einzelne Note vorgenommen werden. Die Eigenschaft, die die Richtung
1843 bestimmt, ist die @code{direction}-Eigenschaft jedes Layout-Objekts.
1844 Es soll erst erklärt werden, was sie bewirkt und dann eine Anzahl
1845 an fertigen Befehlen für die üblicheren Situationen präsentiert werden,
1846 mit denen Sie gleich loslegen können.
1848 Manche Layout-Objekte, wie Legato- und Bindebögen, biegen sich
1849 oder zeigen entweder nach oben oder nach unten, andere, wie
1850 Hälse und Fähnchen, verändern auch die Position rechts oder links,
1851 je nach der Richtung, in die sie zeigen. Das wird automatisch
1852 berücksichtigt, wenn die @code{direction}-Eigenschaft verändert
1859 @cindex hoch-Eigenschaft
1860 @cindex runter-Eigenschaft
1861 @cindex zentriert-Eigenschaft
1862 @cindex neutral-Eigenschaft
1864 Das folgende Beispiel zeigt im ersten Takt die Standardeinstellung
1865 für Hälse, die bei hohen Noten nach unten zeigen und bei tiefen
1866 noten nach oben. Im nächsten Takt werden alle Hälse nach unten
1867 gezwungen, im dritten Takt nach oben, und im vierten wird wieder
1868 der Standard eingestellt.
1870 @cindex Notenhals, Beispiel zur Veränderung
1871 @cindex Richtungseigenschaft, Beispiel
1873 @lilypond[quote,verbatim,relative=2]
1875 \override Stem #'direction = #DOWN
1877 \override Stem #'direction = #UP
1879 \revert Stem #'direction
1883 Hier werden die Konstanten @code{DOWN} und @code{UP}
1884 eingesetzt. Sie haben die Werte @code{-1} bwz. @code{+1}, und
1885 diese numerischen Werte können ebenso benutzt werden. Auch
1886 der Wert @code{0} kann in manchen Fällen benutzt werden. Er
1887 bedeutet für die Hälse das gleiche wie @code{UP}, für einige
1888 andere Objekte jedoch @qq{zentiert}. Es gibt hierzu die Konstante
1889 @code{CENTER}, die den Wert @code{0} hat.
1891 Es gibt aber einfachere Befehle, die normalerweise benutzt werden.
1892 Hier eine Tabelle der häufigsten. Die Bedeutung des Befehls wird
1893 erklärt, wenn sie nicht selbsverständlich ist.
1895 @multitable @columnfractions .2 .2 .25 .35
1896 @headitem Runter/Links
1900 @item @code{\arpeggioArrowDown}
1901 @tab @code{\arpeggioArrowUp}
1902 @tab @code{\arpeggioNormal}
1903 @tab Arpeggio mit Pfeil nach unten, oben oder ohne Pfeil
1904 @item @code{\dotsDown}
1906 @tab @code{\dotsNeutral}
1907 @tab Richtung der Verschiebung eines Punktes, um Notenlinien zu vermeiden
1908 @item @code{\dynamicDown}
1909 @tab @code{\dynamicUp}
1910 @tab @code{\dynamicNeutral}
1911 @tab Position der Dynamik-Bezeichnung relativ zum System
1912 @item @code{\phrasingSlurDown}
1913 @tab @code{\phrasingSlurUp}
1914 @tab @code{\phrasingSlurNeutral}
1915 @tab Befehl für Richtung von Phrasierungsbögen
1916 @item @code{\slurDown}
1918 @tab @code{\slurNeutral}
1919 @tab Befehl für Richtung von Legatobögen
1920 @item @code{\stemDown}
1922 @tab @code{\stemNeutral}
1923 @tab Befehl für Richtung von Hälsen
1924 @item @code{\textSpannerDown}
1925 @tab @code{\textSpannerUp}
1926 @tab @code{\textSpannerNeutral}
1927 @tab Position von Textbeschrifungen, die als Strecker eingegeben werden
1928 @item @code{\tieDown}
1930 @tab @code{\tieNeutral}
1931 @tab Befehl für Richtung von Bindebögen
1932 @item @code{\tupletDown}
1933 @tab @code{\tupletUp}
1934 @tab @code{\tupletNeutral}
1935 @tab Befehl für Richtung von Klammern/Zahlen der N-tolen
1938 Diese vordefinierten Befehl können allerdings @strong{nicht}
1939 zusammen mit @code{\once} benutzt werden. Wenn Sie die
1940 Wirkung eines Befehl auf eine einzige Noten begrenzen wollen,
1941 müssen Sie den entsprechenden
1942 @code{\once \override}-Befehl benutzen oder den definierten
1943 Befehl, gefolgt von dem entsprechenden neutralisierenden
1944 @code{xxxNeutral}-Befehl nach der Note.
1947 @subheading Fingering
1949 @cindex Fingersatz, Positionierung
1950 @cindex Fingersatz, Akkorde
1952 Die Positionierung von Fingersatz kann auch durch den Wert
1953 seiner @code{direction}-Eigenschaft beeinflusst werden, aber
1954 eine Veränderung von @code{direction} hat keinen Einfluss auf
1955 Akkorde. es gibt auch hier
1956 besondere Befehle, mit denen der Fingersatz von einzelnen
1957 Noten in Akkorden kontrolliert werden kann, wobei mögliche
1958 Positionen über, unter der Note und rechts bzw. links von
1961 Zunächst die Wirkungsweise von @code{direction} auf
1962 den Fingersatz: im ersten Takt der Standard, dann
1963 die Wirkung von @code{DOWN} (runter) und @code{UP}
1966 @cindex Fingersatz, Beispiel zur Veränderung
1967 @cindex direction-Eigenschaft, Beispiel
1969 @lilypond[quote,verbatim,relative=2]
1971 \override Fingering #'direction = #DOWN
1973 \override Fingering #'direction = #UP
1977 Eine Beeinflussung der @code{direction}-Eigenschaft ist jedoch
1978 nicht die einfachste Art, Fingersatzbezeichnungen manuell über oder
1979 unter das System zu setzen. Normalerweise bietet es sich an,
1980 @code{_} oder @code{^} anstelle von @code{-} vor der Fingersatz-Zahl
1981 zu benutzen. Hier das vorherigen Beispiel mit dieser Methode:
1983 @cindex Fingersatz-Beispiel
1985 @lilypond[quote,verbatim,relative=2]
1991 Die @code{direction}-Eigenschaft wirkt sich nicht auf
1992 Akkorde aus, während die Präfixe @code{_} und @code{^} funktionieren.
1993 Standardmäßig wird der Fingersatz automatisch entweder
1994 über oder unter dem Akkord gesetzt:
1996 @cindex Fingersatz-Beispiel
1998 @lilypond[quote,verbatim,relative=2]
2005 aber das kann manuell geändert werden, um einzelne Fingersatzanweisungen
2006 nach oben oder unten zu zwingen:
2008 @cindex Fingersatz-Beispiel
2010 @lilypond[quote,verbatim,relative=2]
2016 Noch bessere Kontrolle über die Positionierung von Fingersatz für
2017 einzelne Noten in einem Akkord ist mit dem
2018 @code{\set fingeringOrientations}-Befehl möglich. Die Syntax
2022 @code{\set fingeringOrientations = #'([up] [left/right] [down])}
2026 @code{\set}wird benutzt, weil @code{fingeringOrientations} eine
2027 Eigenschaft des @code{Voice}-Kontextes ist, erstellt und eingesetzt
2028 vom @code{New_fingering_engraver}.
2030 Die Eigenschaft kann als Wert eine Liste mit einem bis drei Einträgen
2031 haben. Damit wird bestimmt, ob Fingersatz oberhalb gesetzt
2032 werden kann (wenn @code{up} in der Liste auftaucht), darunter
2033 (wenn@code{down} auftaucht), links (wenn @code{left} auftaucht)
2034 oder rechts (wenn @code{right} auftaucht). Wenn andererseits
2035 ein Wert nicht auftaucht, wir auch kein Fingersatz in dieser Richtung
2036 gesetzt. LilyPond nimmt diese Beschränkung als Bedingung und
2037 errechnet die besten Positionen für die Noten des nächsten Akkordes.
2038 Die seitliche Positionierung kann nur auf einer Seite des Akkordes
2039 geschehen, nicht auf beiden gleichzeitig, es kann also nur entweder
2040 @code{left} oder @code{right} auftreten, nicth beide gleichzeitig.
2042 @warning{Damit eine einzelne Note mit diesem Befehl beeinflusst werden
2043 kann, muss sie als ein @qq{Ein-Noten-Akkord} geschrieben
2044 werden, indem einfache spitze Klammern um die Note positioniert
2047 Hier ein paar Beispiele:
2049 @cindex Fingersatz-Beispiel
2050 @cindex @code{\set}, Benutzungsbeispiel
2051 @cindex fingerOrientations-Eigenschaft, Beispiel
2053 @lilypond[quote,verbatim,relative=1]
2054 \set fingeringOrientations = #'(left)
2056 < c-1 e-2 g-3 b-5 > 4
2057 \set fingeringOrientations = #'(left)
2059 < c-1 e-2 g-3 b-5 > 4
2060 \set fingeringOrientations = #'(up left down)
2062 < c-1 e-2 g-3 b-5 > 4
2063 \set fingeringOrientations = #'(up left)
2065 < c-1 e-2 g-3 b-5 > 4
2066 \set fingeringOrientations = #'(right)
2068 < c-1 e-2 g-3 b-5 > 4
2072 Wenn die Fingersatzbezeichnung zu gedrungen aussieht,
2073 kann auch die Schriftgröße (@code{font-size}) verringert
2074 werden. Der Standardwert kann aus dem
2075 @code{Fingering}-Objekt in der IR entnommen werden,
2076 er ist @code{-5}, versuchen wir es also mit @code{-7}.
2078 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2079 \override Fingering #'font-size = #-7
2080 \set fingeringOrientations = #'(left)
2082 < c-1 e-2 g-3 b-5 > 4
2083 \set fingeringOrientations = #'(left)
2085 < c-1 e-2 g-3 b-5 > 4
2086 \set fingeringOrientations = #'(up left down)
2088 < c-1 e-2 g-3 b-5 > 4
2089 \set fingeringOrientations = #'(up left)
2091 < c-1 e-2 g-3 b-5 > 4
2092 \set fingeringOrientations = #'(right)
2094 < c-1 e-2 g-3 b-5 > 4
2099 @node Outside-staff objects
2100 @subsection Outside-staff objects
2102 Objekte außerhalb des Notensystems werden automatisch gesetzt,
2103 um Kollisionen zu vermeiden. Objekten mit einem geringeren
2104 Prioritätswert der Eigenschaft @code{outside-staff-priority}
2105 werden näher an das System gesetzt, und andere Objekte außerhalb
2106 des Systems werden dann soweit vom System entfernt gesetzt, dass
2107 Zusammenstöße vermieden werden. Die
2108 @code{outside-staff-priority}-Eigenschaft ist im
2109 @code{grob-interface} definiert und ist also eine Eigenschaft
2110 von allen Layout-Objekten. Standardmäßig ist sie für alle Objekte
2111 auf falsch (@code{#f}) gesetzt; dieser Wert wird in einen numerischen
2112 Wert dem Objekt entsprechend geändert, wenn das Objekt für die
2113 Notenausgabe erstellt wird. Die Tabelle unten zeigt die
2114 Standardwerte für die meistbenutzten @code{outside-staff}-Objekte,
2115 die den Voreinstellungen nach im
2116 @code{Staff}- oder @code{Voice}-Kontext gesetzt werden.
2118 @multitable @columnfractions .3 .3 .3
2119 @headitem Layout-Objekt
2121 @tab Kontrolliert Position von:
2122 @item @code{MultiMeasureRestText}
2124 @tab Text über Ganztaktpausen
2125 @item @code{TextScript}
2127 @tab Textbeschriftung
2128 @item @code{OttavaBracket}
2130 @tab Ottava (Oktavierungsklammern)
2131 @item @code{TextSpanner}
2134 @item @code{DynamicLineSpanner}
2136 @tab Alle Dynamik-Bezeichnungen
2137 @item @code{VoltaBracketSpanner}
2140 @item @code{TrillSpanner}
2142 @tab Triller-Strecker
2145 Hier ein Beispiel, das die Standardpositionierung von einigen
2148 @cindex Text-Strecker
2149 @cindex Text-Spanner
2150 @funindex \startTextSpan
2151 @funindex \stopTextSpan
2152 @funindex startTextSpan
2153 @funindex stopTextSpan
2154 @cindex Ottava-Klammer
2155 @cindex Oktavierungsklammer
2157 @cindex TextSpanner, Beispiel zur Veränderung
2158 @cindex bound-details-Eigenschaft, Beispiel
2160 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2161 % Set details for later Text Spanner
2162 \override TextSpanner #'(bound-details left text)
2163 = \markup { \small \bold Slower }
2164 % Place dynamics above staff
2166 % Start Ottava Bracket
2171 % Add Dynamic Line Spanner
2177 c\ff c \stopTextSpan
2178 % Stop Ottava Bracket
2183 Dieses Beispiel zeigt auch, wie man Text-Strecker erstellt, d.h.
2184 Text mit Bindestrichen, der sich über eine bestimmte Länge
2185 erstreckt. Der Strecker beginnt mit dem
2186 @code{\startTextSpan}-Befehl und endet mit dem
2187 @code{\stopTextSpan}-Befehl, und das Format des Textes
2188 wird mit dem @code{\override TextSpanner}-Befehl bestimmt.
2189 Mehr Einzelheiten siehe @ruser{Text spanners}.
2191 Im Beispiel wird auch gezeigt, wie Oktavierungsklammern
2192 (Ottava) erstellt werden.
2194 @cindex Taktzahlposition verändern
2195 @cindex Verändern der Taktzahlposition
2196 @cindex Position der Taktzahl, verändern
2197 @cindex Metronom-Bezeichnungsposition verändern
2198 @cindex Verändern der Metronom-Bezeichnungsposition
2199 @cindex Übungszeichenposition verändern
2200 @cindex Verändern der Übungszeichenposition
2202 Beachten Sie, dass Taktnummern, Metronombezeichnungen
2203 und Übungszeichen nicht gezeigt werden. Sie werden
2204 standardmäßig im @code{Score}-(Partitur)-Kontext
2205 erstellt und ihre @code{outside-staff-priority} wird
2206 in Bezug auf die Layout-Objekte, die im @code{Staff}-Kontext
2207 erstellt werden, ignoriert. Wenn Sie Taktnummern,
2208 Metronombezeichnungen oder Übungszeichen entsprechend
2209 ihrer Außersystem-Priorität setzen wollen, müssen Sie
2210 die entsprechenden Engraver (@code{Bar_number_engraver},
2211 @code{Metronome_mark_engraver} oder @code{Mark_engraver})
2212 vom @code{Score}-Kontext entfernen und dem
2213 @code{Staff}-Kontext hinzufügen. Wenn die Engraver so
2214 geändert werden, erhalten sie folgenden Werte für
2215 @code{outside-staff-priority}:
2217 @multitable @columnfractions .3 .3
2218 @headitem Layout-Objekt @tab Priorität
2219 @item @code{RehearsalMark} @tab @code{1500}
2220 @item @code{MetronomeMark} @tab @code{1000}
2221 @item @code{BarNumber} @tab @code{ 100}
2224 Wenn die Standardwerte der @code{outside-staff-priority} nicht
2225 die Positionierung hervorrufen, die Sie wünschen, kann die
2226 Priorität eines jeden Objektes geändert werden. Als Beispiel
2227 wollen wir zeigen, wie sich die Oktavierungsklammer unter
2228 den Textstrecker des vorigen Beispiels setzen lässt. Wir müssen
2229 nur die Priorität des
2230 @code{OttavaBracket}-Objektes in der IR oder der Tabelle oben
2231 herausfinden und einen kleineren Wert angeben als der Wert, den
2232 das @code{TextSpanner}-(Strecker)-Objekt bekommt, wobei noch daran
2233 zu denken ist, dass @code{OttavaBracket} im @code{Staff}-Kontext
2236 @cindex TextSpanner, Beispiel zur Veränderung
2237 @cindex bound-details-Eigenschaft, Beispiel
2239 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2240 % Set details for later Text Spanner
2241 \override TextSpanner #'(bound-details left text)
2242 = \markup { \small \bold Slower }
2243 % Place dynamics above staff
2245 %Place following Ottava Bracket below Text Spanners
2246 \once \override Staff.OttavaBracket #'outside-staff-priority = #340
2247 % Start Ottava Bracket
2252 % Add Dynamic Line Spanner
2258 c\ff c \stopTextSpan
2259 % Stop Ottava Bracket
2264 @cindex Legatobögen und outside-staff-priority
2265 @cindex Legatobögen und Artikulationszeichen
2266 @cindex Artikulationszeichen und Legatobögen
2268 Legatobögen werden als Innersystem-Objekte klassifiziert, aber
2269 sie erscheinen oft auch über dem System, wenn die Noten, an die
2270 sie verbunden sind, sehr hoch im System notiert sind. Dadurch
2271 können Außersystem-Objekte, wie Artikulationszeichen, zu hoch
2272 gerückt werden. Die @code{avoid-slur}-Eigenschaft hat nur
2273 eine Auswirkung, wenn auch die @code{outside-staff-priority}
2274 auf @code{#f} gesetzt ist. Alternativ kann die
2275 @code{outside-staff-priority} des Legatobogens auf einen
2276 numerischen Wert gesetzt werden, sodass er mit anderen
2277 Außersystem-Objekten anhand dieses Wertes gesetzt wird.
2278 Hier ein Beispiel, das die beiden Möglichkeiten veranschaulicht:
2280 @lilypond[quote,verbatim,relative=2]
2281 c4( c^\markup\tiny\sharp d4.) c8
2283 \once \override TextScript #'avoid-slur = #'inside
2284 \once \override TextScript #'outside-staff-priority = ##f
2285 c^\markup\tiny\sharp d4.) c8
2286 \once \override Slur #'outside-staff-priority = #500
2287 c4( c^\markup\tiny\sharp d4.) c8
2290 Eine Änderung der @code{outside-staff-priority} kann auch dazu
2291 benutzt werden, die vertikale Plazierung von individuellen Objekten
2292 zu kontrollieren, auch wenn das Ergebnis nicht immer optimal
2293 ist. Im nächsten Beispiel soll @qq{Text3} oberhalb von @qq{Text4}
2294 gesetzt werden, das Beispiel wurde behandelt in
2295 @ref{Automatic behavior}. Der Wert der Priorität muss also für
2296 die Eigenschaft @code{TextScript} entweder in der IR oder in der
2297 Tabelle oben festgestellt werden und dann die Priorität für
2298 @qq{Text3} höher eingestellt werden:
2300 @cindex TextScript, Beispiel zur Veränderung
2301 @cindex outside-staff-priority-Eigenschaft, Beispiel
2303 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2306 \once \override TextScript #'outside-staff-priority = #500
2311 Damit wird zwar @qq{Text3} ganz richtig über @qq{Text4}
2312 platziert, aber auch über @qq{Text2}, und @qq{Text4}
2313 wird jetzt weiter unten gesetzt. Eigentlich sollten ja alle
2314 diese Anmerkungen gleichweit vom System entfernt sein.
2315 Dazu muss offensichtlich horizontal etwas Platz gemacht
2316 werden. Das kann erreicht werden mit dem
2317 @code{textLengthOn}-(Textlänge an)-Befehl.
2319 @subheading \textLengthOn
2321 @cindex Noten, durch Text gespreizt
2322 @funindex \textLengthOn
2323 @funindex textLengthOn
2324 @funindex \textLengthOff
2325 @funindex textLengthOff
2327 Standardmäßig wird Text, der mit dem Beschriftungsbefehl
2328 @code{\markup} bzw. Äquivalenten erstellt wird, kein
2329 zusätzlicher Platz in Bezug auf die Positionierung der Noten
2330 zugestanden. Der @code{\textLengthOn}-Befehl ändert
2331 dieses Verhalten, so dass die Noten gespreizt werden, wenn
2332 die Breite des Textes es erfordert:
2334 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2335 \textLengthOn % Cause notes to space out to accommodate text
2342 Dieses Verhalten wird mit dem @code{\textLengthOff}-Befehl
2343 rückgängig gemacht. Erinnern Sie sich, dass @code{\once} nur mit
2344 @code{\override}, @code{\set}, @code{\revert} oder @code{unset}
2345 funktioniert, der Befehl kann also nicht zusammen mit
2346 @code{\textLengthOn} benutzt werden.
2348 @cindex Textbeschriftung, Vermeidung von Zusammenstößen
2349 @cindex Zusammenstöße vermeiden mit Textbeschriftung
2351 Textbeschriftung vermeidet auch Noten, die über das System hinausstehen.
2352 Wenn das nicht gewünscht ist, kann die automatische Verschiebung
2353 nach oben hin auch vollständig ausgeschaltet werden, indem die
2354 Priorität auf @code{#f} gesetzt wird. Hier ein Beispiel, wie
2355 eine Textbeschriftung mit diesen Noten reagiert:
2357 @cindex Textbeschriftung, Beispiel zur Veränderung
2358 @cindex outside-staff-priority-Eigenschaft, Beispiel
2360 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2361 % This markup is short enough to fit without collision
2365 % This is too long to fit, so it is displaced upwards
2369 % Turn off collision avoidance
2370 \once \override TextScript #'outside-staff-priority = ##f
2374 % Turn off collision avoidance
2375 \once \override TextScript #'outside-staff-priority = ##f
2376 \textLengthOn % and turn on textLengthOn
2377 c,,2^"Long Text " % Spaces at end are honored
2382 @subheading Dynamics
2384 @cindex Verändern der Positionierung von Dynamikzeichen
2385 @cindex Dynamikzeichen: Positionierung verändern
2387 Dynamikbezeichnung wird üblicherweise unter dem System
2388 gesetzt, kann aber auch nach oben mit dem Befehl
2389 @code{dynamicUp} gezwungen werden. Die Bezeichnung
2390 wird vertikal relativ zu der Note positioniert, an die sie angefügt
2391 wurde. Sie wird vertikal variabel gesetzt in Bezug zu
2392 Innersystemobjekten wie Bögen oder Taktnummern. Damit
2393 können oft recht gute Resultate erreicht werden, wie im
2396 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
2401 bes4.~\f\< \( bes4 bes8 des4\ff\> c16 bes\! |
2402 ees,2.~\)\mf ees4 r8 |
2405 Wenn aber Noten und Dynamikzeichen sehr dicht beieinander
2406 stehen, positioniert die automatische Kollisionsvermeidung
2407 später kommende Dynamikzeichen weiter weg, was allerdings
2408 nicht immer die beste Möglichkeit ist, wie in dem folgenden,
2409 etwas gewollten Beispiel zu sehen ist:
2411 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2417 Wenn eine ähnliche Situation in @qq{echter} Musik auftaucht,
2418 kann es nötig sein, die Noten etwas zu spreizen, damit die
2419 Dynamikzeichen alle auf der selben vertikalen Position
2420 gesetzt werden können. Dieses Verhalten war im Falle von
2421 Textbeschriftungen möglich mit dem @code{\textLengthOn}-Befehl,
2422 aber es gibt keinen entsprechenden Befehl für Dynamik. Wir
2423 müssen also unsere eigenen Befehle mit @code{\override}
2427 @subheading Grob sizing
2429 @cindex Grob, Größenveränderung
2430 @cindex Größenveränderung von grobs
2432 Zuallererst müssen wir lernen, wie die Größe von Grobs verändert
2433 wird. Alle Grobs besitzen einen Referenzpunkt, der
2434 benutzt wird, um ihre Position in Relation zu ihnen übergeordneten
2435 Objekten zu bestimmen. Dieser Punkt innerhalb des Grobs wird dann
2436 auf einer horizontalen Position (@code{X-offset}) und einer
2437 vertikalen Position (@code{Y-offset}) ausgerichtet, immer bezüglich
2438 des übergeordneten Objektes. Eine horizontale Strecke wird
2439 durch ein Zahlenpaar angegeben (@code{X-extent}), welche
2440 die linke und rechte Grenze relativ zum übergeordneten Objekt
2441 bezeichnen. Die vertikale Strecke wir genauso durch ein
2442 Zahlenpaar (@code{Y-extent}) definiert. Diese Eigenschaften
2443 gehören zu allen Grobs, die das
2444 @code{grob-interface} unterstützen.
2446 @cindex @code{extra-spacing-width}
2448 Standardmäßig haben Außersystemobjekte eine Länge von Null,
2449 so dass sie sich in horizontaler Richtung überlappen können. Das
2450 geschieht, indem dem linken Rand Unendlich zugewiesen wird
2451 und dem rechten Rand minus Undendlich (der Code der
2452 @code{extra-spacing-width}-(zusätzliche Positionierungslänge)-Eigenschaft
2453 lautet: @code{'(+inf.0 . -inf.0)}).
2454 Damit sich diese Objekte also horizontal nicht überschneiden, muss
2455 der Wert von @code{extra-spacing-width} auf
2456 @code{'(0 . 0)} gesetzt werden, sodass die wirkliche Länge eines
2457 Objektes zur Geltung kommt. Mit diesem Befehl wird das für
2458 Dynamik-Zeichen erledigt:
2461 \override DynamicText #'extra-spacing-width = #'(0 . 0)
2465 Schauen wir uns an, wie es mit dem vorigen Beispiel funktioniert:
2467 @cindex DynamicText, Beispiel zur Veränderung
2468 @cindex extra-spacing-width-Eigenschaft, Beispiel
2470 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2472 \override DynamicText #'extra-spacing-width = #'(0 . 0)
2477 Damit werden die Dynamik-Zeichen also wirklich nebeneinander
2478 gesetzt, aber es gibt noch zwei Probleme. Die Zeichen sollten
2479 etwas weiter außeinander stehen und es wäre gut, wenn sie alle
2480 den gleichen Abstand zum System hätte. Das erste Problem ist
2481 einfach behoben. Anstatt der @code{extra-spacing-width}-Eigenschaft
2482 Null zuzuweisen, können wir auch einen etwas größeren Wert
2483 wählen. Die Einheit wird gemessen in dem Abstand zwischen zwei
2484 Notenlinien, es scheint also gut, den rechten und linken
2485 Rand eine halbe Einheit zu vergrößern:
2487 @cindex DynamicText, Beispiel zur Veränderung
2488 @cindex extra-spacing-width-Eigenschaft, Beispiel
2490 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2492 % Extend width by 1 staff space
2493 \override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
2498 Das sieht schon besser aus, aber es wäre noch besser, wenn die
2499 Dynamik-Zeichen alle an einer Linie ausgerichtet wären, anstatt
2500 höher und tiefer zu sitzen. Das kann mit der
2501 @code{staff-padding}-Eigenschaft erreicht werden,
2502 die wir uns im folgenden Abschnitt genauer anschauen werden.
2506 @node Collisions of objects
2507 @section Collisions of objects
2511 * Fixing overlapping notation::
2512 * Real music example::
2515 @node Moving objects
2516 @subsection Moving objects
2518 @cindex Verschieben von überschneidenden Objekten
2519 @cindex Verschieben von Zusammenstößen
2520 @cindex Zusammenstöße vermeiden
2521 @cindex Objekte, verschieben von Zusammestößen
2522 @cindex Vermeiden von Zusammenstößen
2524 Es wird vielleicht eine Überraschung sein, aber LilyPond ist nicht
2525 perfekt. Einige Notationselemente können sich überschneiden. Das
2526 ist nicht schön, aber zum Glück sehr selten. Normalerweise müssen
2527 die Objekte zur Klarheit oder aus ästhetischen Gründen verschoben
2528 werden -- sie könnten besser aussehen, wenn sie etwas zusätzlichen
2531 Es gibt im Grunde drei Herangehensweisen, überlappende Notation
2532 zu verbessern. Man sollte sie in der folgenden Reihenfolge
2537 Die @strong{Richtung} eines der überlappenden Objekte kann
2538 geändert werden, indem die vordefinierten Befehle für
2539 Innersystemobjekte verwendet werden, wie beschrieben in
2540 @ref{Within-staff objects}. Hälse, Bögen, Balken, Dynamik-Zeichen
2541 und Triolen können auf diese Weise einfach umgeordnet
2542 werden. Beschränkt ist diese Methode insofern, als es nur
2543 zwei Möglichkeiten zur Veränderung gibt: oben oder unten.
2546 Die @strong{Objekteigenschaft}, die LilyPond benutzt um die
2547 Layout-Objekte zu platzieren, können mit dem
2548 @code{\override}-Befehl positioniert werden. Die Vorteile
2549 von Änderungen dieser Art sind a) dass einige Objekte
2550 automatisch verschoben werden, wenn es nötig ist Platz zu
2551 schaffen und b) ein einziges @code{\override} sich auf
2552 alle Fälle eines Objekttyps bezieht. Zu diesen Eigenschaften
2558 @code{direction} (Richtung)
2560 Das wurde schon detailliert behandelt, siehe
2561 @ref{Within-staff objects}.
2564 @code{padding}, @code{left-padding},
2565 @code{right-padding}, @code{staff-padding} (Verschiebung)
2567 @cindex left-padding-Eigenschaft
2568 @cindex Padding-Eigenschaft
2569 @cindex right-padding-Eigenschaft
2570 @cindex staff-padding-Eigenschaft
2571 @cindex Verschieben (padding)
2572 @cindex Füllung (padding)
2573 @cindex padding (Füllung)
2575 Wenn ein Objekt platziert wird, bestimmt der Wert seiner
2576 @code{padding}-(Füllungs)-Eigenschaft die Größe des
2577 Abstandes, der zwischen dem Objekt selber und dem
2578 Objekt, relativ zu welchem es positioniert wird, gelassen
2579 werden muss. Dabei zählt der @code{padding}-Wert
2580 des Objektes, das platziert werden soll, der @code{padding}-Wert
2581 des Objektes, das schon gesetzt wurde, wird hingegegen
2582 ignoriert. Abstände mit @code{padding} können zu
2583 allen Objekten hinzugefügt werden, die das
2584 @code{side-position-interface} unterstützen.
2586 Anstelle von @code{padding} wird die Position von
2587 Versetzungszeichengruppen durch die Eigenschaften
2588 @code{left-padding} und @code{right-padding} bestimmt.
2589 Diese Eigenschaften werden im
2590 @code{AccidentalPlacement}-(Versetzungszeichen-Positionierungs)-Objekt
2591 gefunden, das sich innerhalb des @strong{Staff}-Kontexts
2592 befindet. Während des Notensatzes werden die Notenköpfe
2593 zuerst gesetzt und dann die Versetzungszeichen, wenn denn
2594 welche gesetzt werden, durch die @code{right-padding}-Eigenschaft
2595 auf die linke Seite der Notenköpfe positioniert, um die Entfernung
2596 von den Notenköpfen zu bestimmen. Also nur die
2597 @code{right-padding}-(Verschiebung nach rechts)-Eigenschaft des
2598 @code{AccidentalPlacement}-Objekts hat Einfluss auf die
2599 Positionierung der Versetzungszeichen.
2601 Die @code{staff-padding}-(Verschiebung zum System)-Eigenschaft
2602 ist sehr ähnlich wie die @code{padding}-Eigenschaft:
2603 @code{padding} bestimmt den Minimalabstand zwischen
2604 einem Objekt, das das @code{side-position-interface}
2605 unterstützt, und dem nächsten anderen Objekt (normalerweise
2606 die Note oder Notenlinie); @code{staff-padding} dagegen
2607 wirkt nur auf Objekte die immer außerhalb des Notensystems
2608 sind -- damit wird der minimale Abstand bestimmt, der
2609 zwischen dem Objekt und dem Notensystem gelassen werden
2610 soll. @code{staff-padding} hat also @strong{keinen Einfluss}
2611 auf Objekte, die relativ zu einer Note positioniert werden, sondern
2612 nur auf solche, die zum System relativ stehen. Wenn es mit einem
2613 anderen Objekt eingesetzt wird, erhält man keine Fehlermeldung, aber
2614 der Befehl hat auch keine Auswirkungen.
2616 Um herauszufinden, welche @code{padding}-Eigenschaft für
2617 das bestimmte Objekt nötig, ist, das Sie verschieben wollen,
2618 müssen Sie in der IR nach den Objekt-Eigenschaften schauen.
2619 Dabei sollten Sie bedenken, dass sich die @code{padding}-Eigenschaften
2620 nicht unbedingt in dem Objekt selber befinden, schauen Sie
2621 also auch in Objekten nach, die offensichtlich Ähnlichkeiten
2624 Alle @code{padding}-Werte werden in Notenlinienabständen
2625 gemessen. Für die meisten Objekte ist der Wert ungefähr auf
2626 1.0 oder weniger gesetzt (das variiert von Objekt zu Objekt).
2627 Der Wert kann geändert werden, wenn ein größerer (oder
2628 kleinerer) Abstand gewünscht wird.
2631 @code{self-alignment-X} (Selbstpositionierung)
2633 @cindex self-alignment-X-Eigenschaft
2634 @cindex Selbstpositionierung von Objekten
2635 @cindex Ausrichtung von Objekten
2637 Diese Eigenschaft kann benutzt werden, um ein Objekt
2638 nach links, rechts oder zentriert an dem Referenzpunkt des Objekts
2639 auszurichten, an das es verknüpft ist. Es kann bei allen
2640 Objekten benutzt werden, die das @code{self-alignment-interface}
2641 unterstützen. Das sind üblicherweise Objekte, die Text
2642 enthalten. Die möglichen Werte der Eigenschaft sind @code{LEFT},
2643 @code{RIGHT} oder @code{CENTER}. Alternativ kann ein
2644 numerischer Wert zwischen @code{-1} und @code{+1}
2645 bestimmt werden: @code{-1} heißt linksbündig, @code{+1}
2646 rechtsbündig und Zahlen dazwischen bewegen den Text
2647 schrittweise von links nach rechts. Zahlen größer als
2648 @code{1} können angegeben werdne, um den Text
2649 noch weiter nach links zu bewegen, oder weniger als @code{-1},
2650 um ihn weiter nach rechts zu schieben. Eine Änderung
2651 um @code{1} des Wertes entspricht einer Bewegung um
2652 die halbe Textbreite.
2655 @code{extra-spacing-width} (zusätzliche Breite)
2657 @cindex extra-spacing-width-Eigenschaft
2659 Diese Eigenschaft steht für alle Objekte zur Verfügung, die
2660 das @code{item-interface} unterstützen. Es braucht zwei
2661 Zahlen als Argument, die erste wird zur rechten Ausdehnung,
2662 die zweite zur linken Ausdehnung hinzugerechnet. Negative
2663 Zahlen verschieben die Ausdehnung nach rechts, positive nach
2664 links, um also ein Objekt zu verbreitern, muss die erste
2665 Zahl negativ und die zweite positiv sein. Allerdings beachten
2666 nicht alle Objekte beide Zahlen. Das
2667 @code{accidental}-(Versetzungszeichen)-Objekt etwa beachtet
2668 nur erste Zahl für die linke Ausdehnung.
2671 @code{staff-position} (Notensystempositionierung)
2673 @cindex staff-position-Eigenschaft
2675 @code{staff-position} ist eine Eigenschaft des
2676 @code{staff-symbol-referencer-interface}, die von Objekten unterstützt
2677 wird, die relativ zum Notensystem (engl. staff) positioniert werden.
2678 Hiermit wird die vertikale Position eines Objekts relativ zur
2679 Mittellinie des Systems in halben Notenlinienabständen angegeben.
2680 Das ist sehr nützlich, um Zusammenstöße zwischen Layout-Objekten
2681 wie Ganztaktpausen, Bögen und Noten in verschiedenen Stimmen
2685 @code{force-hshift} (vertikale Verschiebung erzwingen)
2687 @cindex force-hshift-Eigenschaft
2689 Eng beeinander stehende Noten in einem Akkord oder Noten, die zum
2690 gleichen Zeitpunkt in unterschiedlichen Stimmen stehen, werden
2691 in zwei oder manchmal auch mehr Kolumnen gesetzt, um Kollisionen
2692 zu umgehen. Diese Kolumnen werden Notenkolumnen genannt;
2693 ein @code{NoteColumn}-Objekt wird erstellt um die Noten in den
2696 Die @code{force-hshift}-(erzwinge horizontale Verschiebung)-Eigenschaft
2697 ist eine Eigenschaft von @code{NoteColumn} (bzw. vom
2698 @code{note-column-interface}). Eine Veränderung dieser Eigenschaft
2699 macht es möglich, eine Notenkolumne zu verschieben, dabei gilt als
2700 Einheit die Breite einer Kolumne, also die Breite des Notenkopfes der
2701 ersten Stimme. Diese Eigenschaft kann in Situationen benutzt werden,
2702 in denen die normalen @code{\shiftOn}-Befehle (siehe auch
2703 @ref{Explicitly instantiating voices}) das Problem nicht beseitigen.
2704 Diese Eigenschaft ist besser in solchen Fällen zu verwenden als die
2705 @code{extra-offset}-Eigenschaft, weil man die richtige Entfernung nicht
2706 in Notenlinienabständen ausrechnen muss. Wenn eine Note in eine
2707 Notenkolumne oder aus ihr heraus geschoben wird, werden auch andere
2708 Funktionen beeinflusst, wie etwa die Verschmelzung von Notenköpfen.
2713 Zu guter Letzt, wenn alles andere nicht funktioniert, können Objekte auch
2714 manuell positioniert werden, entweder vertikal in Bezug auf die
2715 Mittellinie des Systems, oder indem sie einen beliebigen Abstand weit
2716 auf eine neue Position verschoben werden. Der Nachteil ist, dass die
2717 richtigen Werte für eine gute Position manuell ausprobiert werden müssen,
2718 meistens durch Herantasten an den richtigen Wert, und das für jedes
2719 einzelne Objekt extra. Und weil diese Verschiebungen erst vorgenommen
2720 werden, wenn LilyPond alle anderen Objekte gesetzt hat, ist man als
2721 Notensetzer selber dafür verantwortlich, ob es Zusammenstöße gibt.
2722 Am schwerwiegendsten ist aber die Tatsache, dass die
2723 Verschiebungskoordinaten wahrscheinlich neu errechnent oder
2724 ausprobiert werden müssen, wenn sich an den Noten und deren
2725 Layout später irgend etwas ändert. Die Eigenschaften, die für diese
2726 Arte der manuellen Verschiebung verwendet werden können, sind:
2729 @item extra-offset (zusätzlicher Abstand)
2731 @cindex extra-offset-Eigenschaft
2733 Diese Eigenschaft gehört zu jedem Layout-Objekt, das das
2734 @code{grob-interface} unterstützt. Sie braucht ein Zahlenpaar,
2735 das die exakte Verschiebung in horizontaler und vertikaler Richtung
2736 bezeichnet. Negative Zahlen verschieben das Objekt nach links oder
2737 unten. Die Einheit sind Notenlinienabstände. Die zusätzliche
2738 Positionierung wird vorgenommen, nachdem alle anderen Objekte
2739 platziert sind, weshalb ein Objekt irgendwohin verschoben werden
2740 kann, ohne den restlichen Satz zu beeinflussen.
2742 @item positions (Position)
2744 @cindex positions-Eigenschaft
2746 Diese Eigenschaft ist am sinnvollsten, um die Steigung und die
2747 Höhe von Balken, Bögen und Triolenklammern anzupassen.
2748 Sie braucht ein Zahlenpaar, das die Position des rechten und linken
2749 Endes relativ zur Mittellinie des Notensystems bestimmt. Die
2750 Einheit sind Notenlinienabstände. Bögen allerdings können nicht
2751 beliebig weit weg positioniert werden. LilyPond erstellt zunächst eine
2752 Liste an möglichen Positionen für den Bogen und findet normalerweise
2753 die Version, die @qq{am besten aussieht}. Wenn die
2754 @code{positions}-Eigenschaft verändert worden ist, wird der
2755 Bogen aus der Liste gewählt, der der gewünschten Position am
2761 Ein bestimmtes Objekt hat vielleicht nicht alle dieser Eigenschaften.
2762 Darum ist es nötig, in der IR nachzuschlagen, welche Eigenschaften
2763 ein bestimmtes Objekt unterstützt.
2765 Hier ist eine Liste an Objekten, die am wahrscheinlichsten an einer
2766 Kollision beteiligt sind, daneben findet sich die Bezeichnung des
2767 Objektes, mit der Sie es in der IR finden, um zu bestimmen,
2768 welche Eigenschaften benutzt werden können, um es zu verschieben.
2770 @multitable @columnfractions .5 .5
2771 @headitem Objekttyp @tab Objektbezeichnung
2772 @item Articulationszeichen @tab @code{Script}
2773 @item Balken @tab @code{Beam}
2774 @item Dynamikzeichen (vertikal) @tab @code{DynamicLineSpanner}
2775 @item Dynamikzeichen (horizontal) @tab @code{DynamicText}
2776 @item Fingersatz @tab @code{Fingering}
2777 @item Übungs-/Textmarken @tab @code{RehearsalMark}
2778 @item Legatobögen @tab @code{Slur}
2779 @item Text z. B. @code{^"text"} @tab @code{TextScript}
2780 @item Bindebögen @tab @code{Tie}
2781 @item N-tolen @tab @code{TupletBracket}
2785 @node Fixing overlapping notation
2786 @subsection Fixing overlapping notation
2788 Hier soll nun gezeigt werden, wie die Eigenschaften, die im
2789 vorigen Abschnitt vorgestellt wurden, bei der Problemlösung
2790 mit sich überschneidenden Notationselementen eingesetzt
2793 @subheading padding property
2795 @cindex padding (Verschiebungs-Eigenschaft)
2796 @cindex Überschneidende Notation korrigieren
2797 @cindex Korrigieren von überschneidender Notation
2799 Die @code{padding}-(Verschiebungs-)Eigenschaft kann benutzt
2800 werden, um den Abstand zwischen Symbolen zu vergößern (oder
2801 zu verkleinern), die über oder unter den Noten gesetzt werden.
2803 @cindex Script, Beispiel zur Veränderung
2804 @cindex Verschiebungs-Eigenschaft, Beispiel
2805 @cindex padding (Verschiebuns-Eigenschaft), Beispiel
2807 @lilypond[quote,fragment,relative=1,verbatim]
2809 \override Script #'padding = #3
2813 @cindex MetronomMark, Beispiel zur Veränderung
2814 @cindex Verschiebungs-Eigenschaft, Beispiel
2815 @cindex padding (Verschiebuns-Eigenschaft), Beispiel
2817 @lilypond[quote,fragment,relative=1,verbatim]
2818 % This will not work, see below:
2819 \override MetronomeMark #'padding = #3
2823 \override Score.MetronomeMark #'padding = #3
2828 Im zweiten Beispiel können Sie sehen, wie wichtig es ist den richtigen
2829 Kontext anzugeben. Weil das @code{MetronomeMark}-Objekt
2830 sich im @code{Score}-Kontext befindet, werden Eigenschaftsänderungen
2831 im @code{Voice}-Kontext einfach ignoriert. Für mehr Einzelheiten siehe
2832 @ruser{Modifying properties}.
2834 Wenn die @code{padding}-Eigenschaft eines Objektes erhöht wird, das
2835 sich in einem Stapel von Objekten befindet, die nach ihrer
2836 Außersystempriorität (@code{outside-staff-priority}) positioniert werden,
2837 werden das Objekt und alle, die sich außerhalb davon befinden,
2838 entsprechend verschoben.
2840 @subheading left-padding and right-padding
2842 @cindex left-padding-Eigenschaft (Verschiebung nach links)
2843 @cindex Verschiebung nach rechts oder links
2844 @cindex right-padding-Eigenschaft (Verschiebung nach rechts)
2846 Die @code{right-padding}-Eigenschaft wirkt sich auf den Abstand
2847 zwischen einem Versetzungszeichen und der Note, auf das sie sich
2848 bezieht, aus. Sie wird nicht sehr oft benötigt, aber das folgende
2849 Beispiel zeigt eine Situation, wo man sie braucht. Das Beispiel
2850 stellt eine Situation dar, in der in einem Akkord sowohl H als auch
2851 B vorkommen sollen. Damit keine Ambiguität ensteht, sollen beide
2852 Noten ein Zeichen haben, also ein B und ein Auflösungszeichen.
2853 Hier einige Notationsversuche:
2855 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2862 Keiner davon funktioniert, und der zweite und dritte weist
2863 hässliche Zusammenstöße zwischen den Zeichen auf.
2865 Eine Möglichkeit, das Gewünschte zu erhalten, ist es den
2866 Stencil des Versetzungszeichens zu ersetzen mit einer
2867 Textbeschriftung (Markup), die sowohl das B als auch das
2868 Aulösungszeichen enthält:
2870 @cindex Versetzungszeichen, Beispiel zur Veränderung
2871 @cindex Accidental, Beispiel zur Veränderung
2872 @cindex Text-Eigenschaft, Beispiel
2873 @cindex stencil-Eigenschaft, Beispiel
2874 @cindex AccidentalPlacement, Beispiel zur Veränderung
2875 @cindex right-padding-Eigenschaft, Beispiel
2876 @cindex Verschiebung nach rechts (rigth-padding), Beispiel
2878 @lilypond[quote,ragged-right,verbatim]
2879 naturalplusflat = \markup { \natural \flat }
2881 \once \override Accidental
2882 #'stencil = #ly:text-interface::print
2883 \once \override Accidental #'text = #naturalplusflat
2884 \once \override Score.AccidentalPlacement #'right-padding = #1.5
2890 Dazu ist aber ein @code{\override}-Befehl für den Stencil des
2891 Versetzungszeichens nötig, der bisher nicht behandelt wurde.
2892 Der Typ des Stencils muss eine Prozedur sein, die hier geändert
2893 wurde, um den Inhalt der @code{text}-Eigenschaft des
2894 @code{Accidental} (Versetzungszeichen)-Objekts zu setzen,
2895 die dann so definiert wird, dass sie ein Auflösungszeichen gefolgt
2896 von einem B enthält. Diese werden dann mit @code{right-padding}
2897 weiter nach rechts verschoben.
2900 @subheading staff-padding property
2902 @cindex staff-padding-Eigenschaft
2903 @cindex Objekte an der Grundlinie ausrichten
2904 @cindex Ausrichten von Objekten an der Grundlinie
2906 @code{staff-padding} (Verschiebung zum Notensystem) kann
2907 verwendet werden um Objekte wie Dynamikzeichen an einer
2908 Grundlinie auf einer bestimmten Höhe über dem System
2909 auszurichten, sodass sie nicht von der Position der Note abhängen,
2910 an die sie angehängt sind. Diese Verschiebung ist keine Eigenschaft
2911 von @code{DynamicText}, sondern von @code{DynamicLineSpanner}.
2912 Das liegt daran, dass die Grundlinie sich gleicherweise auf
2913 @strong{alle} Dynamikzeichen beziehen soll, also auch auf die,
2914 die als Strecker erstellt wurden. Hier also die Lösung, die Dynamikzeichen
2915 aus dem Beispiel des vorigen Abschnitts auszurichten:
2917 @cindex DynamikText, Beispiel zur Veränderung
2918 @cindex extra-spacing-width-Eigenschaft, Beispiel
2919 @cindex DynamicLineSpanner, Beispiel zur Veränderung
2920 @cindex staff-padding-Eigenschaft, Beispiel
2922 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
2924 % Extend width by 1 unit
2925 \override DynamicText #'extra-spacing-width = #'(-0.5 . 0.5)
2926 % Align dynamics to a base line 2 units above staff
2927 \override DynamicLineSpanner #'staff-padding = #2
2932 @subheading self-alignment-X property
2934 @cindex self-alignment-X-Eigenschaft
2936 Das nächste Beispiel zeigt, wie man den Zusammenstoß
2937 einer Fingersatzbezeichnung mit einem Notenhals
2938 verhindern kann, indem die rechte Ecke an dem
2939 Referenzpunkt der abhängigen Note angeordnet wird:
2941 @cindex StringNumber, Beispiel zur Veränderung
2943 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
2946 \once \override StringNumber #'self-alignment-X = #RIGHT
2951 @subheading staff-position property
2953 @cindex staff-position-Eigenschaft
2954 @cindex Notensystem-Position-Eigenschaft
2955 @cindex Kollision von Objekten im System
2956 @cindex Zusammenstöße von Objekten im System
2958 Vieltaktpausen in einer Stimmen können mit Noten in anderen
2959 Stimmen kollidieren. Da diese Pausen zentriert zwischen den
2960 Taktlinien gesetzt werden, würde es für LilyPond eine recht große
2961 Anstrengung bedeuten herauszufinden, welche Noten mit ihnen
2962 zusammenstoßen könnten, denn alle Kollisionsvermeidung
2963 für Noten und Pausen funktioniert nur für Noten bzw. Pausen, die
2964 zur selben Zeit auftreten. Hier ein typisches Beispiel für eine
2965 Kollision dieser Art:
2967 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
2968 << {c c c c} \\ {R1} >>
2971 Die beste Lösung ist es, die Ganztaktpause nach unten zu
2972 schieben, denn die Pause ist in der zweiten Stimme. Per
2973 Standardeinstellung für die zweite Stimme (@code{\voiceTwo},
2974 also die zweite Stimme in der
2975 @code{<<@{...@} \\ @{...@}>>}-Konstruktion) wird die
2976 Position auf dem System (@code{staff-position}) auf -4
2977 für @code{MultiMeasureRest}, in unserem Beispiel muss
2978 es also bspw. auf die Position @code{-8} gesetzt werden,
2979 d.h. vier halbe Notenlinienabstände weiter nach unten:
2981 @cindex MultiMeasureRest, Beispiel zur Veränderung
2982 @cindex Ganztaktpausen, Beispiel zur Veränderung
2983 @cindex staff-position-Eigenschaft, Beispiel
2985 @lilypond[quote,verbatim,fragment,ragged-right, relative=1]
2989 \override MultiMeasureRest #'staff-position = #-8
2994 Das ist besser, als etwa @code{extra-offset} zu benutzen, denn
2995 in unserem Fall wird die Hilfslinie der Pause automatisch gesetzt.
2998 @subheading extra-offset property
3000 @cindex extra-offset-Eigenschaft
3001 @cindex Zusätzlicher Abstand, Positionierung
3002 @cindex Positionierung von Objekten
3003 @cindex Objekte, Positionierung
3005 Die @code{extra-offset}-Eigenschaft bietet vollständige Kontrolle
3006 über die Positionierung von Objekten in horizontaler und vertikaler
3009 Im Beispiel unten ist das zweite Fingersatzzeichen (@code{Fingering}) etwas nach
3010 links und 1,8 Notenlinienabstände nach unten verschoben:
3012 @cindex Fingersatz, Beispiel zur Veränderung
3013 @cindex extra-offset-Eigenschaft, Beispiel
3015 @lilypond[quote,fragment,relative=1,verbatim]
3018 \once \override Fingering
3019 #'extra-offset = #'(-0.3 . -1.8)
3024 @subheading positions property
3026 @cindex positions-Eigenschaft
3027 @cindex Kontrolle über Triolen, Bögen und Balken manuell
3028 @cindex manuelle Kontrolle über Triolen, Bögen, Balken
3029 @cindex Balken, manuelle Kontrolle
3030 @cindex Bögen, manuelle Kontrolle
3031 @cindex Legatobögen, manuelle Kontrolle
3032 @cindex Phrasierungsbögen, manuelle Kontrolle
3033 @cindex Triollen-Klammer, manuelle Kontrolle
3035 Die @code{positions}-Eigenschaft erlaubt die Kontrolle von Position und
3036 Steigung von Balken, Legato- und Phrasierungsbögen sowie Triolenklammern.
3037 Hier ein Beispiel, in der ein unschöner Phrasierungsbogen auftritt, weil
3038 er den Bogen des Vorschlags vermeidet:
3040 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
3041 r4 \acciaccatura e8\( d8 c ~c d c d\)
3045 Man könnte einfach den Phrasierungsbogen oberhalb der Noten setzen, und
3046 das wäre auch die beste Lösung:
3048 @cindex Phrasierungsbogen, Beispiel zur Veränderung
3049 @cindex positions-Eigenschaft, Beispiel
3050 @cindex Positionierung, Beispiel
3052 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
3055 \acciaccatura e8\( d8 c ~c d c d\)
3059 aber wenn es einen Grund geben sollte, warum das nicht geht, könnte
3060 man das linke Ende des Phrasierungsbogens etwas nach unten verschieben,
3061 indem man die @code{positions}-Eigenschaft einsetzt. Damit
3062 verschwindet auch die etwas unschöne Form:
3064 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
3066 \once \override PhrasingSlur #'positions = #'(-4 . -3)
3068 e8\( d8 c ~c d c d\)
3071 Hier noch ein weiteres Beispiel aus der Einleitung von Chopins
3072 Prelude Op. 28 Nr. 2, das untere System. Wie zu sehen ist,
3073 stößt der Balken mit den oberen Noten zusammen:
3075 @lilypond[quote,verbatim,fragment,ragged-right]
3078 << {b,8 ais, b, g,} \\ {e, g e, g} >>
3079 << {b,8 ais, b, g,} \\ {e, g e, g} >>
3084 Das kann manuell gelöst werden, indem beide Enden des Balkens
3085 von ihrer Position 2 Notenlinienabstände über der Mittellinie
3086 hochgeschoben werden, etwa auf 3:
3088 @cindex Balken, Beispiel zur Veränderung
3089 @cindex positions-Eigenschaft, Beispiel
3090 @cindex Positionierung, Beispiel
3092 @lilypond[quote,verbatim,fragment,ragged-right]
3096 \override Beam #'positions = #'(3 . 3)
3101 << {b,8 ais, b, g,} \\ {e, g e, g} >>
3106 Hier ist zu beobachten, dass die Veränderung sich auch auf die
3107 weiteren Achtelbalken der ersten Stimme auwirkt, während sie keine
3108 Auswirkung auf die Balken der zweiten Stimme hat.
3110 @subheading force-hshift property
3112 @cindex force-hshift-Eigenschaft
3113 @cindex Vertikale Verschiebung erzwingen
3115 @c FIXME: formatting stuff (ie not important right now IMO)
3116 @c @a nchor Chopin finally corrected TODOgp
3118 An diesem Punkt können wir den letzten Feinschliff an unserem
3119 Chopin-Beispiel vornhemen, das wir behandelt haben in
3120 @ref{I'm hearing Voices}. Wir hatten es in folgende Form
3123 @lilypond[quote,verbatim,fragment,ragged-right]
3124 \new Staff \relative c'' {
3127 { c2 aes4. bes8 } \\
3139 Die unteren zwei Noten des ersten Akkords (also diein der
3140 dritten Stimme) sollten nicht aus der Notenkolumne der
3141 oberen zwei Noten weggeschoben werden. Um das zu
3142 korrigieren, setzen wir @code{force-hshift}, das eine
3144 @code{NoteColumn} ist, für diese Noten auf Null.
3145 Die untere Note des zweiten Akkordes wird am besten
3146 direkt rechts von den oberen Noten gesetzt. Das erreichen
3147 wir, indem wir @code{force-hshift} für diese Note auf
3148 0.5 setzen, also eine halbe Notenkopfbreite nach rechts von
3149 der Kolumne der oberen Noten aus.
3151 Hier das Endergebnis:
3153 @cindex Notenkolumne, Beispiel zur Veränderung
3154 @cindex force-hshift-Eigenschaft, Beispiel
3155 @cindex vertikale Verschiebung, Beispiel
3157 @lilypond[quote,verbatim,fragment,ragged-right]
3158 \new Staff \relative c'' {
3161 { c2 aes4. bes8 } \\
3164 \once \override NoteColumn #'force-hshift = #0 <ees c>2
3165 \once \override NoteColumn #'force-hshift = #0.5 des2
3173 @node Real music example
3174 @subsection Real music example
3176 Das Kapitel zu Optimierungen soll mit einem komplizierten Beispiel
3177 beendet werden, in dem verschiedene Optimierungen vorgenommen
3178 werden müssen, bis das Ergebnis gut ausssieht. Das Beispiel wurde
3179 ganz bewusst gewählt um die Benutzung der Notationsreferenz
3180 zu zeigen, wenn ungewöhnliche Notationsprobleme gelöst werden
3181 müssen. Es ist nicht repräsentativ für normale Notationsprojekte,
3182 lassen Sie sich also nicht durch dieses Beispiel entmutigen! Zum
3183 Glück sind Probleme wie die hier gezeigten nicht sehr häufig.
3185 Das Beispiel stammt aus Chopins Premiére Ballade, Op. 23, Takte
3186 6--9, der Übergang vom Lento der Einleitung zum Moderato.
3187 Hier zunächst der Satz, wie er aussehen soll, allerdings ohne
3188 Dynamik, Fingersatz und Pedalbezeichnung, um das Beispiel nicht
3189 zu kompliziert zu machen.
3191 @c This example should not be indexed
3192 @lilypond[quote,ragged-right]
3193 rhMusic = \relative c'' {
3196 \once \override Tie #'staff-position = #3.5
3200 \mergeDifferentlyHeadedOn
3201 \mergeDifferentlyDottedOn
3202 bes2.^\markup {\bold "Moderato"} r8
3204 {c,8[ d fis bes a] | }
3206 % Reposition the c2 to the right of the merged note
3207 {c,8~ \once \override NoteColumn #'force-hshift = #1.0
3208 % Move the c2 out of the main note column so the merge will work
3211 % Stem on the d2 must be down to permit merging
3212 {s8 \stemDown \once \override Stem #'transparent = ##t d2}
3216 \mergeDifferentlyHeadedOff
3217 \mergeDifferentlyDottedOff
3221 lhMusic = \relative c' {
3223 <d g, d>1)\arpeggio |
3230 \new Staff = "RH" <<
3234 \new Staff = "LH" <<
3243 Die erste Überlegung ist, dass das System für die rechte Hand
3244 im dritten Takt vier Stimmen braucht. Das sind die fünf
3245 Achtelnoten mit Balken, das übergebundene C, die Halbe D, die
3246 mit der Achtel D verschmolzen ist, und die punktierte Viertel
3247 Fis, die auch mit einer Achtelnote verschmolzen ist. Alles
3248 andere ist eine einzige Stimme, es ist also am einfachsten, die
3249 Stimmen nur zeitweise zu erstellen, wenn sie auftreten. Wenn
3250 Sie vergessen haben, wie man das anstellt, schauen Sie sich
3251 nochmal den Abschnitt @ref{I'm hearing Voices} an. Wir
3252 wollen anfange, indem wir die Noten in zwei Variablen
3253 notieren und dann die Systemstruktur in einer
3254 @code{\score}-Umgebung erstellen. Das ist, was LilyPond
3257 @lilypond[quote,verbatim,ragged-right]
3258 rhMusic = \relative c'' {
3263 % Start polyphonic section of four voices
3265 {c,8 d fis bes a | }
3276 lhMusic = \relative c' {
3285 \new Staff = "RH" <<
3289 \new Staff = "LH" <<
3298 Alle Noten sind richtig, aber die Positionierung sehr
3299 verbesserungsbedürftig. Der Bindebogen stößt mit
3300 der veränderten Taktart zusammen, die Balkung im
3301 dritten Takt ist falsch, die Noten werden nicht
3302 verschmolzen und einige Notationselemente fehlen ganz.
3303 Behandeln wir zunächst die einfacheren Dinge. Der
3304 Balken kann durch eine manuelle Begrenzung einfach
3305 korrigiert werden, und auch der Legatobogen der linken
3306 Hand und der Phrasierungsbogen der rechten Hand
3307 sind schnell gesetzt, denn sie wurden schon in der
3308 Übung erklärt. Damit haben wir folgendes Notenbild:
3310 @lilypond[quote,verbatim,ragged-right]
3311 rhMusic = \relative c'' {
3316 % Start polyphonic section of four voices
3318 {c,8[ d fis bes a] | }
3329 lhMusic = \relative c' {
3338 \new Staff = "RH" <<
3342 \new Staff = "LH" <<
3351 Der erste Takt stimmt jetzt schon. Der zweite Takt enthält ein
3352 Arpeggio und wird mit einer doppelten Taktlinie beschlossen.
3353 Wie können wir diese notieren, denn sie sind im Handbuch zum
3354 Lernen nicht vorgekommen? Hier brauchen wir jetzt die
3355 Notationsreferenz. Ein Blick in den Index zeigt uns die
3356 Einträge für @qq{Arpeggio} und @qq{Taktlinien}: ein
3357 Arpeggio also erstellt man mit dem Befehl @code{\arpeggio}
3358 hinter einem Akkord und eine doppelte Taktlinie wird mit dem
3359 Befehl @code{\bar "||"} erstellt. Das ist einfach. Als nächstes
3360 muss der Zusammenstoß des Bindebogens mit der Taktartbezeichnung
3361 gelöst werden. Das geht am besten, indem wir den Bogen nach
3362 oben verschieben. Wie man Objekte verschiebt wurde schon
3363 behandelt in @ref{Moving objects}, wo stand, dass Objekte
3365 relativ zum System positioniert werden, verschoben werden
3366 können, indem ihre @code{staff-position}-Eigenschaft
3367 geändert wird, die in halben Notenlienienabständen relativ
3368 zur Mittellinie angegeben wird. Dieser @code{\override}-Befehl
3369 also, direkt vor die erste übergebundene Note gestellt, verschiebt
3370 den Bindebogen (@code{tie}) 3,5 halbe Notenlinienabstände
3371 über die Mittellinie:
3373 @code{\once \override Tie #'staff-position = #3.5}
3375 Damit ist auch der zweite Takt vollständig:
3377 @lilypond[quote,verbatim,ragged-right]
3378 rhMusic = \relative c'' {
3380 \once \override Tie #'staff-position = #3.5
3385 % Start polyphonic section of four voices
3387 {c,8[ d fis bes a] | }
3398 lhMusic = \relative c' {
3400 <d g, d>1)\arpeggio |
3407 \new Staff = "RH" <<
3411 \new Staff = "LH" <<
3420 In Takt drei beginnt der Moderato-Abschnitt. In der
3421 Übung wurde behandelt, wie man fetten Text mit dem
3422 @code{\markup}-Befehl eingibt, es ist also einfach, das
3423 @qq{Moderato} hinzuzufügen. Wie aber werden Noten
3424 verschmolzen? Hier nehmen wir wieder die Notationsreferenz
3425 zu Hilfe. Die Suche nach @qq{Verschmelzen} (engl. merge)
3426 im Index führt uns zu den Befehlen um Noten mit
3427 unterschiedlichen Köpfen und unterschiedlichen Punkten
3428 zu verschmelzen in @ruser{Collision resolution}. In unserem
3429 Beispiel müssen sowohl unterschiedliche Köpfe also auch
3430 unterschiedliche Punktierung verschmolzen werden, wir
3431 brauchen also die Befehle
3434 \mergeDifferentlyHeadedOn
3435 \mergeDifferentlyDottedOn
3439 aus der Notationsreferenz, die wir an den Beginn unseres
3440 Abschnittes stellen und
3443 \mergeDifferentlyHeadedOff
3444 \mergeDifferentlyDottedOff
3448 um das Verhalten wieder auszuschalten. Das sieht so aus:
3450 @cindex Bindebogen, Beispiel zur Veränderung
3451 @cindex staff-position-Eigenschaft, Beispiel
3453 @lilypond[quote,verbatim,ragged-right]
3454 rhMusic = \relative c'' {
3456 \once \override Tie #'staff-position = #3.5
3460 bes2.^\markup {\bold "Moderato"} r8
3461 \mergeDifferentlyHeadedOn
3462 \mergeDifferentlyDottedOn
3463 % Start polyphonic section of four voices
3465 {c,8[ d fis bes a] | }
3473 \mergeDifferentlyHeadedOff
3474 \mergeDifferentlyDottedOff
3478 lhMusic = \relative c' {
3480 <d g, d>1)\arpeggio |
3487 \new Staff = "RH" <<
3491 \new Staff = "LH" <<
3500 Mit diesen Veränderungen wurden die beiden Fis-Noten
3501 verschmolzen, aber nicht die zwei Ds. Warum nicht? Die
3502 Antwort befindet sich im gleicher Abschnitt der Notationsreferenz:
3503 Noten, die verschmolzen werden, müssen Hälse in entgegengesetzte
3504 Richtungen aufweisen und zwei Noten können nicht verschmolzen
3505 werden, wenn eine dritte Noten in der gleichen Kolumne
3506 stört. In unserem Fall weisen beide Hälse nach oben und es
3507 befindet sich zur gleichen Zeit auch noch eine dritte Note, das C.
3508 Wie die Richtung von Hälsen geändert wird, wissen wir schon:
3509 mit @code{\stemDown}, und in der Notationsreferenz findet
3510 sich auch Information, wie das C verschoben werden kann: mit
3511 dem @code{\shift}-Befehl. Aber welcher von ihnen? Das C
3512 befindet sich in der zweiten Stimme, die @qq{shift off} hat,
3513 die zwei Ds sind in den Stimmen eins und drei, die @qq{shift
3514 off} bzw. @qq{shift on} haben. Das C muss also noch eine
3515 Stufe weiter verschoben werden mit @code{\shiftOnn}, damit
3516 es die Verschmelzung der Ds nicht stört. Das sieht jetzt so
3519 @lilypond[quote,verbatim,ragged-right]
3520 rhMusic = \relative c'' {
3522 \once \override Tie #'staff-position = #3.5
3526 bes2.^\markup {\bold "Moderato"} r8
3527 \mergeDifferentlyHeadedOn
3528 \mergeDifferentlyDottedOn
3529 % Start polyphonic section of four voices
3531 {c,8[ d fis bes a] | }
3533 % Move the c2 out of the main note column so the merge will work
3534 {c,8~ \shiftOnn c2 | }
3536 % Stem on the d2 must be down to permit merging
3537 {s8 \stemDown d2 | }
3541 \mergeDifferentlyHeadedOff
3542 \mergeDifferentlyDottedOff
3546 lhMusic = \relative c' {
3548 <d g, d>1)\arpeggio |
3555 \new Staff = "RH" <<
3559 \new Staff = "LH" <<
3568 Fast schon geschafft. Nur noch ein Problem ist übrig: Der Hals nach
3569 unten des verschmolzenen sollte nicht da sein, und das C sähe
3570 besser auf der rechten Seite des Ds aus. Beides können wir mit den
3571 gelernten Optimierungsmethoden erreichen. Den Hals machen
3572 wir durchsichtig und das C verschieben wir mit der
3573 @code{force-hshift}-Eigenschaft. Hier ist das Endergebnis:
3575 @cindex Notenkolumne, Beispiel zur Veränderung
3576 @cindex force-hshift-Eigenschaft, Beispiel
3577 @cindex Hals, Beispiel zur Veränderung
3578 @cindex Notenhals, Beispiel zur Veränderung
3579 @cindex transparent-Eigenschaft, Beispiel
3581 @lilypond[quote,verbatim,ragged-right]
3582 rhMusic = \relative c'' {
3585 \once \override Tie #'staff-position = #3.5
3589 bes2.^\markup {\bold "Moderato"} r8
3590 \mergeDifferentlyHeadedOn
3591 \mergeDifferentlyDottedOn
3593 {c,8[ d fis bes a] | }
3595 % Reposition the c2 to the right of the merged note
3596 {c,8~ \once \override NoteColumn #'force-hshift = #1.0
3597 % Move the c2 out of the main note column so the merge will work
3600 % Stem on the d2 must be down to permit merging
3601 {s8 \stemDown \once \override Stem #'transparent = ##t d2}
3605 \mergeDifferentlyHeadedOff
3606 \mergeDifferentlyDottedOff
3610 lhMusic = \relative c' {
3612 <d g, d>1)\arpeggio |
3619 \new Staff = "RH" <<
3623 \new Staff = "LH" <<
3633 @node Further tweaking
3634 @section Further tweaking
3637 * Other uses for tweaks::
3638 * Using variables for tweaks::
3639 * Other sources of information::
3640 * Avoiding tweaks with slower processing::
3641 * Advanced tweaks with Scheme::
3644 @node Other uses for tweaks
3645 @subsection Other uses for tweaks
3647 @cindex Transparente Objekte
3648 @cindex Entfernen von Objekten
3649 @cindex Verstecken von Objekten
3650 @cindex Unsichtbare Objekte
3651 @cindex transparent-Eigenschaft, Benutzung
3652 @cindex Objekte unsichtbar machen
3653 @cindex Objekte entfernen
3654 @cindex Objekte verstecken
3655 @cindex Noten zwischen Stimmen überbinden
3656 @cindex Überbinden von Noten zwischen Stimmen
3658 @subheading Tying notes across voices
3660 Das nächste Beispiel zeigt, wie man Noten von verschiedenen
3661 Stimmen miteinander verknüpfen kann, indem man Bindebögen
3662 für Überbindungen benutzt. Normalerweise können nur zwei
3663 Noten der gleichen Stimme übergebunden werden. Wenn
3664 man zwei Stimmen benutzt, wobei die überbundenen Noten
3665 sich in der selben befinden,
3667 @lilypond[quote,fragment,relative=2]
3668 << { b8~ b8\noBeam }
3674 und dann den ersten Hals nach oben unsichtbar macht,
3675 sieht es so aus, als ob die Überbindung zwischen
3676 den Stimmen stattfindet:
3678 @cindex Hals, Beispiel zur Veränderung
3679 @cindex Notenhals, Beispiel zur Veränderung
3680 @cindex transparent-Eigenschaft, Beispiel
3682 @lilypond[quote,fragment,relative=2,verbatim]
3685 \once \override Stem #'transparent = ##t
3693 Um sicherzugehen, dass der unsichtbare Hals den Bindebogen
3694 nicht zu sehr verkleinert, kann er verlängert werden, indem
3695 seine Länge (@code{length}) auf den Wert @code{8}
3698 @lilypond[quote,fragment,relative=2,verbatim]
3701 \once \override Stem #'transparent = ##t
3702 \once \override Stem #'length = #8
3711 @subheading Simulating a fermata in MIDI
3713 @cindex stencil-Eigenschaft, Benutzung
3714 @cindex Fermate, Benutzung in MIDI
3715 @cindex MIDI: Fermate erstellen
3717 Für Objekte außerhalb des Notensystems ist es normalerweise
3718 besser, die @code{stencil}-Eigenschaft anstelle der
3719 @code{transparent}-Eigenschaft zu verändern, wenn man
3720 sie vom fertigen Notensatz entfernen will. Indem die
3721 @code{stencil}-Eigenschaft auf falsch (@code{#f}) gesetzt
3722 wird, wird das entsprechende Objekt vollständig entfernt.
3723 Das bedeutet, dass es die Positionierung der anderen Objekte
3726 Auf diese Art kann etwa das Tempo geändert werden, damit
3727 in der MIDI-Ausgabe eine Fermate zu hören ist, ohne dass
3728 im Notensatz etwas von diesen Tempoänderungen zu sehen
3729 ist. Die Metronombezeichnung soll auch nicht die Position
3730 von Text an der gleichen Stelle oder die Abstände zwischen
3731 zwei Systemen beeinflussen. Darum ist es am besten,
3732 @code{stencil} auf @code{#f} zu setzen. Im Beispiel wird
3733 der Unterschied zwischen einem unsichtbaren Objekt und
3734 einem entfernten Objekt gezeigt:
3736 @cindex Metronom-Bezeichnung, Beispiel zur Veränderung
3737 @cindex transparent-Eigenschaft, Beispiel
3739 @lilypond[quote,verbatim,ragged-right]
3742 % Visible tempo marking
3745 \once \override Score.MetronomeMark #'transparent = ##t
3746 % Invisible tempo marking to lengthen fermata in MIDI
3749 % New tempo for next section
3758 @lilypond[quote,verbatim,ragged-right]
3761 % Visible tempo marking
3764 \once \override Score.MetronomeMark #'stencil = ##f
3765 % Invisible tempo marking to lengthen fermata in MIDI
3768 % New tempo for next section
3778 Mit beiden Methoden wird die Tempobezeichnung entfernt, mit
3779 der die Fermate verlängert wird, und beide beeinflussen die
3780 MIDI-Ausgabe wie gewünscht. Die unsichtbare Metronombezeichnung
3781 schiebt aber die folgende Bezeichnung in die Höhe, während
3782 das im zweiten Beispiel, in dem der @code{stencil} entfernt
3783 wurde, nicht passiert.
3786 @node Using variables for tweaks
3787 @subsection Using variables for tweaks
3789 @cindex Variablen, Benutzung zur Optimierung
3790 @cindex Optimierung mit Variablen
3792 @code{\override}-Befehle sind oft lang und mühsam zu
3793 tippen, und sie müssen immer absolut richtig sein. Wenn
3794 derselbe Befehl mehrere Male benutzt werden muss, lohnt
3795 es sich oft schon, eine Variable zu definieren, in der er
3798 Als Beispiel sollen einige Worte im
3799 Gesangstext fett und kursiv hervorgehoben werden.
3800 Die Befehle @code{\italic} und @code{\bold} funktionieren
3801 im Gesangstext-Kontext nur, wenn sie gleichzeitig mit den Wörtern,
3802 auf die sie angewendet werden sollen, zusätzlich
3803 in eine @code{\markup}-Umgebung eingeschlossen
3804 werden. Durch diese Einbettung können einzelne Wörter nicht
3805 einfach zu einer Variable umgeformt werden. Als
3806 Alternative versuchen wir, einen Befehl mit
3807 @code{\override} und @code{\revert} zu konstruieren.
3810 @code{\override Lyrics . LyricText #'font-shape = #'italic}
3811 @code{\override Lyrics . LyricText #'font-series = #'bold}
3813 @code{\revert Lyrics . LyricText #'font-shape}
3814 @code{\revert Lyrics . LyricText #'font-series}
3817 Das wäre natürlich noch viel mühsamer, wenn viele Wörter eine
3818 Hervorhebung benötigen. Anstelle dieser Befehlsketten @emph{können}
3819 wir jedoch zwei Variablen definieren. Mit ihnen und dem entsprechenden
3820 Wort in geschweiften Klammern erreichen wir den gewünschten Effekt.
3821 Ein weiterer Vorteil ist, dass in diesem Fall die Leerzeichn um die
3822 Punkte herum nicht benötigt werden, weil sie nicht innerhalb des
3823 @code{lyricmode}-Kontextes interpretiert werden. Hier ein Beispiel;
3824 die Bezeichnungen können natürlich auch kürzer sein,
3825 um noch weniger schreiben zu müssen:
3827 @cindex LyricText, Beispiel zur Veränderung
3828 @cindex Gesangstext, Beispiel zur Veränderung
3829 @cindex font-shape-Eigenschaft, Beispiel
3830 @cindex font-series-Eigenschaft, Beispiel
3832 @lilypond[quote,verbatim]
3834 \override Lyrics.LyricText #'font-shape = #'italic
3835 \override Lyrics.LyricText #'font-series = #'bold
3838 \revert Lyrics.LyricText #'font-shape
3839 \revert Lyrics.LyricText #'font-series
3842 global = { \time 4/4 \partial 4 \key c \major}
3843 SopranoMusic = \relative c' { c4 | e4. e8 g4 g | a a g }
3844 AltoMusic = \relative c' { c4 | c4. c8 e4 e | f f e }
3845 TenorMusic = \relative c { e4 | g4. g8 c4. b8 | a8 b c d e4 }
3846 BassMusic = \relative c { c4 | c4. c8 c4 c | f8 g a b c4 }
3847 VerseOne = \lyrics { E -- | ter -- nal \emphasize Fa -- ther, \normal | strong to save, }
3848 VerseTwo = \lyricmode { O | \emphasize Christ, \normal whose voice the | wa -- ters heard, }
3849 VerseThree = \lyricmode { O | \emphasize Ho -- ly Spi -- rit, \normal | who didst brood }
3850 VerseFour = \lyricmode { O | \emphasize Tri -- ni -- ty \normal of | love and pow'r }
3856 \new Voice = "Soprano" { \voiceOne \global \SopranoMusic }
3857 \new Voice = "Alto" { \voiceTwo \AltoMusic }
3858 \new Lyrics \lyricsto "Soprano" { \VerseOne }
3859 \new Lyrics \lyricsto "Soprano" { \VerseTwo }
3860 \new Lyrics \lyricsto "Soprano" { \VerseThree }
3861 \new Lyrics \lyricsto "Soprano" { \VerseFour }
3865 \new Voice = "Tenor" { \voiceOne \TenorMusic }
3866 \new Voice = "Bass" { \voiceTwo \BassMusic }
3873 @node Other sources of information
3874 @subsection Other sources of information
3876 Die Programmreferenz enthält sehr viel Information über LilyPond, aber
3877 noch mehr Information findet sich in den internen
3878 LilyPond-Dateien. Um sie erforschen zu können, müssen Sie erst
3879 das richtige Verzeichnis auf Ihrem System finden. Die Position
3880 hängt a) davon ab, ob Ihre LilyPond-Installation mit der vorkompilierten
3881 Version von der LilyPond-Internetseite vorgenommen wurde oder Sie
3882 die Version durch Ihren Paketmanager installiert haben (also
3883 z. B. in einer Linux-Distribution oder unter fink oder cygwin
3884 installiert), und b) auf welchem Betriebssystem Sie das Programm
3887 @strong{Von lilypond.org heruntergeladen}
3892 Wechseln Sie in das Verzeichnis
3893 @file{@var{INSTALL_VERZ}/lilypond/usr/share/lilypond/current/}
3897 Wechseln Sie in das Verzeichnis
3898 @file{@var{INSTALL_VERZ}/LilyPond.app/Contents/Resources/share/lilypond/current/}
3899 indem Sie entweder mit dem Befehl @code{cd} vom Terminal aus
3900 in das Verzeichnis wechseln, oder mit Control-Klick auf das
3901 LilyPond-Programmsymbol gehen und @qq{Show Package Contents}
3906 Wechseln Sie mit dem Windows Explorer ins Verzeichnis
3907 @file{@var{INSTALL_VERZ}/LilyPond/usr/share/lilypond/current/}
3911 @strong{Mit einem Paket-Manager installiert oder selber aus
3912 den Quellen kompiliert}
3914 Wechseln Sie in das Verzeichnis
3915 @file{@var{PREFIX}/share/lilypond/@var{X.Y.Z}/}, wobei
3916 @var{PREFIX} bei Ihrem Paket-Manager oder dem
3917 @code{configure}-Skript gesetzt wird, und @var{X.Y.Z}
3918 die LilyPond-Versionsnummer.
3922 In diesem Ordner sind die zwei interessanten Unterordner:
3925 @item @file{ly/} - beinhaltet Dateien im LilyPond-Format
3926 @item @file{scm/} - beinhaltet Dateien im Scheme-Format
3929 Schauen wir uns zuerst einige Dateien in @file{ly/} an.
3930 Öffnen Sie @file{ly/property-init.ly} in einem Texteditor.
3931 Der, den Sie normalerweise für @code{.ly}-Dateien benutzen,
3932 genügt. Diese Datei enthält die Definitionen aller vordefinierten
3933 Befehle für LilyPond, wie etwa @code{\stemUp} und
3934 @code{\slurDotted}. Sie können sehen, dass es sich um
3935 nichts mehr handelt als Definitionen von Variablen, die eine
3936 oder mehrere @code{\override}-Befehle enthalten. Der
3937 Befehl @code{/tieDotted} etwa wird folgendermaßen definiert:
3941 \override Tie #'dash-period = #0.75
3942 \override Tie #'dash-fraction = #0.1
3946 Wenn Sie diese Voreinstellungen der vordefinierten Befehl nicht
3947 mögen, können Sie sie ganz einfach umdefinieren, genauso wie
3948 jede andere Variable auch, indem Sie sie an den Anfang Ihrer
3949 Quelldatei schreiben.
3951 Hier sind die wichtisgsten Dateien, die sich im Ordner
3952 @file{ly/} befinden:
3954 @multitable @columnfractions .4 .6
3957 @item @file{ly/engraver-init.ly}
3958 @tab Definitionen von Engraver-Kontexten
3959 @item @file{ly/paper-defaults-init.ly}
3960 @tab Spezifikationen von Voreinstellungen für Papiermaße
3961 @item @file{ly/performer-init.ly}
3962 @tab Definitionen von Performer-Kontexten
3963 @item @file{ly/property-init.ly}
3964 @tab Definitionen aller vordefinierten Befehle
3965 @item @file{ly/spanner-init.ly}
3966 @tab Definitionen aller vordefinierten Strecker-Befehle
3969 Andere Einstellungen (wie die Definitionen von Beschriftungsbefehlen)
3970 sind in @code{.scm}-(Scheme)-Dateien gespeichert. Die
3971 Scheme-Programmiersprache wird benutzt, um eine
3972 programmierbare Schnittstelle zu den internen Operationen von
3973 LilyPond zu haben. Eine weitere Erklärung dieser Dateien ist
3974 im Moment außerhalb des Rahmens dieses Handbuchs, denn
3975 sie erfordern einige Kenntnis der Scheme-Sprache. Die Warnung
3976 ist hier angebracht, dass des ein gutes technisches Verständnis
3977 oder sehr viel Zeit braucht, um Scheme und diese
3978 Dateien zu verstehen (siehe auch @ref{Scheme tutorial}).
3980 Wenn Sie sich mit Scheme auskennen, sind hier mögliche
3981 interessante Dateien:
3983 @multitable @columnfractions .4 .6
3986 @item @file{scm/auto-beam.scm}
3987 @tab Sub-Balken-Voreinstellungen
3988 @item @file{scm/define-grobs.scm}
3989 @tab Voreinstellungen für Grob-Eigenschaften
3990 @item @file{scm/define-markup-commands.scm}
3991 @tab Definition aller Markup-Beschriftungsbefehle
3992 @item @file{scm/midi.scm}
3993 @tab Voreinstellung für die MIDI-Ausgabe
3994 @item @file{scm/output-lib.scm}
3995 @tab Einstellungen mit Einfluss auf die Darstellung von Bunddiagrammen, Farben, Versetzungszeichen, Taktlinien usw.
3996 @item @file{scm/parser-clef.scm}
3997 @tab Definitionen der unterstützten Schlüssel
3998 @item @file{scm/script.scm}
3999 @tab Voreinstellungen for Artikulationszeichen
4003 @node Avoiding tweaks with slower processing
4004 @subsection Avoiding tweaks with slower processing
4006 LilyPond kann einige zusätzliche Tests durchführen, während
4007 die Noten gesetzt werden. Dadurch braucht das Programm länger,
4008 um den Notensatz zu produzieren, aber üblicherweise werden
4009 weniger nachträgliche Anpassungen nötig sein. Wenn eine
4010 Textsilbe oder eine Beschriftung aus dem Rand der Partitur
4011 ragt, wird durch diese Tests die Zeile gerade so weit komprimiert,
4012 dass sie sich innerhalb der Ränder befindet.
4016 % Um sicher zu gehen, dass Texte und Liedtext
4017 % innerhalb der Papierränder bleiben
4018 \override PaperColumn #'keep-inside-line = ##t
4019 \override NonMusicalPaperColumn #'keep-inside-line = ##t
4026 @node Advanced tweaks with Scheme
4027 @subsection Advanced tweaks with Scheme
4029 Auch wenn viele Sachen mit @code{\override} und @code{\tweak}
4030 möglich sind, gibt es eine sehr viel mächtigere Möglichkeit, die
4031 Arbeitsweise von LilyPond mit Hilfe der programmierbaren Schnittstelle
4032 zu beeinflussen. Code, der in der Scheme-Programmiersprache
4033 geschrieben ist, kann direkt in die interne Satzmaschine von LilyPond
4034 eingefügt werden. Natürlich brauchen Sie dazu wenigstens ein
4035 grundlegendes Verständnis von Scheme. Eine Einleitung finden
4036 Sie in der @ref{Scheme tutorial}.
4038 Zur Illustration der vielen Möglichkeiten soll gezeigt werden, dass eine
4039 Eigenschaft nicht nur auf eine Konstante, sondern auch auf eine
4040 Scheme-Prozedur gesetzt werden kann, die dann jedes Mal
4041 aufgerufen wird, wenn die Eigenschaft von LilyPond benutzt
4042 wird. Die Eigenschaft kann damit dynamisch auf einen Wert
4043 gesetzt werden, der durch die Prozedur jedes Mal neu bestimmt
4044 wird. In diesem Beispiel wird die Farbe der Notenköpfe entsprechend
4045 zu ihrer Position innerhalb der Tonleiter gesetzt.
4047 @cindex x11-Farben, Beispiel zur Benutzung
4048 @cindex Notenkopf, Beispiel zur Veränderung
4049 @cindex Farb-Eigenschaft, in Scheme-Prozedur gesetzt
4051 @lilypond[quote,verbatim,ragged-right]
4052 #(define (color-notehead grob)
4053 "Color the notehead according to its position on the staff."
4054 (let ((mod-position (modulo (ly:grob-property grob 'staff-position) 7)))
4056 ;; Return rainbow colors
4057 ((1) (x11-color 'red )) ; for C
4058 ((2) (x11-color 'orange )) ; for D
4059 ((3) (x11-color 'yellow )) ; for E
4060 ((4) (x11-color 'green )) ; for F
4061 ((5) (x11-color 'blue )) ; for G
4062 ((6) (x11-color 'purple )) ; for A
4063 ((0) (x11-color 'violet )) ; for B
4069 % Arrange to obtain color from color-notehead procedure
4070 \override NoteHead #'color = #color-notehead
4077 Some -- where o -- ver the Rain -- bow, way up high,
4081 Weiter Beispiele, die die Benutzung dieser programmierbaren
4082 Schnittstelle zeigen, finden sich in @ref{Tweaking with Scheme}.