1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @c This file is part of lilypond-learning.tely
4 Translation of GIT committish: 3121682025660b6c85fbf3f22bb9cd8396699ad1
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::
32 @section Tweaking basics
35 * Introduction to tweaks::
36 * Objects and interfaces::
37 * Naming conventions of objects and properties::
41 @node Introduction to tweaks
42 @subsection Introduction to tweaks
44 @qq{Optimierung} (engl. tweaking) ist ein LilyPond-Begriff für die
45 verschiedenen Methoden, die Aktionen zu beeinflussen, die während
46 der Kompilation einer Notationsdatei vorgenommen werden sowie auf
47 das Notenbild einzuwirken. Einige dieser Opitmierungen sind sehr
48 einfach, andere dagegen recht komplex. Aber insgesamt erlaubt das
49 System an Optimierungen so gut wie alle möglichen Erscheindungsformen
52 In diesem Abschnitt werden die grundlegenden Konzepte vorgestellt,
53 um die Optimierung zu verstehen. Später soll eine Anzahl von fertigen
54 Befehlen bereitgestellt werden, die einfach in die Quelldatei
55 kopiert werden können um den selben Effekt wie im Beispiel
56 zu erhalten. Gleichzeitig zeigen diese Beispiele, wie die Befehle
57 konstruiert werden, so dass Sie in der Lage sein werden, eigene
58 Befehle auf dieser Grundlage zu entwickeln.
60 Bevor Sie mit diesem Kapitel beginnen, könnte Sie ein Blick in den
61 Abschnitt @ref{Contexts and engravers} interessieren, dann
62 Kontexte und Engraver sowie die Eigenschaften, die mit ihnen
63 verknüpft sind, sind die Voraussetzung, um die Funktionsweise
64 von Optimierungen verstehen zu können.
67 @node Objects and interfaces
68 @subsection Objects and interfaces
75 @cindex Schnittstellen
77 Optimierung bedeutet, die internen Operationen und Strukturen
78 des LilyPond-Programmes zu verändern, darum sollen hier
79 zunächst die wichtigesten Begriffe erklärt werden, die zur
80 Beschreibung dieser Operationen und Strukturen benutzt werden.
82 Der Begriff @qq{Objekt} ist ein allgemeiner Begriff, mit dem
83 die Vielzahl an internen Strukturen bezeichnet wird, die LilyPond
84 während der Bearbeitung des Quelltextes erstellt. Wenn etwa
85 ein Befehl wie @code{\new Staff} auftritt, wird ein neues Objekt
86 vom Typ @code{Staff} erstellt. Dieses Objekt @code{Staff} enthält
87 dann alle Eigenschaften, die mit diesem speziellen Notensystem
88 verknüpft sind, wie beispielsweise seine Bezeichnung, Tonart und
89 spezifische Angaben über die Engraver, die innerhalb dieses Systems
90 eingesetzt werden. Für alle anderen Kontexte gibt es genauso
91 Objekte, die deren Eigenschaften beinhalten, beispielsweise für
92 @code{Voice}-Objekte, @code{Score}-Objekte, @code{Lyrics}-Objekte,
93 aber auch für Objekte, die Notationselemente wie die Taktlinien,
94 Notenköpfe, Bögen und Dynamikbezeichnung enthalten. Jedes
95 Objekt hat eine eigene Gruppe an Eigenschaftswerten.
97 Bestimmte Objekttypen tragen besondere Bezeichnungen. Objekte, die
98 Notationselemente der gesetzten Ausgabe repräsentieren, also
99 Notenköpfe, Hälse, Bögen, Fingersatz, Schlüssel usw., werden
100 @qq{Layout-Objekte}, oft auch @qq{Graphische Objekte} genannt.
101 Daraus resultiert die künstliche Abkürzung @qq{Grob}.
102 Diese sind auch Objekte im allgemeinen Sinn und haben genauso
103 Eigenschaften, die mit ihnen verknüpft sind, wie etwa Größe, Position,
106 Einige Layout-Objekte sind etwas spezieller. Phrasierungsbögen,
107 Crescendo-Klammern, Oktavierungszeichen und viele andere
108 Grobs sind nicht an einer Stelle plaziert -- sie haben vielmehr
109 einen Anfangspunkt, einen Endpunkt und eventuell noch andere
110 Eigenschaften, die ihre Form bestimmen. Objekte mit solch
111 einer erweiterten Gestalt werden als
112 @qq{Strecker} (engl. Spanners)
115 Es bleibt uns noch übrig zu erklären, was @qq{Schnittstellen}
116 (engl. interface) sind. Wenn auch viele Objekte sehr unterschiedlich
117 sind, haben sie doch oft gemeinsame Eigenschaften, die auf
118 die gleiche Weise verarbeitet werden. Alle Grobs beispielsweise
119 haben eine Farbe, eine Größe, eine Position usw. und alle
120 diese Eigenschaften werden von LilyPond auf die gleiche Weise
121 verarbeitet, während der Quelltext in Notensatz umgesetzt wird.
122 Um die internen Operationen zu vereinfachen, sind alle diese
123 gemeinsamen Prozesse und Eigenschaften in einem Objekt
124 mit der Bezeichnung @code{grob-interface} (Schnittstelle eines
125 graphischen Objektes) zusammengefasst. Es gibt viele andere
126 Gruppen gemeinsamer Eigenschaften, die jede eine Bezeichnung
127 besitzen, welche auf @code{-interface} endet. Insgesamt
128 gibt es über 100 dieser Schnittstellen. Wir werden später sehen,
129 was es damit auf sich hat.
131 Dies waren die Hauptbegriffe, die in diesem Kapitel zur Anwendung
135 @node Naming conventions of objects and properties
136 @subsection Naming conventions of objects and properties
138 Es wurden schon früher einige Regeln zur Benennung von
139 Objekten vorgestellt, siehe
140 @ref{Contexts and engravers}. Hier eine Referenzliste der
141 häufigsten Objekt- und Eigenschaftsbezeichnungen mit
142 den Regeln für ihre Bezeichnung und
143 illustrierenden echten Bezeichnungen. Es wurde @qq{A}
144 für einen beliebigen Großbuchstaben und @qq{aaa} für eine
145 beliebige Anzahl an Kleinbuchstaben eingesetzt. Andere
146 Zeichen werden explizit angegeben.
148 @multitable @columnfractions .33 .33 .33
149 @headitem Objekt-/Eigenschaftstyp
150 @tab Naming convention
153 @tab Aaaa oder AaaaAaaaAaaa
154 @tab Staff, GrandStaff
156 @tab Aaaa oder AaaaAaaaAaaa
159 @tab Aaaa_aaa_engraver
160 @tab Clef_engraver, Note_heads_engraver
162 @tab aaa-aaa-interface
163 @tab grob-interface, break-aligned-interface
164 @item Kontext-Eigenschaften
165 @tab aaa oder aaaAaaaAaaa
166 @tab alignAboveContext, skipBars
167 @item Layout-Objekt-Eigenschaften
168 @tab aaa oder aaa-aaa-aaa
169 @tab direction, beam-thickness
172 Es wird bald ersichtlich werden, dass die Eigenschaften von
173 unterschiedlichen Objekttypen mit unterschiedlichen Befehlen
174 geändert werden. Deshalb ist es nützlich, aus der
175 Schreibweise zu erkennen, um was
176 für ein Objekt es sich handelt, um den entsprechenden
177 Befehl einsetzen zu können.
180 @node Tweaking methods
181 @subsection Tweaking methods
183 @strong{Der \override-Befehl}
185 @cindex override-Befehl
188 Wir haben uns schon mit den Befehlen @code{\set}
189 und @code{\with} bekannt gemacht, mit welchen
190 Eigenschaften von @strong{Kontexten} verändert
191 und @strong{Engraver} entfernt oder hinzugefügt
192 werden können. Siehe dazu
193 @ref{Modifying context properties} und @ref{Adding
194 and removing engravers}. Jetzt wollen wir uns weitere
195 wichtige Befehle anschauen.
197 Der Befehl, um die Eigenschaften von @strong{Layout-Objekten}
198 zu ändern, ist @code{\override}. Weil dieser Befehl interne
199 Eigenschaften tief in der Programmstruktur von LilyPond
200 verändern muss, ist seine Syntax nicht so einfach wie die der
201 bisherigen Befehle. Man muss genau wissen, welche Eigenschaft
202 welches Objektes in welchem Kontext geändert werder soll,
203 und welches der neu zu setzende Wert dann ist. Schauen wir
204 uns an, wie das vor sich geht.
206 Die allgemeine Syntax dieses Befehles ist:
209 \override @var{Kontext}.@var{LayoutObjekt} #'@var{layout-eigenschaft} = #@var{Wert}
213 Damit wir die Eigenschaft mit der Bezeichnung @var{layout-property}
214 das Layout-Objektes mit der Bezeichnung@var{LayoutObject},
215 welches ein Mitglied des @var{Kontext}-Kontextes ist, auf den
218 Der @var{Kontext} kann (und wird auch normalerweise) ausgelassen
219 werden, wenn der benötigte Kontext eindeutig impliziert ist und einer
220 der untersten Kontexte ist, also etwa @code{Voice}, @code{ChordNames}
221 oder @code{Lyrics}. Auch in diesem Text wird der Kontext oft ausgelassen
222 werden. Später soll gezeigt werden, in welchen Fällen er ausdrücklich
223 definiert werden muss.
225 Spätere Abschnitte behandeln umfassend Eigenschaften und ihre
226 Werte, aber um ihre Funktion und ihr Format zu demonstrieren,
227 werden wir hier nur einige einfache Eigenschaften und Werte einsetzen,
228 die einfach zu verstehen sind.
230 Für den Moment könne Sie die @code{#'}-Zeichen ignorieren, die vor jeder
231 Layout-Eigenschaft, und die @code{#}-Zeichen, die vor jedem Wert
232 stehen. Sie müssen immer in genau dieser Form geschrieben werden.
233 Das ist der am häufigsten gebrauchte Befehl für die Optimierung,
234 und der größte Teil dieses Abschnittes wird dazu benutzt, seine Benutzung
235 zu erläutern. Hier ein einfaches Beispiel, um die Farbe des Notenkopfes
238 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
240 \override NoteHead #'color = #red
242 \override NoteHead #'color = #green
246 @strong{Der \revert-Befehl}
248 @cindex revert-Befehl
251 Wenn eine Eigenschaft einmal überschrieben wurde, wird ihr
252 neuer Wert so lange bewahrt, bis er noch einmal überschrieben
253 wird oder ein @code{\revert}-Befehl vorkommt. Der
254 @code{\revert}-Befehl hat die folgende Syntax und setzt den
255 Wert der Eigenschaft zurück auf den Standardwert, nicht
256 jedoch auf den vorigen Wert, wenn mehrere
257 @code{\override}-Befehle benutzt wurden.
260 \revert @var{Kontext}.@var{LayoutObjekt} #'@var{layout-eigenschaft}
263 Wiederum, genauso wie der @var{Kontext} bei dem @code{\override}-Befehl,
264 wird @var{Kontext} oft nicht benötigt. Er wird in vielen der folgenden
265 Beispiele ausgelassen. Im nächsten Beispiel wird die Farbe des Notenkopfes
266 wieder auf den Standardwert für die letzten zwei Noten gesetzt.
268 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
270 \override NoteHead #'color = #red
272 \override NoteHead #'color = #green
274 \revert NoteHead #'color
278 @strong{\once-Präfix}
280 Sowohl der @code{\override}-Befehl als auch der @code{\set}-Befehl können mit
281 dem Präfix @code{\once} (@emph{einmal}) versehen werden. Dadurch wird
282 der folgende @code{\override}- oder @code{\set}-Befehl nur für den aktuellen
283 Musik-Moment wirksam, bevor sich wieder der Standard einstellt. Am gleichen
284 Beispiel demonstriert, kann damit die Farbe eines einzelnen Notenkopfes
287 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
289 \once \override NoteHead #'color = #red
291 \once \override NoteHead #'color = #green
295 @strong{Der \overrideProperty-Befehl}
297 @cindex overrideProperty-Befehl
298 @funindex \overrideProperty
300 Es gibt eine andere Form des @code{override}-Befehls,
301 @code{\overrideProperty} (überschreibe Eigenschaft),
302 welcher ab und zu benötigt wird. Es wird hier nur der
303 Vollständigkeit halber erwähnt, sein Einsatz wird demonstriert
304 in @ruser{Difficult tweaks}.
305 @c Maybe explain in a later iteration -td
307 @strong{Der \tweak-Befehl}
312 Der letzte Optimierungsbefehl in LilyPond ist @code{\tweak}
313 (engl. optimieren). Er wird eingesetzt um Eigenschaften
314 von Objekten zu verändern, die zum selben Musik-Moment
315 auftreten, wie etwa die Noten eines Akkordes. Ein
316 @code{\override} würde alle Noten des Akkords beeinflussen,
317 während mit @code{\tweak} nur das nächste Objekt der
318 Eingabe geändert wird.
320 Hier ein Beispiel. Angenommen, die Größe des mittleren
321 Notenkopfes (ein E) in einem C-Dur-Akkord soll geändert
322 werden. Schauen wir zuerst, was wir mit
323 @code{\once \override} erhalten:
325 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
327 \once \override NoteHead #'font-size = #-3
332 Wie man sehen kann, beeinflusst @code{override} @emph{alle}
333 Notenköpfe des Akkordes. Das liegt daran, dass alle die Noten
334 eines Akkordes zum selben Musik-Moment auftreten und
335 die Funktion von @code{\once} ist es, die Optimierung auf
336 an allen Objekten auszuführen, die zum selben Musik-Moment
337 auftreten wie der @code{\override}-Befehl.
339 Der @code{\tweak}-Befehl funktioniert anders. Er bezieht sich
340 auf das direkt folgende Element in der Eingabe-Datei. Es wirkt
341 aber auch nur mit Objekten, die direkt von der Eingabe kreirt
342 werden, insbesondere Notenköpfe und Artikulationszeichen.
343 Objekte wie etwa Hälse oder Versetzungszeichen werden erst
344 später erstellt und lassen sich nicht auf diese Weise ändern.
345 Zusätzlich @emph{müssen} sich etwa Notenköpfe innerhalb
346 eines Akkordes befinden, d. h. sie müssen von einfachen spitzen
347 Klammern umschlossen sein. Um also eine einzelne Note
348 mit @code{\tweak} zu verändern, muss der Befehl innerhalb
349 der spitzen Klammern zusammen mit der Note eingegeben werden.
351 Um also zu unserem Beispiel zurückzukommen, könnte man die
352 mittlere Note eines Akkordes auf diese Weise ändern:
354 @lilypond[quote,fragment,ragged-right,verbatim,relative=1]
356 <c \tweak #'font-size #-3 e g>4
359 Beachten Sie, dass die Syntax des @code{\tweak}-Befehls sich
360 von der des @code{\override}-Befehls unterscheidet. Weder
361 Kontext noch Layout-Objekt konnen angegeben werden, denn
362 das würde zu einem Fehler führen. Beide Angaben sind
363 durch das folgende Element impliziert. Die verallgemeinerte
364 Syntax des @code{\tweak}-Befehls ist also einfach
367 \tweak #'@var{layout-eigenschaft} = #@var{Wert}
370 Ein @code{\tweak}-Befehl kann auch benutzt werden, um nur
371 eine von mehreren Artikulationen zu ändern, wie im nächsten
372 Beispiel zu sehen ist.
374 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
376 -\tweak #'color #red ^Red
377 -\tweak #'color #green _Green
381 Beachten Sie, dass dem @code{\tweak}-Befehl ein Artikulationsmodifikartor
382 vorangestellt werden muss, ganz als ob er selbst ein Artikulationszeichen
385 @cindex Triolen, geschachtelt
386 @cindex N-tolen, geschachtelt
387 @cindex Klammer, Triole
388 @cindex Triolenklammer
389 @cindex N-tolenklammer
390 @cindex Komplizierte Rhythmen, Schachtelung von
391 @funindex TupletBracket
393 Der @code{\tweak}-Befehl muss auch benutzt werden, wenn das
394 Aussehen einer vor mehreren geschachtelten Triolenklammern
395 geändert werden soll, die zum selben Zeitpunkt beginnen.
396 Im folgenden Beispiel beginnen die lange Klammer und die
397 erste Triolenklammer zum selben Zeitpunkt, sodass ein
398 @code{\override}-Befehl sich auf beide beziehen würde.
399 In dem Beispiel wird @code{\tweak} benutzt, um zwischen
400 ihnen zu unterscheiden. Der erste @code{\tweak}Befehl
401 gibt an, dass die lange Klammer über den Noten gesetzt
402 werden soll, und der zweite, dass die Zahl der rhythmischen
403 Aufteilung für die erste der kurzen Klammern in rot
406 @lilypond[quote,ragged-right,verbatim,fragment,relative=2]
407 \tweak #'direction #up
410 \times 2/3 { c8[ c8 c8] }
411 \times 2/3 { c8[ c8 c8] }
412 \times 2/3 { c8[ c8 c8] }
416 Wenn geschachtelte N-tolen nicht zum gleichen Zeitpunkt
417 beginnen, kann ihr Aussehen auf die übliche Art mit dem
418 @code{\override}-Befehl geändert werden:
420 @c NOTE Tuplet brackets collide if notes are high on staff
422 @lilypond[quote,ragged-right,verbatim,fragment,relative=1]
423 \times 2/3 { c8[ c c]}
424 \once \override TupletNumber
425 #'text = #tuplet-number::calc-fraction-text
429 \once \override TupletNumber #'transparent = ##t
430 \times 2/3 { c8[ c c] }
431 \times 2/3 { c8[ c c]}
438 @ruser{The tweak command}.
444 @node The Internals Reference manual
445 @section The Internals Reference manual
448 * Properties of layout objects::
449 * Properties found in interfaces::
450 * Types of properties::
453 @node Properties of layout objects
454 @subsection Properties of layout objects
456 @cindex Eigenschaften von Layout-Objekten
457 @cindex Eigenschaften von Grobs
458 @cindex Grobs, Eigenschaften von
459 @cindex Layout-Objekte, Eigenschaften von
460 @cindex Property (Layout-Objekte, Grobs)
462 Angenommen, in Ihrer Partitur tritt ein Legatobogen
463 auf, der Ihrer Meinung nach zu dünn ausgefallen ist.
464 Sie würden ihn gerne etwas schwerer gezeichnet
465 sehen. Wie gehen Sie vor? Von den Anmerkungen in
466 früheren Abschnitten wissen Sie schon, dass LilyPond
467 sehr flexibel ist und eine derartige Modifikation
468 möglich sein sollte, und Sie erraten vielleicht,
469 dass ein @code{\override}-Befehl angebracht ist.
470 Aber gibt es eine Eigenschaft für die Dicke eines
471 Legatobogens (engl. slur), und wenn es sie gibt,
472 auf welche Weise lässt sie sich verändern? Hier
473 kommt die Referenz der Interna zur Geltung. Dort
474 finden sich alle Informationen, um den beschriebenen
475 und alle anderen @code{\override}-Befehle zu
478 Bevor Sie jetzt in die Referenz der Interna wechseln, ist
479 eine Warnung angebracht. Es handelt sich um ein
480 @strong{Referenz}dokument, was heißt, dass es sehr
481 wenig oder gar keine Erklärungen enthält: seine Aufgabe
482 ist es, Information klar und genau darzustellen. Das
483 bedeutet, dass es auf den ersten Blick entmutigend
484 wirkt. Die Einführung und Erklärung in diesem Abschnitt
485 wird Ihnen aber schnell ermöglichen, genau die Information
486 aus der Referenz zu entnehmen, die Sie benötigen.
488 Beachten Sie, dass die Referenz der Interna nur auf Englisch
489 existiert. Um die Eigenschaftsbezeichnung eines bestimmten
490 Objektes zu finden, können Sie das Glossar (siehe
491 @c @r glos{Music Glossary})
492 @ref{Music Glossary,,,music-glossary,Musikglossar})
494 die englischen Begriffe in viele andere Sprachen übersetzt sind.
496 @cindex Override-Beispiel
497 @cindex Referenz der Interna, Benutzung
498 @cindex IR (Referenz der Interna), Benutzung
500 Das Vorgehen soll an einem konkreten Beispiel einer echten
501 Komposition demonstriert werden. Hier das Beispiel:
503 @lilypond[quote,verbatim,relative=2]
508 g[( e]) e d[( f]) a |
512 The man who feels love's sweet e -- mo -- tion
517 Angenommen also, wir wollen die Legatobögen etwas
518 dicker setzten. Ist das möglich? Die Legatobögen sind mit
519 Sicherheit ein Layout-Objekt, die Frage muss also lauten:
520 @qq{Gibt es eine Eigenschaft von Legatobögen, die die
521 Dicke bestimmt?} Um diese Frage zu beantworten, müssen
522 wir in der Referenz der Interna ( kurz IR) nachschauen.
524 Die IR für die LilyPond-Version, die Sie benutzen, findet sich
525 auf der LilyPond-Webseite unter der Adresse
526 @uref{http://lilypond.org}. Gehen Sie zur Dokumentationsseite
527 und klicken Sie auf den Link zur Referenz der Interna.
528 @c Addition for German users
529 Die Sprache ändert sich ab hier nach englisch. Für diese Übung
530 sollten Sie die HTML-Version benutzen, nicht die
531 @qq{auf einer großen Seite} oder die PDF-Version.
532 Damit Sie die nächsten Absätze verstehen können, müssen Sie
533 genauso vorgehen, während Sie weiterlesen.
535 Unter der Überschrift @strong{Top} befinden sich fünf Links.
536 Wählen Sie den Link zum @emph{Backend}, wo sich die Information
537 über Layout-Objekte befindet. Hier, unter der Überschrift
538 @strong{Backend}, wählen Sie den Link @emph{All layout objects}.
539 Die Seite, die sich öffnet, enthält ein Liste aller Layout-Objekte,
540 die in Ihrerer LilyPond-Version benutzt werden, in alphabetischer
541 Ordnung. Wählen Sie den Link @emph{Slur} und die Eigenschaften
542 der Legatobögen (engl. slur) werden aufgelistet.
544 Eine alternative Methode, auf diese Seite zu gelangen, ist von
545 der Notationsreferenz aus. Auf einer der Seiten zu Legatobögen
546 findet sich ein Link zur Referenz der Interna. Dieser Link führt
547 Sie direkt auf diese Seite. Wenn Sie aber eine Ahnung haben,
548 wie die Bezeichnung des Layout-Objektes lauten könnte, das sie
549 ändern wollen, ist es oft schneller, direkt zur IR zu gehen und
552 Aus der Slur-Seite in der IR könne wir entnehmen, dass
553 Legatobögen (Slur-Objekte) durch den Slur_engraver erstellt
554 werden. Dann werden die Standardeinstellungen aufgelistet.
555 Beachten Sie, dass diese @strong{nicht} in alphabetischer Reihenfolge
556 geordnet sind. Schauen Sie sich die Liste an, ob sie eine Eigenschaft
557 enthält, mit der die Dicke von Legatobögen kontrolliert werden kann.
558 Sie sollten folgendes finden:
561 @code{thickness} (number)
563 Line thickness, generally measured in @code{line-thickness}
566 Das sieht ganz danach aus, als ob damit die Dicke geändert
567 werden kann. Es bedeutet, dass der Wert von
568 @code{thickness} einfach eine Zahl (@emph{number}) ist,
569 dass der Standardwert 1.2 ist, und dass die Einheit
570 für die Dicke eine andere Eigenschaft mit der
571 Bezeichnung @code{line-thickness} ist.
573 Wie schon früher gesagt, gibt es wenig bis gar keine Erklärungen
574 in der IR, aber wir haben schon genug Informationen, um
575 zu versuchen, die Dicke eines Legatobogens zu ändern. Die
576 Bezeichnung des Layout-Objekts ist offensichtlich
577 @code{Slur} und die Bezeichnung der Eigenschaft, die geändert
579 @code{thickness}. Der neue Wert sollte etwas mehr als 1.2 sein,
580 denn der Bogen soll ja dicker werden.
585 @node Properties found in interfaces
586 @subsection Properties found in interfaces
590 @node Types of properties
591 @subsection Types of properties
595 @node Appearance of objects
596 @section Appearance of objects
601 * Visibility and color of objects::
603 * Length and thickness of objects::
606 @node Visibility and color of objects
607 @subsection Visibility and color of objects
611 @node Size of objects
612 @subsection Size of objects
616 @node Length and thickness of objects
617 @subsection Length and thickness of objects
621 @node Placement of objects
622 @section Placement of objects
627 * Automatic behavior::
628 * Within-staff objects::
629 * Outside staff objects::
632 @node Automatic behavior
633 @subsection Automatic behavior
637 @node Within-staff objects
638 @subsection Within-staff objects
642 @node Outside staff objects
643 @subsection Outside staff objects
648 @node Collisions of objects
649 @section Collisions of objects
653 * Fixing overlapping notation::
654 * Real music example::
658 @subsection Moving objects
660 Es wird vielleicht eine Überraschung sein, aber LilyPond ist nicht
661 perfekt. Einige Notationselemente können sich überschneiden. Das
662 ist nicht schön, kann aber (in den meisten Fällen) sehr einfach
665 @c FIXME: find a better example for 5.1 Moving Objects. -gp
666 @c yes, I want this TODO to be visible to end-users. It's better
667 @c than having nothing at all.
668 TODO: Mit den neuen Abstandseigenschaften seit Version 2.12 sind die
669 jeweiligen Beispiele nicht mehr relevant. Sie zeigen jedoch immer noch
670 machtvolle Eigenschaften von LilyPond und verbleiben deshalb in der
671 Dokumentation, bis jemand bessere Beispiel zur Verfügung stellt.
673 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
674 % temporary code to break this example:
675 \override TextScript #'outside-staff-priority = ##f
676 e4^\markup{ \italic ritenuto } g b e
679 @cindex Abstände füllen
681 Die einfachste Lösung ist es, Abstände zwischen Objekt und Note zu vergrößern
682 (genauso auch für Fingersätze oder Dynamikzeichen). In
683 LilyPond wird das durch Veränderung der @code{padding} (Füllungs)-Eigenschaft
684 erreicht, ihre Maßeinheit sind Notenzeilenabstände. Für die meisten
685 Objekte ist der Wert etwa 1.0 oder weniger (das unterscheidet sich
686 von Objekt zu Objekt). Hier soll der Abstand vergrößert werden, also
687 scheint 1.5 eine gute Wahl.
689 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
690 % temporary code to break this example:
691 \override TextScript #'outside-staff-priority = ##f
692 \once \override TextScript #'padding = #1.5
693 e4^\markup{ \italic ritenuto } g b e
696 Das sieht besser aus, ist aber noch nicht groß genug. Nach einigen
697 Experimenten wird darum 2.3 genommen für diesen Fall. Diese Zahl
698 ist aber nur das Resultat einigen Probierens und persönlicher
699 Geschmack. Probieren Sie selber ein wenig herum und entscheiden
700 Sie nach eigenem Geschmack.
702 Die @code{staff-padding}-Eigenschaft ist der vorigen sehr ähnlich.
703 @code{padding} entscheidet über den minimalen Abstand zwischen einem
704 Objekt und dem nächsten anderen Objekt (meistens eine Note oder
705 Notenzeile); @code{staff-padding} entscheidet über den minimalen
706 Abstand zwischen einem Objekt und dem Notensystem. Das ist nur ein
707 kleiner Unterschied, aber hier wird das Verhalten demonstriert:
709 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
710 % temporary code to break this example:
711 \override TextScript #'outside-staff-priority = ##f
713 \once \override TextScript #'padding = #4.6
715 \once \override TextScript #'staff-padding = #4.6
716 c4^"piu mosso" fis a g
718 c'4^"piu mosso" b a b
719 \once \override TextScript #'padding = #4.6
721 \once \override TextScript #'staff-padding = #4.6
722 c4^"piu mosso" fis a g
725 @cindex Abstand, zusätzlicher
728 Eine andere Lösung ermöglicht vollständige Kontrolle über die Positionierung
729 eines Objektes sowohl horizontal als auch vertikal. Das wird mit der
730 @code{extra-offset} (Zusätzlicher-Abstand)-Eigenschaft erreicht. Das
731 ist etwas komplizierter und kann andere Probleme mit sich ziehen. Wenn
732 Objekte mit dieser Eigenschaft verschoben werden, heißt das, dass
733 LilyPond sie erst setzt, nachdem alle anderen Objekte positioniert
734 worden sind. Deshalb können sich die Objekte am Ende überlagern.
736 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
737 % temporary code to break this example:
738 \override TextScript #'outside-staff-priority = ##f
739 \once \override TextScript #'extra-offset = #'( 1.0 . -1.0 )
740 e4^\markup{ \italic ritenuto } g b e
743 Bei Verwendung von @code{extra-offset} bestimmt die erste Zahl über die
744 horizontale Verschiebung (nach links ist negativ), die zweite Zahl
745 bestimmt die vertikale Verschiebung (nach oben ist positiv). Nach einigen
746 Experimenten wurden hier folgende Werte für gut befunden:
748 @lilypond[quote,fragment,ragged-right,verbatim,relative=2]
749 % temporary code to break this example:
750 \override TextScript #'outside-staff-priority = ##f
751 \once \override TextScript #'extra-offset = #'( -1.6 . 1.0 )
752 e4^\markup{ \italic ritenuto } g b e
756 Auch diese Zahlen sind nur Resultat einigen Herumprobierens und Vergleichens
757 der Ergebnisse. Sie wollen den Text vielleicht etwas höher oder etwas mehr
758 nach links setzen. Versuchen Sie es selber und vergleichen Sie das Ergebnis.
760 Eine letzte Warnung: in diesem Kapitel haben wir den Befehl
763 \once \override TextScript @dots{}
767 benutzt. Dieser Befehl verändert die Anzeige des Textes für die nächste
768 Note. Wenn die Note keinen Text zugeordnet hat, wird auch nichts
769 verändert (und es wird @strong{nicht} nach dem nächsten Text gesucht).
770 Um das Verhalten zu verändern, so dass alles, was nach dem Befehl
771 kommt, verändert wird, müssen Sie den Befehl @code{\once} weglassen.
772 Um die Veränderung zu stoppen, benutzen Sie den Befehl @code{\revert}.
773 Das wird genauer im Kapitel
774 @ruser{The \override command} erklärt.
776 @lilypond[quote,fragment,ragged-right,verbatim,relative=3]
777 % temporary code to break this example:
778 \override TextScript #'outside-staff-priority = ##f
780 \once \override TextScript #'padding = #4.6
783 \once \override TextScript #'padding = #4.6
787 \override TextScript #'padding = #4.6
790 \revert TextScript #'padding
796 @ruser{The \override command}, @ref{Common tweaks}.
799 @node Fixing overlapping notation
800 @subsection Fixing overlapping notation
802 Im Kapitel @ref{Moving objects} wurde gezeigt, wie man Texte
803 (@code{TextScript}-Objekte) verschiebt. Mit der gleichen
804 Technik können auch andere Objektklassen verschoben werden,
805 @code{TextScript} muss dann nur durch den Namen des Objektes
808 Um den Objektnamen zu finden, siehe die @q{@strong{see also}}-Hinweise
809 am Ende des jeweiligen Abschnittes. Zum Beispiel am Ende des
810 Kapitels @ruser{Dynamics} findet sich:
815 Programmreferenz: @rinternals{DynamicText}, @rinternals{Hairpin}.
816 Vertikale Positionierung dieser Symbole wird mit
817 @rinternals{DynamicLineSpanner} erreicht.
821 Um also Dynamik-Zeichen zu verschieben, muss
824 \override DynamicLineSpanner #'padding = #2.0
827 benutzt werden. Es ist nicht genügend Platz, um jedes Objekt aufzulisten,
828 aber die gebräuchlichsten finden sich hier:
830 @multitable @columnfractions .33 .66
831 @headitem Objekttyp @tab Objektbezeichnung
832 @item Dynamikzeichen (vertikal) @tab @code{DynamicLineSpanner}
833 @item Dynamikzeichen (horizontal) @tab @code{DynamicText}
834 @item Bindebögen @tab @code{Tie}
835 @item Phrasierungsbögen @tab @code{Slur}
836 @item Artikulationszeichen @tab @code{Script}
837 @item Fingersatz @tab @code{Fingering}
838 @item Text, z. B. @code{^"text"} @tab @code{TextScript}
839 @item Übungs-/Textmarken @tab @code{RehearsalMark}
843 @node Real music example
844 @subsection Real music example
849 @c DEPRECATED SECTION
851 @section Common tweaks
853 Bestimmte Korrekturen sind so häufig, dass für sie schon fertige
854 angepasste Befehle bereitgestellt sind, so etwa
855 @code{\slurUp} um einen Bindebogen oberhalb anzuzeigen oder
856 @code{\stemDown} um den Notenhals nach unten zu zwingen. Diese
857 Befehle sind im Teil Alles über die Notation unter dem
858 entsprechenden Abschnitt erklärt.
860 Eine vollständige Liste aller Veränderungen, die für jeden Objekttypen
861 (etwa Bögen oder Balken) zur Verfügung stehen, ist in der Programmreferenz
862 dargestellt. Viele Layoutobjekte benutzen jedoch gleiche Eigenschaften,
863 die benutzt werden können, um eigene Einstellungen vorzunehmen.
871 @code{padding}-Eigenschaft kann gesetzt werden, um den Abstand zwischen
872 Symbolen über oder unter den Noten zu vergrößern oder zu verkleinern.
873 Das gilt für alle Objekte, die ein @code{side-position-interface}
874 besitzen, also unterscheiden, auf welcher Seite der Note sie sich befinden.
876 @lilypond[quote,fragment,relative=1,verbatim]
878 \override Script #'padding = #3
882 @lilypond[quote,fragment,relative=1,verbatim]
883 % This will not work, see below:
884 \override MetronomeMark #'padding = #3
888 \override Score.MetronomeMark #'padding = #3
893 Im zweiten Beispiel ist es sehr wichtig zu wissen, welcher Kontext
894 für bestimmte Objekte zuständig ist. Weil das
895 @code{MetronomeMark}-Objekt vom @code{Score}-Kontext gesetzt
896 wird, werden Veränderungen innerhalb des @code{Voice}-Kontextes
897 nicht berücksichtigt. Genauere Details im Kapitel
898 @ruser{The \override command}.
901 @cindex zusätzlicher Abstand
902 @cindex Abstand, zusätzlicher
905 Die @code{extra-offset}-Eigenschaft verschiebt Objekte, hier ist ein
906 Zahlenpaar zur Angabe der Positionierung erforderlich. Die erste Nummer bestimmt
907 die horizontale Bewegung, eine positive Zahl bewegt das Objekt nach rechts.
908 Die zweite Zahl bestimmt die vertikale Bewegung, eine positive Zahl bewegt
909 das Objekt nach oben. Die
910 @code{extra-offset}-Eigenschaft läuft auf unterster Ebene ab: Die
911 Formatierungsmaschine ist sich der Veränderungen nicht bewusst.
913 Im folgenden Beispiel wird die zweite Fingersatzbezeichnung etwas nach
914 links verschoben und 1,8 Notenzeilenabstände nach unten:
916 @lilypond[quote,fragment,relative=1,verbatim]
919 \once \override Fingering
920 #'extra-offset = #'(-0.3 . -1.8)
925 Die Verwendung der @code{transparent}-Eigenschaft druckt das entsprechende Objekt
926 mit @qq{unsichtbarer Druckerschwärze}: Das Objekt wird nicht angezeigt, aber
927 sein Verhalten bleibt bestehen. Das Objekt nimmt weiterhin Platz ein, es nimmt
928 teil an Überschneidungen und deren Auflösung durch das Programm, Bögen und Balken
929 können daran angebunden werden.
931 @cindex transparente Objekte
932 @cindex Entfernen von Objekten
933 @cindex Verstecken von Objekten
934 @cindex unsichtbare Objekte
935 Das nächste Beispiel zeigt, wie man unterschiedliche Stimmen mit
936 Bindebögen verbinden kann. Normalerweise können Bindebögen nur
937 zwei Noten der selben Stimme verbinden. Indem aber ein Bogen in einer
938 anderen Stimme erstellt wird,
940 @lilypond[quote,fragment,relative=2]
949 und dann der erste Hals nach oben unsichtbar gemacht wird, scheint der
950 Bindebogen die Stimme zu wechseln:
953 @lilypond[quote,fragment,relative=2,verbatim]
955 \once \override Stem #'transparent = ##t
962 Damit der Hals den Bogen nicht zu sehr verkleinert, wird seine
963 Länge (@code{length}) auf den Wert @code{8} gesetzt:
966 @lilypond[quote,fragment,relative=2,verbatim]
968 \once \override Stem #'transparent = ##t
969 \once \override Stem #'length = #8
978 @cindex Veränderungen von Abständen
979 @cindex Optimierung von Abständen
982 Abstände in LilyPond werden in Notenzeilenabständen
983 (@code{staff-space}) gemessen, während die meisten Dicke-Eigenschaften
984 auf mit der Notenliniendicke korrespondieren. Eine Eigenschaften
985 verhalten sich anders, etwa die Dicke von Balken ist an die
986 Notenzeilenabstände gekoppelt. Mehr Information findet sich
987 im relevanten Teil der Programmreferenz.
989 @node Further tweaking
990 @section Further tweaking
993 * Other uses for tweaks::
994 * Using variables for tweaks::
995 * Other sources of information::
996 * Avoiding tweaks with slower processing::
997 * Advanced tweaks with Scheme::
1000 @node Other uses for tweaks
1001 @subsection Other uses for tweaks
1005 @node Using variables for tweaks
1006 @subsection Using variables for tweaks
1010 @node Other sources of information
1011 @subsection Other sources of information
1013 Die Programmreferenz enthält sehr viel Information über LilyPond, aber
1014 noch mehr Information findet sich in den internen
1017 Eine Standardeinstellungen (wie die Definitionen für den Kopf (@code{\header}
1018 sind als @code{.ly}-Datei gespeichert. Andere Einstellungen
1019 (wie die Definition für Beschriftung (@code{markup}) sind
1020 als @code{.scm} (Scheme)-Datei gespeichert. Eine nähere Erklärung
1021 geht über den Rahmen dieses Handbuches hinaus. Der Hinweis
1022 scheint aber angebracht, dass es grundlegende technische
1023 Kenntnis und sehr viel Zeit erfordert, diese Dateien zu verstehen.
1027 @item Linux: @file{@var{installdir}/lilypond/usr/share/lilypond/current/}
1030 @file{@var{installdir}/LilyPond.app/Contents/Resources/share/lilypond/current/}.
1031 Um diese Ordner anzuschauen, wechseln Sie entweder mit @code{cd} im Terminal
1032 zu der Adresse oder klicken Sie mit der rechten Maustaste auf das LilyPond-Symbol
1033 und wählen Sie @q{Show Package Contents}.
1035 @item Windows: @file{@var{installdir}/LilyPond/usr/share/lilypond/current/}
1039 Die @file{ly/} und @file{scm/}-Ordner sind von besonderem Interesse.
1040 Dateien wie @file{ly/property-init.ly} und
1041 @file{ly/declarations-init.ly} definieren alle häufig vorkommenden Veränderungen.
1044 @node Avoiding tweaks with slower processing
1045 @subsection Avoiding tweaks with slower processing
1047 LilyPond kann einige zusätzliche Tests durchführen, während
1048 die Noten gesetzt werden. Dadurch braucht das Programm länger,
1049 um den Notensatz zu produzieren, aber üblicherweise werden
1050 weniger nachträgliche Anpassungen nötig sein.
1053 %% Um sicher zu gehen, dass Texte und Liedtext
1054 %% innerhalb der Papierränder bleiben
1055 \override Score.PaperColumn #'keep-inside-line = ##t
1059 @node Advanced tweaks with Scheme
1060 @subsection Advanced tweaks with Scheme
1062 Es wurde schon gezeigt, wie die LilyPond-Ausgabe sehr stark verändert
1063 werden kann, indem man Befehle wie
1064 @code{\override TextScript #'extra-offset = ( 1 . -1)} benutzt. Aber
1065 noch mehr Einfluss auf die Formatierung kann durch den Einsatz von
1066 Scheme genommen werden. Eine vollständige Erklärung findet sich in der
1067 @ref{Scheme tutorial} und den
1068 @ruser{Interfaces for programmers}.
1070 Scheme kann benutzt werden, um einfach nur Befehle zu @qq{überschreiben}
1073 @lilypond[quote,verbatim,ragged-right]
1074 padText = #(define-music-function (parser location padding) (number?)
1076 \once \override TextScript #'padding = #$padding
1080 c4^"piu mosso" b a b
1082 c4^"piu mosso" d e f
1084 c4^"piu mosso" fis a g
1088 Hiermit können aber auch neue Befehle erstellt werden:
1090 @lilypond[quote,verbatim,ragged-right]
1091 tempoMark = #(define-music-function (parser location padding marktext)
1094 \once \override Score . RehearsalMark #'padding = $padding
1095 \once \override Score . RehearsalMark #'extra-spacing-width = #'(+inf.0 . -inf.0)
1096 \mark \markup { \bold $marktext }
1101 \tempoMark #3.0 #"Allegro"
1106 Sogar ganze musikalische Ausdrücke können eingefügt werden:
1108 @lilypond[quote,verbatim,ragged-right]
1109 pattern = #(define-music-function (parser location x y) (ly:music? ly:music?)
1116 \pattern {d16 dis} { ais16-> b\p }