1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: hu -*-
2 @c This file is part of learning.tely
4 Translation of GIT committish: 48c2b169dc8a9bc2ab2c767cbb83b57cc158742b
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
11 @c Translators: Griechisch Erika, Harmath Dénes
13 @c -*- coding: utf-8; mode: texinfo; -*-
17 @translationof Fundamental concepts
18 @translationof Fundamental concepts
20 Miután megtanultuk, hogyan állíthatunk elő gyönyörű kottákat egyszerű szöveges
21 fájlokból, ebben a szakaszban megismerjük azokat a fogalmakat és technikákat,
22 amelyek segítségével hasonlóan gyönyörű, de bonyolultabb kottákat készíthetünk.
25 * Hogyan működnek a LilyPond bemeneti fájlok?::
26 * A szólamok zenét tartalmaznak::
27 * Kontextusok és ábrázolók::
28 * A sablonok kibővítése::
31 @node Hogyan működnek a LilyPond bemeneti fájlok?
32 @section Hogyan működnek a LilyPond bemeneti fájlok?
33 @translationof How LilyPond input files work
34 @translationof How LilyPond input files work
36 A LilyPond bemeneti formátuma meglehetősen rugalmas, így a tapasztalt
37 felhasználóknak nagy szabadságot ad abban, hogyan strukturálják a
38 forrásfájljaikat. Azonban ez a rugalmasság az újdonsült felhasználók számára
39 bonyolult lehet. Ez a szakasz elmagyarázza a struktúra nagy részét, az
40 egyszerűség kedvéért bizonyos részleteket elnagyolva. A bemeneti formátum
41 felépítésének teljes leírása a @ruser{File structure} c. szakaszban olvasható.
44 * Bevezetés a LilyPond fájlok szerkezetébe::
45 * A kotta egy összetett zenei kifejezés::
46 * Zenei kifejezések egymásba ágyazása::
47 * A gerendák és ívek átfedhetik egymást::
50 @node Bevezetés a LilyPond fájlok szerkezetébe
51 @subsection Bevezetés a LilyPond fájlok szerkezetébe
52 @translationof Introduction to the LilyPond file structure
53 @translationof Introduction to the LilyPond file structure
55 @c index bemeneti formátum
56 @c index fájlstruktúra
58 A LilyPond bemeneti fájlok szerkezetére egy tipikus példa:
61 \version @w{"@version{}"}
66 @var{...összetett zenei kifejezés...} % ide jön a zene!
73 Ennek az alapvető mintának sok változata lehetséges, de ez a példa jó
74 kiindulási alapot jelent.
83 Eddig egyik példa sem használta a @code{\score@{@}} parancsot. Ennek oka, hogy
84 a LilyPond automatikusan hozzáadja az egyszerű bemenethez a szükséges
85 parancsokat. A következő bemenet például:
94 a következő rövidítése:
111 Más szóval, ha a bemenet egyetlen zenei kifejezést tartalmaz, a LilyPond úgy
112 értelmezi a fájlt, mintha a zenei kifejezés körül már szerepelnének a fenti
115 @cindex implicit kontextusok
117 @strong{Figyelem!} A dokumentációban sok példa nem tartalmazza a
118 @code{\new Staff} és @code{\new Voice} parancsokat, így azok implicite kerülnek
119 létrehozásra. Ez egyszerű példáknál jól működik, de bonyolultabb esetekben,
120 főleg, ha más parancsokat is használunk, a kontextusok implicit létrehozása
121 meglepő kimenetet eredményezhet, például nemkívánatos kottasorok jelenlétét.
122 A kontextusok explicit megadásának módja a @ref{Kontextusok és ábrázolók} c.
125 @warning{Többszólamú zeneművek esetén ajánlott explicit módon létrehozni a
126 kottasorokat és az azon belüli szólamokat.}
128 Egyelőre térjünk vissza az első példánkhoz, és vizsgáljuk meg csak a
129 @code{\score} parancsot.
131 A @code{\score} blokkon belül először pontosan egy zenei kifejezésnek kell
133 Emlékezzünk arra, hogy egy zenei kifejezés lehet egy hang is, de akár
134 egy olyan nagy összetett kifejezés is, mint:
139 @var{...egy teljes Wagner-opera zenei anyaga...}
145 Mivel mindez egy @code{@{ ... @}} blokkban szerepel, egy zenei
148 Ahogy korábban láttuk, a @code{\score} blokk a zenén kívül más definíciókat is
149 tartalmazhat, mint például:
171 Ez a három parancs -- @code{\header}, @code{\layout} és @code{\midi} --
172 speciális: az eddigi parancsokkal ellentétben @emph{nem} zenei kifejezések, és
173 nem azok részei. A @code{\score} blokkon belül vagy kívül is elhelyezkedhetnek
174 -- például a @code{\header} (fejléc) blokk, melyben a kotta adatait (pl. cím,
175 szerző stb.) lehet megadni, legtöbbször a @code{\score} parancs előtt szerepel,
176 ahogy a szakasz elején található példában is látható.
178 A két további, még ismeretlen parancs: @code{\layout @{@}} és
179 @code{\midi @{@}}. Ezek ebben a formában rendre azt jelentik, hogy a LilyPond
180 kottaképet, ill. hangzó anyagot állítson elő. Teljes leírásuk a Kottaírás
181 Kézikönyvében található, a @ruser{Score layout} és a
182 @ruser{Creating MIDI files} szakaszokban.
185 @cindex implicit book blokk
189 Egy fájlban több @code{\score} blokk lehet. Mindegyik egy-egy zeneművet
190 vagy tételt jelöl, de ezek egy kimeneti fájlban fognak megjelenni. Nem
191 szükséges @code{\book} blokkba foglalni őket -- ez implicite megtörténik.
192 Ha azonban több kimeneti fájlt szeretnénk kapni egy forrásfájlból, akkor több
193 @code{\book} blokkot kell megadnunk -- kimeneti fájlonként egyet-egyet.
197 Minden @code{\book} blokk külön kimeneti fájlt eredményez (pl. egy-egy PDF
198 állományt). Ha nem szerepel explicit módon a forráskódban, akkor a LilyPond
199 körülveszi az egész forráskódot egy @code{\book} blokkal.
201 Egy @code{\book} blokkon belül minden @code{\score} blokk különálló zenei
204 @cindex layout blokk helye
206 Minden @code{\layout} blokk arra a @code{\score} vagy @code{\book} blokkra
207 érvényes, amelyben szerepel -- tehát egy @code{\score} blokkon belüli
208 @code{\layout} blokk csakis arra az egy @code{\score} blokkra vonatkozik,
209 de egy @code{\score} blokkon kívüli @code{\layout} blokk a @code{\score}
210 blokkot tartalmazó (akár explicit, akár implicit) @code{\book} blokkon belüli
211 minden @code{\score} blokkra érvényes.
213 A részletek a @ruser{Multiple scores in a book} c. részben olvashatók.
217 Fájljainkat áttekinthetőbbé tehetjük változók definiálásával (ld.
218 @ref{Művek szervezettebbé tétele változók segítségével}). Minden sablonban ezt
219 a módszert használjuk:
222 dallam = \relative @{
231 Amikor a LilyPond feldolgozza ezt a fájlt, a @code{dallam} változó értékét
232 (azaz mindent az egyenlőségjel utáni zenei kifejezésből) beszúrja mindenhova,
233 ahol @code{\dallam} hivatkozást lát. A változók nevére nincs sok megkötés -- a
234 következők mind helyes példák: @code{dallam}, @code{jobbkéz}, @code{fuvola},
235 @code{BII} stb. A @ref{Kevesebb gépelés változókkal és függvényekkel} c.
236 szakasz további információkat tartalmaz. Mindössze annyi a korlátozás, hogy a
237 változónevek csak betűket tartalmazhatnak, és nem ütközhetnek a
238 LilyPond parancsok neveivel. A pontos szabályok a @ruser{File structure} c.
239 részben vannak leírva.
242 A bemeneti formátum teljes definíciója a
243 @ruser{File structure} c. szakaszban található.
245 @node A kotta egy összetett zenei kifejezés
246 @subsection A kotta egy összetett zenei kifejezés
247 @translationof Score is a (single) compound musical expression
248 @translationof Score is a (single) compound musical expression
253 @cindex összetett zenei kifejezés
255 Az előző szakaszban (@ref{Bevezetés a LilyPond fájlok szerkezetébe}) már láttuk
256 a LilyPond fájlok általános felépítését. De a legfontosabb részt mintha
257 átugrottuk volna: mi kerüljön a @code{\score} blokk belsejébe?
259 Valójában ez sokkal egyszerűbb, mint gondolnánk. Ez a mondat mindent
263 @emph{A @code{\score} blokknak egy összetett zenei kifejezéssel kell
268 Az összetett zenei kifejezés fogalmát már tisztáztuk
269 @ref{A zenei kifejezés fogalma} c. részben. Láttuk, hogy építhetünk fel nagy
270 zenei kifejezéseket kis részekből -- először hangokból, aztán akkordokból stb.
271 Most egy összetett zenei kifejezést vizsgálunk meg felülről lefelé. Az
272 egyszerűség kedvéért egy zongorakíséretes dal lesz a példánk. Először is
273 szükségünk van az énekes és a zongorista szólamára.
278 \new Staff = "ének" <<
280 \new PianoStaff = "zongora" <<
287 Elneveztük a két szólamot @qq{ének} és @qq{zongora} néven. Ez nem kötelező,
288 de jó szokás, hogy első pillantásra lássuk, melyik szólam mire szolgál.
290 Emlékezzünk arra, hogy @code{<< ... >>} szolgál több szólam jelölésére. Ennek
291 hatására az ének- és a zongoraszólam egymás alatt fog megjelenni a kottában.
292 A zongoraszólam két kottasort fog tartalmazni, az énekszólam pedig egy
293 kottasort és egy dalszöveget, így mindkettőhöz @code{<< ... >>} blokk kell.
294 A dalszöveghez az @code{\addlyrics} parancsot fogjuk használni. Ha szükséges
295 feleleveníteni, az @ref{Egyszerű dalok kottázása} c. részben olvashatunk róla.
297 @lilypond[verbatim,quote,ragged-right]
300 \new Staff = "ének" <<
301 \new Voice = "dallam" { c'1 }
304 \new PianoStaff = "zongora" <<
305 \new Staff = "jobbkéz" { c'1 }
306 \new Staff = "balkéz" { c'1 }
313 Most megvan a teljes struktúra. Az énekszólam egy @code{Voice} kontextust
314 tartalmaz a hangoknak, és egy versszaknyi dalszöveget. A zongoraszólam pedig
315 a jobb- és balkéz kottasorait tartalmazza.
317 Most elkezdhetjük kitölteni a hangokat. Elkezdhetnénk közvetlenül a Voice
318 kontextus belsejébe beleírni, hogy:
322 r4 d''8\noBeam g, c4 r
326 De ha ezt tennénk, a @code{\score} blokk nagyon bonyolult lenne, és nem lehetne
327 átlátni a szólamok szerkezetét. Így érdemes változókat használni. A dalszöveg
328 változóként való megadására a @code{\lyricmode} parancsot kell használni, hogy
329 a LilyPond dalszövegként és ne hangokként értelmezze a változó tartalmát.
330 (A dalszöveg egy külön beviteli mód, ezekből még több is van, ld. az
331 @ruser{Input modes} c. részt.)
333 Tehát miután definiáltuk a megfelelő változókat, hivatkoztunk rájuk, és
334 basszuskulccsal láttuk el a balkezet, kész egy valódi mű kezdete:
336 @lilypond[verbatim,quote,ragged-right]
337 dallam = \relative { r4 d''8\noBeam g, c4 r }
338 dalszöveg = \lyricmode { Szólt az Úr, }
339 jobbkéz = \relative { <g' d g,>2~ <g d g,> }
340 balkéz = \relative { b,2 e2 }
344 \new Staff = "ének" <<
345 \new Voice = "dallam" { \dallam }
346 \addlyrics { \dalszöveg }
348 \new PianoStaff = "zongora" <<
349 \new Staff = "jobbkéz" { \jobbkéz }
350 \new Staff = "balkéz" {
360 Amikor a @code{\score} blokkot írjuk vagy olvassuk, mindig lassan, gondosan
361 járjunk el. Haladjunk kívülről befelé, a magas szintű felépítéstől a részletek
362 felé haladva. Nagyban segít, ha ügyelünk a behúzásokra -- minden blokk
363 kezdődjön egy tabulátorral beljebb, így az egy szinten levő blokkok ugyanolyan
364 mértékben lesznek behúzva.
367 Referencia: @ruser{Structure of a score}.
370 @node Zenei kifejezések egymásba ágyazása
371 @subsection Zenei kifejezések egymásba ágyazása
372 @translationof Nesting music expressions
374 @cindex ideiglenes kottasorok
377 Ossiák bevitelekor jön jól, hogy kottasorok bármikor, darab közben is
378 kezdődhetnek, és bármikor végződhetnek. Álljon itt erre egy példa:
380 @lilypond[verbatim,quote,ragged-right]
397 Figyeljük meg, hogy a kulcs mérete némileg kisebb, mint a sor elején szereplő
398 kulcsé (mint ahogy kulcsváltásnál is).
400 @cindex kottasorok pozíciója
402 Az ossia a kottasor fölött is elhelyezkedhet:
404 @lilypond[verbatim,quote,ragged-right]
405 \new Staff = "main" {
412 alignAboveContext = #"main" }
420 Ebben a példában a még ismeretlen @code{\with} parancsot használtuk, amelyet
421 később ismertetünk. Most elég annyit tudni róla, hogy a kottasor bizonyos
422 tulajdonságainak módosítására szolgál. Itt egy olyan tulajdonságot adunk meg,
423 ami azt mondja, hogy az új kottasor a @qq{main} nevű kottasor felett
424 helyezkedjen el (ahelyett, hogy alatta helyezkedne el, ami az alapértelmezés).
428 Az ossiákat általában kulcs és ütemmutató nélkül, valamint kisebb méretben
429 szedjük. Ehhez további új parancsok kellenek; ld. az @ref{Size of objects} és
430 @ruser{Ossia staves} szakaszokat.
433 @node A gerendák és ívek átfedhetik egymást
434 @subsection A gerendák és ívek átfedhetik egymást
435 @translationof On the un-nestedness of brackets and ties
437 @cindex zárójeltípusok
438 @cindex zárójelek egymásba ágyazása
440 Már sok zárójelfajtával találkoztunk a LilyPond fájlok írása közben. Ezekre
441 különböző szabályok vonatkoznak, amelyeket érdemes tisztázni. Ismételjük át
445 @multitable @columnfractions .3 .7
446 @headitem Zárójelfajta
448 @item @code{@{ .. @}}
449 @tab Egymás után megszólaló hangokat tartalmaz
451 @tab Egy akkord hangjait tartalmazza
452 @item @code{<< .. >>}
453 @tab Egyszerre megszólaló zenei kifejezéseket tartalmaz
455 @tab Egy ív kezdetét és végét jelöli
456 @item @code{\( .. \)}
457 @tab Egy frazeálóív kezdetét és végét jelöli
459 @tab Egy kézi gerenda kezdetét és végét jelöli
462 A LilyPond világán kívül a különböző fajtájú zárójeleket megfelelően egymásba
463 kell ágyazni, pl. így: @code{<< [ @{ ( .. ) @} ] >>}. Tehát a záró
464 zárójeleknek pontosan fordított sorrendben kell állniuk, mint a nyitó
465 zárójeleknek. A fenti táblázatban szereplő első három típusnál (a blokkoknál)
466 ezt a LilyPond is megköveteli. A többi parancsnál ez nem követelmény.
467 Valójában ezekre nem is úgy érdemes gondolni, mint a zárójelekre, hanem olyan
468 jelzésekre, amelyek zenei elemek kezdetét és végét jelölik.
470 Tehát például egy frazeálóív kezdődhet egy kézzel megadott gerenda előtt, és
471 befejeződhet a gerenda vége előtt -- lehet, hogy nem a legzeneibb megoldás, de
474 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
475 { g8\( a b[ c b\) a] }
478 Általánosságban az ívek, frazeálóívek, kötőívek és gerendák átnyúlhatnak
479 a triolák és előkék határain. A következő példában az 1. sorban egy gerenda,
480 a 2. sorban egy kötőív nyúl bele egy triolába, a 3. és 4. sorban pedig
481 mindezek mellett még egy kötőív is található két triola között, valamint egy
482 frazeálóív, amely túlnyúlik a triolán.
484 @lilypond[quote,verbatim,fragment,ragged-right]
486 r16[ g16 \tuplet 3/2 {r16 e'8] }
487 g16( a \tuplet 3/2 {b d) e' }
488 g8[( a \tuplet 3/2 {b d') e'~]}
489 \tuplet 5/4 {e'32\( a b d' e'} a'4.\)
494 @node A szólamok zenét tartalmaznak
495 @section A szólamok zenét tartalmaznak
496 @translationof Voices contain music
498 Ahogy az énekeseknek dallamok kellenek ahhoz, hogy énekelhessenek, a LilyPondnak is szüksége van hangokra.
499 A valódi zene minden hangszer számára magában a kottában szereplő szólamokat jelenti --
500 ezek nem csak a zenének, hanem magának a LilyPondnak is alapkövei.
503 * Hangzatos szólamok::
504 * Szólamok kézi létrehozása::
505 * Szólamok és vokális zene::
508 @node Hangzatos szólamok
509 @subsection Hangzatos szólamok
510 @translationof I'm hearing Voices
515 @cindex multiple voices
516 @cindex voices, multiple
517 @cindex Voice context
518 @cindex context, Voice
519 @cindex simultaneous music
520 @cindex music, simultaneous
521 @cindex concurrent music
522 @cindex music, concurrent
523 @cindex voices vs. chords
524 @cindex chords vs. voices
526 A LilyPond kotta legalsó rétege a @q{Szólam környezet} vagy röviden @q{Szólamok}.
527 A szólamokat egyes csomagokban csak rétegeknek nevezzük.
529 Valójában a szólam környezet az egyetlen, ami zenét tartalmazhat.
530 Ha szólam környezetet nem hozunk létre, akkor automatikusan készül
531 egy, ahogy láthattuk ennek a fejezetnek az elején. Egyes hangszerek
532 -- mint az oboa is -- egy időben csak egy hangot képesek kiadni.
533 Az ilyen hangszerekre írt zenék monofonikusak és csak egyetlen hangot
534 tartalmaznak (egy időben). Azon hangszerek esetén, melyek képesek egy
535 időben több hangot is kiadni -- mint a zongora -- sokszor többszörös
536 szólamokra van szükségünk, akár különböző ütemben.
539 Egy egyszerű szólam több hangjegyet is tartalmazhat egy akkordban,
540 tehát felmerül a kérdés, hogy mikor is van szükségünk többszörös szólamra.
541 Nézzük az első példát, 4 akkorddal:
543 @lilypond[quote,verbatim,fragment,ragged-right,relative=1]
545 <d g>4 <d fis> <d a'> <d g>
548 A fenti példa leírható egyszerű, kúpos („kacsacsőr”) zárójelekkel, @code{< ... >},
549 így csak egy egyszeres szólamra volt szükségünk. De tegyük fel, hogy, hogy a FISZ
550 egy nyolcad, melyet egy másik G nyolcad követ. Ebben esetben két hangunk van,
551 mely ugyanakkor kezdődik, de különböző hanghosszúságú: a negyed D és a nyolcad FISZ.
552 Hogy írjuk ezt le? Nem írhatjuk akkordként, hiszen egy akkordban minden hang azonos
553 hosszúságú és nem írhatjuk egymást követő hangokként sem, hiszen egy időben kell
554 kezdődniük a hangoknak. Ilyenkor van szükségünk két szólamra.
558 Nézzük, hogy néz ez ki a LilyPond szintaxisában.
563 A legegyszerűbb módja olyan részek rögzítésének, amelyek több mint egy hangot
564 tartalmaznak egy szólamban, hogy szekvenciát @code{@{...@}} használunk és ezt
565 kombináljuk a szögletes zárójelekkel @code{<<...>>}.
566 Az ilyen a részeket @code{\\} segítségével kell elválasztani ahhoz, hogy különböző szólamként jelenjenek meg.
567 Az elválasztó jelek nélkül a hangok egyetlen szólamként szerepelnének, ami általában hibát okoz.
568 Ez a technika használható olyan daraboknál melyek leginkább monofonikusak és néhány részük polifón.
571 Itt egy példa, ami a fenti akkord egyik hangját két szólamra osztja és kötést is tartalmaz:
573 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
575 % 1. szólam 2. szólam
576 << { g4 fis8( g) a4 g } \\ { d4 d d d } >>
579 Vegyük észre, hogy a második hang szárai lefele mutatnak.
582 Íme egy másik egyszerű példa:
584 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
586 % 1. szólam 2. szólam
587 << { r4 g g4. a8 } \\ { d,2 d4 g } >>
588 << { bes4 bes c bes } \\ { g4 g g8( a) g4 } >>
589 << { a2. r4 } \\ { fis2. s4 } >>
592 Nem szükséges, hogy minden ütemet elválasszunk a @code{<< \\ >>} segítségével.
593 Olyan zenék esetén, ahol csak néhány hang van minden ütemben, ez a felépítés
594 segíti a kód olvashatóságát, de ha már sok hang van, akkor jobb, ha a
595 hangokat külön-külön jegyezzük le, például így:
598 @lilypond[quote,verbatim,fragment,ragged-right,relative=2]
614 @cindex voices, naming
615 @cindex voices crossing brackets
616 @cindex slurs crossing brackets
617 @cindex ties crossing brackest
620 A fenti példában csak két szólam van, de ha három vagy több szólamot kell
621 lejegyezni, azt is hasonlóan lehet megoldani visszaperjelek (back-slash) használatával.
623 A szólam környezetek nevei @code{"1"}, @code{"2"}, stb.
624 Minden ilyen környezetben a függőleges elrendezés (kötések, szárak, dinamika, stb) megfelelően jelenik meg.
627 @lilypond[quote,verbatim,fragment]
628 \new Staff \relative {
631 % 1. szólam 2. szólam 3. szólam
632 << { g4 f e } \\ { r8 e4 d c8~ } >>
633 << { d2 e2 } \\ { c8 b16 a b8 g~ g2 } \\ { s4 b4 c2 } >>
638 A fő szólamtól különválasztva jelennek meg a @code{<< .. >>} között
639 szereplő szólamok (hangok). Ezt hívjuk @emph{szimultán felépítésnek}.
640 Az átkötések és kötőívek csak az azonos szólamon belül kötik
641 össze a hangokat, tehát ezek nem kerülhetnek belülre vagy kívülre a
642 szimultán felépítéshez képest.
643 Fordítva, szimultán felépítés esetén azok a párhuzamos szólamok,
644 amelyek ugyanabban az ötvonalban vannak, egy szólamnak minősülnek.
645 Egyéb szólamhoz kapcsolódó tulajdonságok átöröklődnek a szimultán
646 felépítésbe is. Itt egy másik példa, melynél a különböző szólamokban
647 különböző színű hangok szerepelnek. Vegyük észre, hogy
648 adott szólambeli változások nincsenek hatással más szólamokra,
649 de a változtatások ugyanabban a szólamban később is érvényesek.
650 Vegyük észre azt is, hogy az összekötött hangokat szétválaszthatja
651 az ütemhatár, ahogy a kék háromszöget jelző szólamban láthatjuk:
654 @lilypond[quote,verbatim]
655 \new Staff \relative {
670 % 1. szólam folytatása
673 % 2. szólam folytatása
674 { c8 b16 a b8 g ~ g2 }
684 @funindex \voiceOneStyle
685 @funindex \voiceTwoStyle
686 @funindex \voiceThreeStyle
687 @funindex \voiceFourStyle
688 @funindex \voiceNeutralStyle
691 A @code{\voiceXXXStyle} parancsot elsősorban oktatási célra érdemes
692 használni, olyan esetben, mint amilyet ez is. Ezek a parancsok
693 módosítják a hangok színét illetve a kottafejet, a szárat, a
694 gerendákat és a hangfejek stílusát, így lesznek a szólamok könnyen felismerhetőek.
696 Az első szólam piros rombusz, a második kék háromszög, a
697 harmadik zöld áthúzott kör, a negyedik (itt nem használt) magenta kereszt.
698 A @code{\voiceNeutralStyle} (szintén nem használt a fenti példában) visszaállítja
699 a stílust az alapértelmezettre. Később az @ref{Objektumok láthatósága és színe}
700 és @ref{Változók felhasználása a finomhangoláshoz} fejezetekben majd látni fogjuk,
701 hogyan lehet hasonló parancsokat létrehozni.
704 @cindex polyphony and relative note entry
705 @cindex relative note entry and polyphony
708 A polifónia nem változtatja meg a hangjegyek viszonyát a @code{\relative @{ @}} blokkon belül.
709 Minden hangjegy helyzetét az azt megelőző hang illetve első hang helyzete határozza meg.
712 \relative c' @{ noteA << < noteB noteC > \\ noteD >> noteE @}
716 @code{noteB} is relative to @code{noteA} @*
717 @code{noteC} is relative to @code{noteB}, not @code{noteA}; @*
718 @code{noteD} is relative to @code{noteB}, not @code{noteA} or
720 @code{noteE} is relative to @code{noteD}, not @code{noteA}.
723 Van egy másik módszer, ami egyszerűbb, ha a hangjegyek a
724 szólamokon belül teljesen szét vannak választva.
725 Ezt úgy érthetjük el, hogy a @code{\relative} parancsot használjuk minden szólam kezdetén:
729 \relative c' @{ noteA ... @}
731 \relative c'' @{ < noteB noteC > ... @}
733 \relative g' @{ noteD ... @}
735 \relative c' @{ noteE ... @}
738 Végül vizsgáljuk meg a szólamokat összetettebb zene esetén.
739 Nézzük Chopin Deux Nocturne, Op 32. művének első két ütemét.
740 A továbbiakban is ezt a példát fogjuk használni arra, hogy a
741 jelölésekre használható különböző technikákat szemléltessük,
742 ezért tekintsünk el attól, hogy az alábbi kód elsőre rejtélyesnek
743 tűnhet és koncentráljunk csak a zenére és a szólamokra -- a nehezebb részeket majd a későbbi fejezetekben áttekintjük.
747 @c The following should appear as music without code
748 @lilypond[quote,ragged-right]
749 \new Staff \relative {
758 % Az alábbival nem foglalkozunk most, a 4. fejezetben megtalálhatjuk a kód magyarázatát
759 \once \override NoteColumn #'force-hshift = #0
761 \once \override NoteColumn #'force-hshift = #0.5
769 A szárak iránya gyakran jelzi két egyidejű dallamsor folytonosságát.
770 A fenti példánál a legfelső hangjegy szárai felfelé mutatnak, az alsóké mind lefelé.
771 Ez az első jelölés, amire szükségünk van több szólam lejegyzése során.
774 Leginkább viszont akkor van szükségünk többszörös szólamokra, amikor a hangok
775 ugyanakkor kezdődnek ugyan, de különböző hosszúságúak. Nézzük azt a hangot,
776 ami első ütem harmadik ütésekor kezdődik. Az ASZ egy pontozott negyed, az
777 alatta levő F egy pontozatlan negyed, a DESZ pedig egy fél hang.
778 Ezek nem írhatók le akkordként, hiszen akkord esetén minden hang azonos hosszúságú.
779 Nem írhatóak le egymást követő hangokként sem, hiszen egy időben kell kezdődniük.
780 Az ütemnek ebben a részében három szólamra van szükségünk, és normál esetben az
781 egész ütem három szólamú, ahogy az alábbi példa mutatja, ahol különböző hangjegyfejeket
782 használunk különböző színekkel a három szólamhoz. Szeretnénk ismét kihangsúlyozni, hogy
783 az alábbi példa mögötti kódot később elmagyarázzuk, most csak hagyjuk figyelmen kívül
784 azokat a részeket, amik nem érthetőek.
787 @c The following should appear as music without code
788 @c The three voice styles should be defined in -init
789 @lilypond[quote,ragged-right]
790 \new Staff \relative {
801 \\ % Nincs 3. szólam (a hangjegyek szárait lefele szeretnénk)
804 % Az alábbival nem foglalkozunk most, a 4. fejezetben megtalálhatjuk a kód magyarázatát
805 \once \override NoteColumn #'force-hshift = #0
807 \once \override NoteColumn #'force-hshift = #0.5
815 Kezdjük a legelején a fenti zene kódolását.
816 Látni fogjuk, hogy beleütközünk majd több problémába is (de ez ne keserítsen el minket, a lényeg, hogy ezekből tanulunk :) ).
817 Kezdjük azzal, amit tanultunk: a @code{<< \\ >>} használatával.
818 Gépeljük be a három szólam első ütemét:
820 @lilypond[quote,verbatim,fragment,ragged-right]
821 \new Staff \relative {
824 { c''2 aes4. bes8 } \\ { aes2 f4 fes } \\ { <ees c>2 des2 }
831 @cindex voices and stem directions
832 @cindex stem directions and voices
836 A szárak iránya automatikusan hozzárendelődik a szólamokhoz, a páratlan-sorszámú szólamoknál
837 felfelé, a párosoknál lefelé. Az első és második szólamhoz tartozó hangok szárai megfelelőek,
838 de a harmadik szólamban a száraknak lefelé kellene állniuk. Ezt úgy javíthatjuk, hogy a
839 harmadik szólamot átugorjuk (üresen hagyjuk) és a negyedik szólamba helyezzük az eredetileg harmadik szólamot.
840 Ezt egyszerűen megtehetjük a @code{\\} segítségével:
843 @lilypond[quote,verbatim,fragment,ragged-right]
844 \new Staff \relative {
850 \\ % 3. szólam - elhagyjuk
859 Látjuk, hogy ez megoldotta a problémát a szárak irányával kapcsolatban,
860 de előhozott egy másikat, ami többszörös szólamoknál néha előfordul --
861 a hangok szárai a szólamon belül ütköznek más kottafejekkel más szólamokban.
862 A hangok megtervezéséhez a LilyPond lehetővé teszi, hogy hangok illetve akkordok esetén, két hang ugyanazt a függőleges pozíciót foglalja el akár ellentétes szárirány esetén, viszont figyelembe veszi azt, hogy bizonyos esetekben a harmadik és a negyedik szólam elmozdulhat, ezzel elkerülve azt, hogy a kottafejek egymást fedjék. Ez általában működik, de a fenti példában egyértelmű, hogy az alacsonyabb szólamok alapértelmezetten nem jól helyezkednek el. Jelenleg még nem vagyunk készen rá, hogy ezt kijavítsuk, úgyhogy most ezt érintetlenül hagyjuk és visszatérünk rá egy későbbi fejezetben -- lásd @code{force-hshift} tulajdonság az @ref{Egymást átfedő jelek javítása} fejezetben.
866 A kottaírás kézikönyve:
867 @ruser{Multiple voices}.
870 @node Szólamok kézi létrehozása
871 @subsection Szólamok kézi létrehozása
872 @translationof Explicitly instantiating voices
879 @funindex \voiceThree
886 @cindex voice contexts, creating
888 A @code{<< >>} blokkon belül is létrehozhatunk polifón zenét és ha szükséges,
889 a @code{\voiceOne} ... @code{\voiceFour} parancsokkal jelezhetjük a szárak, ívek, stb irányát.
890 Hosszabb kották esetén ez a módszer átláthatóbb, mert így külön-külön írhatjuk a szólamokat és beszédesebb neveket is adhatunk nekik.
892 Konkrétan a @code{<< \\ >>}szerkezet, amit az előző fejezetben használtunk:
897 << @{ e'4 f g a @} \\ @{ c,4 d e f @} >>
903 egyenértékű az alábbival:
907 \new Voice = "1" @{ \voiceOne \relative @{ e'4 f g a @} @}
908 \new Voice = "2" @{ \voiceTwo \relative @{ c'4 d e f @} @}
912 Mindkét fenti esetben az alábbi kottát kapjuk
914 @c The following example should not display the code
915 @lilypond[ragged-right,quote]
917 \new Voice = "1" { \voiceOne \relative { e'4 f g a } }
918 \new Voice = "2" { \voiceTwo \relative { c'4 d e f } }
922 @cindex voices, reverting to single
923 @cindex reverting to a single voice
926 A @code{\voiceXXX} parancs meghatározza a szárak irányát, az
927 átkötéseket, a kötőíveket, az artikulációt, a szöveges magyarázatokat,
928 a pontozott hangokat és az ujjrendet. A @code{\voiceOne} és a @code{\voiceThree}
929 hatására a mutató elemek felfele mutatnak, míg a @code{\voiceTwo} és a
930 @code{\voiceFour} esetén lefelé. Ezen parancsok ha szükséges vízszintes
931 eltolást is létrehoznak minden szólam esetén, hogy elkerüljék a kottafejek
932 ütközését. A @code{\oneVoice} parancs visszaállítja a beállításokat a normál egyszeres szólamra.
935 Nézzünk egy egyszerű példát arra, hogy a @code{\oneVoice}, @code{\voiceOne} és @code{\voiceTwo}
936 parancsok milyen hatással vannak a jelzésekre, ívekre illetve dinamikára:
938 @lilypond[quote,ragged-right,verbatim]
940 % Alapértelmezett viselkedés vagy viselkedés \oneVoice után
941 c d8~ d e4( f g a) b-> c
945 @lilypond[quote,ragged-right,verbatim]
948 c d8~ d e4( f g a) b-> c
950 c, d8~ d e4( f g a) b-> c
954 @lilypond[quote,ragged-right,verbatim]
957 c d8~ d e4( f g a) b-> c
959 c, d8~ d e4( f g a) b-> c
963 Nézzük végig a három különböző lejegyzési módját ugyanannak a polifón dallamnak,
964 és vizsgáljuk meg melyik milyen esetben előnyös, használva az előző fejezetbeli példát.
967 A @code{<< >>} közt található kifejezés a főszólamhoz tartozik (jegyezzük meg, hogy a @code{<< >>} használata során ez @strong{nem} igaz).
968 Ez akkor hasznos, amikor további szólamok jelennek meg a főszólam mellett. Egy helyesebb megvalósítása a példánknak alább látható.
969 The red diamond-shaped notes demonstrate that the main melody is now in a single voice context,
970 permitting a phrasing slur to be drawn over them.
972 @lilypond[quote,ragged-right,verbatim]
973 \new Staff \relative {
975 % A következő hangok monofónok
977 % Szimultán rész három szólammal
979 % Continue the main voice in parallel
980 { g4 f e | d2 e2) | }
981 % Initiate second voice
983 % Set stems, etc., down
985 r8 e4 d c8~ | c8 b16 a b8 g~ g2 |
987 % Initiate third voice
997 @cindex nesting music expressions
998 @cindex nesting simultaneous constructs
999 @cindex nesting voices
1000 @cindex voices, temporary
1001 @cindex voices, nesting
1003 Létrehozhatunk többszörösen beágyazott polifón szerkezetet is, és ha a szólamok rövidek, az alábbi módon természetesebbnek tűnik a leírásuk:
1005 @lilypond[quote,ragged-right,verbatim]
1006 \new Staff \relative {
1009 { g4 f e | d2 e2) | }
1014 { c8 b16 a b8 g~ g2 }
1025 @cindex spacing notes
1027 A szólamokat akkor érdemes így írni, ha a zene csak egy kis része polifón. Viszont amikor az egész ötvonalas kotta nagyrésze polifón, egyszerűbb, ha többszörös szólamokat használunk mindenütt, -- ritkított hangokkal, hogy átlépjük azokat a részeket, ahol a szólamok üresek. Az alábbi példa ezt mutatja:
1029 @lilypond[quote,ragged-right,verbatim]
1030 \new Staff \relative <<
1031 % Initiate first voice
1034 c'16^( d e f g4 f e | d2 e2) |
1036 % Initiate second voice
1038 % Set stems, etc, down
1040 s4 r8 e4 d c8~ | c8 b16 a b8 g~ g2 |
1042 % Initiate third voice
1044 % Set stems, etc, up
1051 @subsubheading Hangoszlopok
1054 @cindex note collisions
1055 @cindex collisions, notes
1056 @cindex shift commands
1063 @funindex \shiftOnnn
1067 Egymáshoz közel elhelyezkedő, különböző szólamban levő hangok esetén
1068 kettő, esetenként több oszlopba rendezzük a hangokat, hogy a kottafejek
1069 fedését elkerüljük. Ezeket hangoszlopoknak hívjuk. Különálló oszlopokat
1070 hozunk létre minden szólamhoz és az éppen aktuális szólam-független eltolást
1071 minden oszlopra alkalmazzuk, ezzel elkerülve az ütközéseket. A fenti példában
1072 is ezt láthatjuk. A 2. ütemben a C a kettes szólamban eltolódik a D-tól jobbra
1073 (ami az első szólamban van) és a végső C akkord a hármas szólamban szintén eltolódik jobbra a többi hangtól.
1075 A @code{\shiftOn}, @code{\shiftOnn}, @code{\shiftOnnn}, és
1076 @code{\shiftOff} parancsok meghatározzák, hogy melyik hangot vagy akkordot milyen mértékben kell megemelnünk ahhoz, hogy az ütközést elkerüljük. Alapértelmezett esetben, a külső szólamokban (az egyes és a kettes szólamban) a @code{\shiftOff} érvényes, amíg a köztes szólamokban (hármas és négyes) a @code{\shiftOn}. Eltolás esetén az egyes és a hármas szólam jobbra a kettes és a négyes balra tolódik
1079 A @code{\shiftOnn} és @code{\shiftOnnn} további eltolási szinteket
1080 határoznak meg, melyek összetett esetekben ideiglenesen szükségesek
1081 lehetnek ahhoz, hogy elkerüljük az ütközéseket – lásd @ref{Valós zenei példa}.
1083 Egy hangoszlop egyszerre csak egy hangot (vagy akkordot) tartalmazhat egy szólamból
1084 szárral felfelé és egy másikat szárral lefelé. Ha két különböző szólambeli hang
1085 azonos irányú szárral kerül ugyanabba a pozícióba és egyik szólamban sincs eltolás
1086 vagy ugyanazt az eltolást adjuk meg, akkor a @qq{Too many clashing note columns} hibaüzenetet kapjuk.
1090 A kottaírás kézikönyve:
1091 @ruser{Multiple voices}.
1094 @node Szólamok és vokális zene
1095 @subsection Szólamok és vokális zene
1096 @translationof Voices and vocals
1098 A vokális zene speciális nehézséget jelent: két kifejezést kell egyesíteni -- hangokat és a szöveget.
1100 @funindex \new Lyrics
1104 @cindex Lyrics context, creating
1105 @cindex lyrics, linking to voice
1107 Korábban már találkoztunk a @code{\addlyrics@{@}} paranccsal, ami
1108 az egyszerű kottákhoz elegendő. Azonban ez a módszer eléggé korlátolt.
1109 Bonyolultabb zene esetén, muszáj bevezetni a @code{Lyrics}
1110 környezetet a @code{\new Lyrics} paranccsal és közvetlenül összekötni a
1111 dalszöveget a hangjegyekkel. A @code{\lyricsto@{@}} parancs használatával
1112 hozzárendelhetjük a szöveget a megfelelő szólamhoz.
1114 @lilypond[quote,verbatim,fragment]
1116 \new Voice = "one" \relative {
1119 c''4 b8. a16 g4. f8 e4 d c2
1121 \new Lyrics \lyricsto "one" {
1122 No more let sins and sor -- rows grow.
1127 Megjegyzés: a dalszövegnek egy @code{Voice} környezethez kell kapcsolódnia,
1128 @emph{nem} @code{Staff} környezethez. Ez egy olyan eset, amikor
1129 muszáj közvetlenül készíteni @code{Staff} és @code{Voice} környezetet is.
1131 @cindex lyrics and beaming
1132 @cindex beaming and lyrics
1133 @funindex \autoBeamOff
1134 @funindex autoBeamOff
1136 Az automatikus gerendázás -, amit a LilyPond használ - jól működik
1137 a hangszeres zenére, de nem túl jó a dalszövegek esetén,
1138 amikor előfordul, hogy nincs is szükség gerendákra vagy ha épp melizmát jeleznénk a dalszövegben.
1139 A fenti példában az @code{\autoBeamOff} paranccsal kikapcsoltuk az automatikus gerendázást.
1141 @funindex \new ChoirStaff
1142 @funindex ChoirStaff
1143 @funindex \lyricmode
1145 @cindex vocal score structure
1148 A korábbi Judas Maccabæus példát használva
1149 nézzünk meg egy rugalmasabb módszert. Először írjuk újra
1150 változók használatával, így a zene és a dalszöveg a kotta struktúrájától
1151 különválik. Vezessünk be egy kottasorcsoportot, mely kórusszólamokat fog össze
1153 A dalszöveget magát egy @code{\lyricmode} paranccsal
1154 vezetjük be, ezzel biztosítva, hogy dalszövegként és
1155 ne zeneként legyen értelmezve.
1157 @lilypond[quote,verbatim]
1158 global = { \time 6/8 \partial 8 \key f \major}
1159 SopOneMusic = \relative {
1160 c''8 | c([ bes)] a a([ g)] f | f'4. b, | c4.~ 4 | }
1161 SopTwoMusic = \relative {
1162 r8 | r4. r4 c'8 | a'([ g)] f f([ e)] d | e([ d)] c bes' | }
1163 SopOneLyrics = \lyricmode {
1164 Let | flee -- cy flocks the | hills a -- dorn, __ | }
1165 SopTwoLyrics = \lyricmode {
1166 Let | flee -- cy flocks the | hills a -- dorn, | }
1171 \new Voice = "SopOne" {
1175 \new Lyrics \lyricsto "SopOne" {
1180 \new Voice = "SopTwo" {
1184 \new Lyrics \lyricsto "SopTwo" {
1192 Ilyen az alapvető felépítése, struktúrája minden vokális zenének. Olykor több kottasor
1193 szükséges vagy több szólam van egy-egy kottasorban, esetleg több versszakból áll a dalszöveg.
1194 A változók, amik a zenét tartalmazzák, könnyen külön fájlokba is rendezhetők, ha túl hosszúak lennének.
1196 @cindex hymn structure
1197 @cindex SATB structure
1198 @cindex vocal scores with multiple verses
1199 @cindex multiple vocal verses
1200 @cindex versszakok, multiple vocal
1202 Itt egy példa egy egyházi ének első sorára, aminek négy
1203 verszaka van, és négyszólamú kórusra íródott. Ebben az esetben a szavak mind a négy
1204 szólamra azonosak. Figyeljük meg, hogyan használjuk a változókat arra,
1205 hogy különválasszuk a kottát és a szavakat a kotta felépítésétől.
1206 Figyeljük meg, hogy a @q{TimeKey} nevű változó számos parancsot tartalmaz,
1207 melyet mindkét kottasorban felhasználunk!
1208 Más példákban ez a közös változó gyakran @q{global} néven szerepel.
1210 @lilypond[quote,verbatim]
1211 TimeKey = { \time 4/4 \partial 4 \key c \major}
1212 SopMusic = \relative { c'4 | e4. e8 g4 g | a a g | }
1213 AltoMusic = \relative { c'4 | c4. c8 e4 e | f f e | }
1214 TenorMusic = \relative { e4 | g4. g8 c4. b8 | a8 b c d e4 | }
1215 BassMusic = \relative { c4 | c4. c8 c4 c | f8 g a b c4 | }
1216 VerseOne = \lyricmode {
1217 E -- | ter -- nal fa -- ther, | strong to save, | }
1218 VerseTwo = \lyricmode {
1219 O | Christ, whose voice the | wa -- ters heard, | }
1220 VerseThree = \lyricmode {
1221 O | Ho -- ly Spi -- rit, | who didst brood | }
1222 VerseFour = \lyricmode {
1223 O | Tri -- ni -- ty of | love and pow'r | }
1229 \new Voice = "Sop" { \voiceOne \TimeKey \SopMusic }
1230 \new Voice = "Alto" { \voiceTwo \AltoMusic }
1231 \new Lyrics \lyricsto "Sop" { \VerseOne }
1232 \new Lyrics \lyricsto "Sop" { \VerseTwo }
1233 \new Lyrics \lyricsto "Sop" { \VerseThree }
1234 \new Lyrics \lyricsto "Sop" { \VerseFour }
1238 \new Voice = "Tenor" { \voiceOne \TimeKey \TenorMusic }
1239 \new Voice = "Bass" { \voiceTwo \BassMusic }
1245 @cindex versszakok és refrének
1247 A példát azzal fejezzük be, hogy megmutatjuk hogyan lehet egy olyan versszakot,
1248 ami kétféle refrénnel folytatódik, két ötvonalas kottában leírni.
1249 Az egymást követő (szekvenciális) és egyidejű (szimultán) részek leírása
1250 egy kottán belül elég trükkös, úgyhogy a magyarázatot óvatosan kövessük!
1252 Kezdjük egy score blokkal, ami tartalmaz egy @code{ChoirStaff}-ot,
1253 úgy beágyazva, ahogy szeretnénk, hogy látszódjon a kórusrész kezdetén.
1254 Alapesetben szükség lenne hegyes zárójelekre ( << és >> ) a @code{\new ChoirStaff} után,
1255 hogy minden kottasor párhuzamos legyen, de most itt el szeretnénk kerülni a
1256 párhuzamosságot a szóló résznél, ezért zárójeleket használunk - bár a
1257 hegyes zárójelek nem árthatnak. A @code{ChoirStaff}-on belül először szerepeljen az
1258 a kottasor, ami a versszakot tartalmazni fogja. Hangokat és dalszöveget kell párhuzamosan tartalmaznia,
1259 tehát szükség lesz hegyes zárójelre a @code{\new Voice} és @code{\new Lyrics} esetén, hogy egy időben kezdődjenek:
1261 @lilypond[quote,verbatim,ragged-right]
1262 versszakhangok = \relative {
1269 szoveg = \lyricmode {
1270 One two three four five six
1275 \new Voice = "versszak" {
1276 \versszakhangok \break
1278 \new Lyrics \lyricsto "versszak" {
1286 Ezzel kész a verssor.
1288 Folytatni szeretnénk a refrenA-val ugyanabban az ötvonalas kottában, míg
1289 a második ötvonal ezzel párhuzamosan lenne a refrenB-nek, tehát
1290 ez egy párhuzamos rész, ami rögtön a @code{\break} után jön a "versszak" nevű szólamban.
1291 Igen, a a "versszak" nevű szólamon @emph{belül}! Íme a párhuzamos rész. Több kottasort
1292 írhatunk hasonló módon.
1297 \new Lyrics \lyricsto versszak @{
1301 \new Voice = "refrenB" @{
1304 \new Lyrics \lyricsto "refrenB" @{
1311 Itt a végső eredmény két kottasorral a kórusban, mutatva a verse Voice-on belül pozicionált
1314 @lilypond[quote,verbatim, ragged-right]
1315 versszakhangok = \relative {
1321 refrenhangokA = \relative {
1323 c'' c | g g \bar "|."
1325 refrenhangokB = \relative {
1330 szoveg = \lyricmode {
1331 One two three four five six
1333 refrenszovegA = \lyricmode {
1336 refrenszovegB = \lyricmode {
1342 \new Voice = "versszak" {
1343 \versszakhangok \break
1346 \new Lyrics \lyricsto "versszak" {
1350 \new Voice = "refrenB" {
1353 \new Lyrics \lyricsto "refrenB" {
1359 \new Lyrics \lyricsto "versszak" {
1367 @cindex book, example of using
1371 Habár ez egy érdekes és hasznos példa arra, hogy megértsük, hogyan működnek
1372 az egymásutáni és egyidejű blokkok, gyakorlatban valószínűleg a többség ezt két
1373 @code{\score} blokként írná meg egy implicit @code{\book} blokkon belül, valahogy így:
1376 @lilypond[quote,verbatim,ragged-right]
1377 versenotes = \relative {
1383 refrainnotesA = \relative {
1385 c'' c | g g \bar "|."
1387 refrainnotesB = \relative {
1392 versewords = \lyricmode {
1393 One two three four five six
1395 refrainwordsA = \lyricmode {
1398 refrainwordsB = \lyricmode {
1403 \new Voice = "verse" {
1406 \new Lyrics \lyricsto "verse" {
1415 \new Voice = "refrainA" {
1418 \new Lyrics \lyricsto "refrainA" {
1423 \new Voice = "refrainB" {
1426 \new Lyrics \lyricsto "refrainB" {
1436 A kottaírás kézikönyve:
1437 @ruser{Vocal music}.
1440 @node Kontextusok és ábrázolók
1441 @section Kontextusok és ábrázolók
1442 @translationof Contexts and engravers
1445 Kontextusok és ábrázolók korábban említésre kerültek; viszont most részletesebben
1446 foglalkozunk a fogalommal, mivel ezeket használhatjuk a LilyPond kimeneti eredményének finomhangolására.
1450 * A kontextus fogalma::
1451 * Kontextusok létrehozása::
1452 * Az ábrázoló fogalma::
1453 * Kontextusok tulajdonságainak módosítása::
1454 * Ábrázolók hozzáadása és eltávolítása::
1457 @node A kontextus fogalma
1458 @subsection A kontextus fogalma
1459 @translationof Contexts explained
1461 @cindex contexts explained
1463 When music is printed, many notational elements which do not
1464 appear explicitly in the input file must be added to the
1465 output. For example, compare the input and output of the
1468 @lilypond[quote,verbatim,relative=2,fragment]
1472 The input is rather sparse, but in the output, bar lines,
1473 accidentals, clef, and time signature have been added. When
1474 LilyPond @emph{interprets} the input the musical information
1475 is parsed from left to right, similar to the way a performer
1476 reads the score. While reading the input, the program remembers
1477 where measure boundaries are, and which pitches require explicit
1478 accidentals. This information must be held on several levels.
1479 For example, an accidental affects only a single staff, while
1480 a bar line must be synchronized across the entire score.
1482 Within LilyPond, these rules and bits of information are grouped in
1483 @emph{Contexts}. We have already introduced the @code{Voice} context.
1484 Others are the @code{Staff} and @code{Score} contexts. Contexts are
1485 hierarchical to reflect the hierarchical nature of a musical score.
1486 For example: a @code{Staff} context can contain many @code{Voice}
1487 contexts, and a @code{Score} context can contain many @code{Staff}
1491 @sourceimage{context-example,5cm,,}
1494 Each context has the responsibility for enforcing some notation rules,
1495 creating some notation objects and maintaining the associated
1496 properties. For example, the @code{Voice} context may introduce an
1497 accidental and then the @code{Staff} context maintains the rule to
1498 show or suppress the accidental for the remainder of the measure.
1500 As another example, the synchronization of bar lines is, by default,
1501 handled in the @code{Score} context.
1502 However, in some music we may not want the bar lines to be
1503 synchronized -- consider a polymetric score in 4/4 and 3/4 time.
1504 In such cases, we must modify the default settings of the
1505 @code{Score} and @code{Staff} contexts.
1507 For very simple scores, contexts are created implicitly, and you need
1508 not be aware of them. For larger pieces, such as anything with more
1509 than one staff, they must be
1510 created explicitly to make sure that you get as many staves as you
1511 need, and that they are in the correct order. For typesetting pieces
1512 with specialized notation, it is usual to modify existing, or
1513 even to define totally new, contexts.
1515 In addition to the @code{Score,} @code{Staff} and
1516 @code{Voice} contexts there are contexts which fit between
1517 the score and staff levels to control staff groups, such as the
1518 @code{PianoStaff} and @code{ChoirStaff} contexts. There
1519 are also alternative staff and voice contexts, and contexts for
1520 lyrics, percussion, fret boards, figured bass, etc.
1522 The names of all context types are formed from one or more
1523 words, each word being capitalized and joined immediately to the
1524 preceding word with no hyphen or underscore, e.g.,
1525 @code{GregorianTranscriptionStaff}.
1529 A kottaírás kézikönyve:
1530 @ruser{A kontextus fogalma}.
1533 @node Kontextusok létrehozása
1534 @subsection Kontextusok létrehozása
1535 @translationof Creating contexts
1540 @cindex new contexts
1541 @cindex creating contexts
1542 @cindex contexts, creating
1544 In an input file a score block, introduced with a @code{\score}
1545 command, contains a single music expression and an associated
1546 output definition (either a @code{\layout} or a @code{\midi} block).
1547 The @code{Score} context is usually left to be created automatically
1548 when the interpretation of that music expression starts.
1550 For scores with only one voice and one staff, the @code{Voice} and
1551 @code{Staff} contexts may also be left to be created automatically,
1552 but for more complex scores it is necessary to create them by hand.
1553 The simplest command that does this is @code{\new}. It is prepended
1554 to a music expression, for example
1557 \new @var{type} @var{music-expression}
1561 where @var{type} is a context name (like @code{Staff} or
1562 @code{Voice}). This command creates a new context, and starts
1563 interpreting the @var{music-expression} within that context.
1565 (Note that a @code{\new Score} command is not normally required,
1566 as the essential top-level @code{Score} context is created
1567 automatically when the music expression within the @code{\score}
1568 block is interpreted. The only reason for creating a @code{Score}
1569 context explicitly using @code{\new Score} is to introduce a
1570 @code{\with} block in which one or more score-wide default values
1571 of context properties may be specified. Information on using
1572 @code{\with} blocks can be found under the heading
1573 @qq{Setting context properties with @code{\\with} } in
1574 @ref{Kontextusok tulajdonságainak módosítása}.)
1576 You have seen many practical examples which created new
1577 @code{Staff} and @code{Voice} contexts in earlier sections, but
1578 to remind you how these commands are used in practice, here's an
1579 annotated real-music example:
1581 @lilypond[quote,verbatim,ragged-right]
1582 \score { % start of single compound music expression
1583 << % start of simultaneous staves section
1585 \new Staff { % create RH staff
1588 \new Voice { % create voice for RH notes
1589 \relative { % start of RH notes
1595 \new Staff << % create LH staff; needs two simultaneous voices
1598 \new Voice { % create LH voice one
1600 \relative { % start of LH voice one notes
1601 g8 <bes d> ees, <g c>
1602 g8 <bes d> ees, <g c>
1603 } % end of LH voice one notes
1604 } % end of LH voice one
1605 \new Voice { % create LH voice two
1607 \relative { % start of LH voice two notes
1610 } % end of LH voice two notes
1611 } % end of LH voice two
1612 >> % end of LH staff
1613 >> % end of simultaneous staves section
1614 } % end of single compound music expression
1617 (Note how all the statements which open a block with either a
1618 curly bracket, @code{@{}, or double angle brackets, @code{<<},
1619 are indented by two further spaces, and the corresponding
1620 closing bracket is indented by exactly the same amount. While
1621 this is not required, following this practice will greatly
1622 reduce the number of @q{unmatched bracket} errors, and is
1623 strongly recommended. It enables the structure of the music to
1624 be seen at a glance, and any unmatched brackets will be obvious.
1625 Note too how the LH staff is created using double angle brackets
1626 because it requires two voices for its music, whereas the RH staff
1627 is created with a single music expression surrounded by curly
1628 brackets because it requires only one voice.)
1630 @cindex contexts, naming
1631 @cindex naming contexts
1633 The @code{\new} command may also give an identifying name to the
1634 context to distinguish it from other contexts of the same type,
1637 \new @var{type} = @var{id} @var{music-expression}
1640 Note the distinction between the name of the context type,
1641 @code{Staff}, @code{Voice}, etc, and the identifying name of a
1642 particular instance of that type, which can be any sequence of letters
1643 invented by the user. Digits and spaces can also be used in the
1644 identifying name, but then it has to be placed in quotes,
1645 i.e. @code{\new Staff = "MyStaff 1" @var{music-expression}}.
1646 The identifying name is used to
1647 refer back to that particular instance of a context. We saw this in
1648 use in the section on lyrics, see @ref{Szólamok és vokális zene}.
1652 A kottaírás kézikönyve:
1653 @ruser{Kontextusok létrehozása}.
1656 @node Az ábrázoló fogalma
1657 @subsection Az ábrázoló fogalma
1658 @translationof Engravers explained
1662 Every mark on the printed output of a score produced by LilyPond
1663 is produced by an @code{Engraver}. Thus there is an engraver
1664 to print staves, one to print note heads, one for stems, one for
1665 beams, etc, etc. In total there are over 120 such engravers!
1666 Fortunately, for most scores it is not necessary to know about
1667 more than a few, and for simple scores you do not need to know
1670 Engravers live and operate in Contexts. Engravers such as the
1671 @code{Metronome_mark_engraver}, whose action and output apply to the
1672 score as a whole, operate in the highest level context -- the
1673 @code{Score} context.
1675 The @code{Clef_engraver} and @code{Key_engraver} are to be
1676 found in every @code{Staff} Context, as different staves may require
1677 different clefs and keys.
1679 The @code{Note_heads_engraver} and @code{Stem_engraver} live
1680 in every @code{Voice} context, the lowest level context of all.
1682 Each engraver processes the particular objects associated
1683 with its function, and maintains the properties that relate
1684 to that function. These properties, like the properties
1685 associated with contexts, may be modified to change the
1686 operation of the engraver or the appearance of those elements
1687 in the printed score.
1689 Engravers all have compound names formed from words which
1690 describe their function. Just the first word is capitalized,
1691 and the remainder are joined to it with underscores. Thus
1692 the @code{Staff_symbol_engraver} is responsible for creating the
1693 lines of the staff, the @code{Clef_engraver} determines and sets
1694 the pitch reference point on the staff by drawing a clef symbol.
1696 Here are some of the most common engravers together with their
1697 function. You will see it is usually easy to guess the function
1698 from the name, or vice versa.
1700 @multitable @columnfractions .3 .7
1703 @item Accidental_engraver
1704 @tab Makes accidentals, cautionary and suggested accidentals
1709 @item Completion_heads_engraver
1710 @tab Splits notes which cross bar lines
1711 @item Dynamic_engraver
1712 @tab Creates hairpins and dynamic texts
1713 @item Forbid_line_break_engraver
1714 @tab Prevents line breaks if a musical element is still active
1716 @tab Creates the key signature
1717 @item Metronome_mark_engraver
1718 @tab Engraves metronome marking
1719 @item Note_heads_engraver
1720 @tab Engraves note heads
1723 @item Staff_symbol_engraver
1724 @tab Engraves the five (by default) lines of the staff
1726 @tab Creates stems and single-stem tremolos
1727 @item Time_signature_engraver
1728 @tab Creates time signatures
1733 We shall see later how the output of LilyPond can be changed
1734 by modifying the action of Engravers.
1738 Internals reference: @rinternals{Engravers and Performers}.
1741 @node Kontextusok tulajdonságainak módosítása
1742 @subsection Kontextusok tulajdonságainak módosítása
1743 @translationof Modifying context properties
1745 @cindex context properties
1746 @cindex context properties, modifying
1747 @cindex modifying context properties
1753 Contexts are responsible for holding the values of a number of
1754 context @emph{properties}. Many of them can be changed to
1755 influence the interpretation of the input and so change the
1756 appearance of the output. They are changed by the
1757 @code{\set} command. This takes the form
1760 \set @emph{ContextName}.@emph{propertyName} = #@emph{value}
1763 Where the @emph{ContextName} is usually @code{Score},
1764 @code{Staff} or @code{Voice}. It may be omitted,
1765 in which case the current context (typically @code{Voice}) is assumed.
1767 The names of context properties consist of words joined
1768 together with no hyphens or underscores, all except the
1769 first having a capital letter. Here are a few examples
1770 of some commonly used ones. There are many more.
1772 @c attempt to force this onto a new page
1774 @multitable @columnfractions .25 .15 .45 .15
1775 @headitem propertyName
1781 @tab If true, set extra natural signs before accidentals
1782 @tab @code{#t}, @code{#f}
1783 @item currentBarNumber
1785 @tab Set the current bar number
1789 @tab If true, print slurs both above and below notes
1790 @tab @code{#t}, @code{#f}
1791 @item instrumentName
1793 @tab Set the name to be placed at the start of the staff
1794 @tab @code{"Cello I"}
1797 @tab Increase or decrease the font size
1801 @tab Set the text to print before the start of a verse
1806 where a Boolean is either True (@code{#t}) or False (@code{#f}),
1807 an Integer is a positive whole number, a Real is a positive
1808 or negative decimal number, and text is enclosed in double
1809 apostrophes. Note the occurrence of hash signs,
1810 (@code{#}), in two different places -- as part of the Boolean
1811 value before the @code{t} or @code{f}, and before @emph{value}
1812 in the @code{\set} statement. So when a Boolean is being
1813 entered you need to code two hash signs, e.g., @code{##t}.
1815 @cindex properties operating in contexts
1816 @cindex setting properties within contexts
1818 Before we can set any of these properties we need to know
1819 in which context they operate. Sometimes this is obvious,
1820 but occasionally it can be tricky. If the wrong context
1821 is specified, no error message is produced, but the expected
1822 action will not take place. For example, the
1823 @code{instrumentName} clearly lives in the @code{Staff} context, since
1824 it is the staff that is to be named.
1825 In this example the first staff is labeled, but not the second,
1826 because we omitted the context name.
1828 @lilypond[quote,verbatim,ragged-right]
1830 \new Staff \relative {
1831 \set Staff.instrumentName = #"Soprano"
1834 \new Staff \relative {
1835 \set instrumentName = #"Alto" % Wrong!
1841 Remember the default context name is @code{Voice}, so the second
1842 @code{\set} command set the property @code{instrumentName} in the
1843 @code{Voice} context to @qq{Alto}, but as LilyPond does not look
1844 for any such property in the @code{Voice} context, no
1845 further action took place. This is not an error, and no error
1846 message is logged in the log file.
1848 Similarly, if the property name is mis-spelt no error message is
1849 produced, and clearly the expected action cannot be performed. In
1850 fact, you can set any (fictitious) @q{property} using any name you
1851 like in any context that exists by using the @code{\set} command. But
1852 if the name is not known to LilyPond it will not cause any action to
1853 be taken. Some text editors with special support for LilyPond input
1854 files document property names with bullets when you hover them with
1855 the mouse, like JEdit with LilyPondTool, or highlight unknown property
1856 names differently, like ConTEXT. If you do not use an editor with
1857 such features, it is recommended to check the property name in the
1858 Internals Reference: see @rinternals{Tunable context properties}, or
1859 @rinternals{Contexts}.
1861 The @code{instrumentName} property will take effect only
1862 if it is set in the @code{Staff} context, but
1863 some properties can be set in more than one context.
1864 For example, the property @code{extraNatural} is by
1865 default set to ##t (true) for all staves.
1866 If it is set to ##f (false) in one particular @code{Staff}
1867 context it applies just to the accidentals on that staff.
1868 If it is set to false in the @code{Score} context
1869 it applies to all staves.
1871 So this turns off extra naturals in one staff:
1873 @lilypond[quote,verbatim,ragged-right]
1875 \new Staff \relative {
1878 \new Staff \relative {
1879 \set Staff.extraNatural = ##f
1886 and this turns them off in all staves:
1888 @lilypond[quote,verbatim,ragged-right]
1890 \new Staff \relative {
1893 \new Staff \relative {
1894 \set Score.extraNatural = ##f
1900 As another example, if @code{clefTransposition} is set in
1901 the @code{Score} context this immediately changes the value
1902 of the octavation in all current staves and sets a new default
1903 value which will be applied to all staves.
1905 The opposite command, @code{\unset}, effectively removes the
1906 property from the context, which causes most properties to
1907 revert to their default value. Usually @code{\unset} is not
1908 required as a new @code{\set} command will achieve what is
1911 The @code{\set} and @code{\unset} commands can appear anywhere
1912 in the input file and will take effect from the time they are
1913 encountered until the end of the score or until the property is
1914 @code{\set} or @code{\unset} again. Let's try changing the
1915 font size, which affects the size of the note heads (among
1916 other things) several times. The change is from the default
1917 value, not the most recently set value.
1919 @lilypond[quote,verbatim,ragged-right,relative=1,fragment]
1921 % make note heads smaller
1924 % make note heads larger
1925 \set fontSize = #2.5
1927 % return to default size
1932 We have now seen how to set the values of several different types of
1933 property. Note that integers and numbers are always preceded by a
1934 hash sign, @code{#}, while a true or false value is specified by
1935 @code{##t} and @code{##f}, with two hash signs. A text property
1936 should be enclosed in double quotation signs, as above, although we
1937 shall see later that text can actually be specified in a much more
1938 general way by using the very powerful @code{\markup} command.
1940 @subsubheading Setting context properties with @code{\with}
1944 @cindex context properties, setting with \with
1946 The default value of context properties may be set at the time the
1947 context is created. Sometimes this is a clearer way of setting a
1948 property value if it is to remain fixed for the duration of
1949 the context. When a context is created with a @code{\new}
1950 command it may be followed immediately by a @code{\with @{ .. @}}
1951 block in which the default property values are set. For example,
1952 if we wish to suppress the printing of extra naturals for the
1953 duration of a staff we would write:
1956 \new Staff \with @{ extraNatural = ##f @}
1962 @lilypond[quote,verbatim,ragged-right]
1968 \new Staff \with { extraNatural = ##f }
1975 Or, if the property override is to be applied to all staves
1976 within the score, it may be appended to an explicit
1977 @code{\new Score} command, like this:
1979 @lilypond[quote,verbatim,ragged-right]
1981 \new Score \with { extraNatural = ##f } <<
1996 Properties set in this way may still be changed dynamically using
1997 @code{\set} and returned to the default value set in the
1998 @code{\with} block with @code{\unset}.
2000 @cindex fontSize, default and setting
2002 So if the @code{fontSize} property is set in a @code{\with} clause
2003 it sets the default value of the font size. If it is later changed
2004 with @code{\set}, this new default value may be restored with the
2005 @code{\unset fontSize} command.
2007 @subsubheading Setting context properties with @code{\context}
2009 @cindex context properties, setting with \context
2013 The values of context properties may be set in @emph{all} contexts
2014 of a particular type, such as all @code{Staff} contexts, with a single
2015 command. The context type is identified by using its
2016 type name, like @code{Staff}, prefixed by a back-slash: @code{\Staff}.
2017 The statement which sets the property value is the same as that in a
2018 @code{\with} block, introduced above. It is placed in a
2019 @code{\context} block within a @code{\layout} block. Each
2020 @code{\context} block will affect all contexts of the type specified
2021 throughout the @code{\score} or @code{\book} block in which the
2022 @code{\layout} block appears. Here is a example to show the format:
2024 @lilypond[verbatim,quote]
2041 Context properties set in this way may be overridden for particular
2042 instances of contexts by statements in a @code{\with} block, and by
2043 @code{\set} commands embedded in music statements.
2047 A kottaírás kézikönyve:
2048 @ruser{Changing context default settings}.
2049 @ruser{The set command}.
2051 Internals Reference:
2052 @rinternals{Contexts},
2053 @rinternals{Tunable context properties}.
2056 @node Ábrázolók hozzáadása és eltávolítása
2057 @subsection Ábrázolók hozzáadása és eltávolítása
2058 @translationof Adding and removing engravers
2060 @cindex engravers, adding
2061 @cindex adding engravers
2062 @cindex engravers, removing
2063 @cindex removing engravers
2070 We have seen that contexts each contain several engravers, each
2071 of which is responsible for producing a particular part of the
2072 output, like bar lines, staves, note heads, stems, etc. If an
2073 engraver is removed from a context, it can no longer produce its
2074 output. This is a crude way of modifying the output, but it
2075 can sometimes be useful.
2077 @subsubheading Changing a single context
2079 To remove an engraver from a single context we use the
2080 @code{\with} command placed immediately after the context creation
2081 command, as in the previous section.
2083 As an illustration, let's repeat an example from the previous section
2084 with the staff lines removed. Remember that the staff lines are
2085 produced by the @code{Staff_symbol_engraver}.
2087 @lilypond[quote,verbatim,ragged-right]
2089 \remove "Staff_symbol_engraver"
2093 \set fontSize = #-4 % make note heads smaller
2095 \set fontSize = #2.5 % make note heads larger
2097 \unset fontSize % return to default size
2102 @cindex ambitus engraver
2104 Engravers can also be added to individual contexts.
2105 The command to do this is
2107 @code{\consists @var{Engraver_name}},
2110 placed inside a @code{\with} block. Some vocal scores have an ambitus
2111 placed at the beginning of a staff to indicate the range of notes in
2112 that staff -- see @rglos{ambitus}. The ambitus is produced by the
2113 @code{Ambitus_engraver}, which is not normally included in any
2114 context. If we add it to the @code{Voice} context, it calculates the
2115 range from that voice only:
2117 @lilypond[quote,verbatim,ragged-right]
2120 \consists "Ambitus_engraver"
2135 but if we add the ambitus engraver to the
2136 @code{Staff} context, it calculates the range from all
2137 the notes in all the voices on that staff:
2139 @lilypond[quote,verbatim,ragged-right]
2141 \consists "Ambitus_engraver"
2157 @subsubheading Changing all contexts of the same type
2162 The examples above show how to remove or add engravers to
2163 individual contexts. It is also possible to remove or add
2164 engravers to every context of a specific type by placing the
2165 commands in the appropriate context in a @code{\layout}
2166 block. For example, if we wanted to show an ambitus for every
2167 staff in a four-staff score, we could write
2169 @lilypond[quote,verbatim,ragged-right]
2198 \consists "Ambitus_engraver"
2205 The values of context properties may also be set
2206 for all contexts of a particular type by including the
2207 @code{\set} command in a @code{\context} block in the
2212 A kottaírás kézikönyve:
2213 @ruser{Modifying context plug-ins},
2214 @ruser{Changing context default settings}.
2217 @node A sablonok kibővítése
2218 @section A sablonok kibővítése
2219 @translationof Extending the templates
2221 You've read the tutorial, you know how to write music, you
2222 understand the fundamental concepts. But how can you
2223 get the staves that you want? Well, you can find lots of
2224 templates (see @ref{Templates}) which may give you a start.
2225 But what if you want something that isn't covered there? Read on.
2228 * Szoprán és cselló::
2229 * Négyszólamú vegyeskar::
2230 * Kotta létrehozása az alapoktól::
2231 * Kevesebb gépelés változókkal és függvényekkel::
2232 * Partitúra és szólamkották::
2235 @node Szoprán és cselló
2236 @subsection Szoprán és cselló
2237 @translationof Soprano and cello
2239 @cindex template, modifying
2240 @cindex modifying templates
2242 Start off with the template that seems closest to what you want to
2243 end up with. Let's say that you want to write something for
2244 soprano and cello. In this case, we would start with the
2245 @q{Notes and lyrics} template (for the soprano part).
2248 \version @w{"@version{}"}
2249 melody = \relative @{
2256 text = \lyricmode @{
2262 \new Voice = "one" @{
2266 \new Lyrics \lyricsto "one" \text
2273 Now we want to add a cello part. Let's look at the @q{Notes only} example:
2276 \version @w{"@version{}"}
2277 melody = \relative @{
2291 We don't need two @code{\version} commands. We'll need the
2292 @code{melody} section. We don't want two @code{\score} sections
2293 -- if we had two @code{\score}s, we'd get the two parts separately.
2294 We want them together, as a duet. Within the @code{\score}
2295 section, we don't need two @code{\layout} or @code{\midi}.
2297 If we simply cut and paste the @code{melody} section, we would
2298 end up with two @code{melody} definitions. This would not generate
2299 an error, but the second one would be used for both melodies.
2300 So let's rename them to make them distinct. We'll call the
2301 section for the soprano @code{sopranoMusic} and the section for
2302 the cello @code{celloMusic}. While we're doing this, let's rename
2303 @code{text} to be @code{sopranoLyrics}. Remember to rename both
2304 instances of all these names -- both the initial definition (the
2305 @code{melody = \relative c' @{ } part) and the name's use (in the
2306 @code{\score} section).
2308 While we're doing this, let's change the cello part's staff --
2309 celli normally use bass clef. We'll also give the cello some
2313 \version @w{"@version{}"}
2314 sopranoMusic = \relative @{
2321 sopranoLyrics = \lyricmode @{
2325 celloMusic = \relative @{
2334 \new Voice = "one" @{
2338 \new Lyrics \lyricsto "one" \sopranoLyrics
2345 This is looking promising, but the cello part won't appear in the
2346 score -- we haven't used it in the @code{\score} section. If we
2347 want the cello part to appear under the soprano part, we need to add
2350 \new Staff \celloMusic
2354 underneath the soprano stuff. We also need to add @code{<<} and
2355 @code{>>} around the music -- that tells LilyPond that there's
2356 more than one thing (in this case, two @code{Staves}) happening
2357 at once. The @code{\score} looks like this now:
2359 @c Indentation in this example is deliberately poor
2364 \new Voice = "one" @{
2368 \new Lyrics \lyricsto "one" \sopranoLyrics
2370 \new Staff \celloMusic
2378 This looks a bit messy; the indentation is messed up now. That is
2379 easily fixed. Here's the complete soprano and cello template.
2381 @lilypond[quote,verbatim,ragged-right,addversion]
2382 sopranoMusic = \relative {
2389 sopranoLyrics = \lyricmode {
2393 celloMusic = \relative {
2403 \new Voice = "one" {
2407 \new Lyrics \lyricsto "one" \sopranoLyrics
2409 \new Staff \celloMusic
2418 The starting templates can be found in the @q{Templates} appendix,
2419 see @ref{Single staff}.
2422 @node Négyszólamú vegyeskar
2423 @subsection Négyszólamú vegyeskar
2424 @translationof Four-part SATB vocal score
2426 @cindex template, SATB
2427 @cindex SATB template
2429 Most vocal scores of music written for four-part mixed choir
2430 with orchestral accompaniment such as Mendelssohn's Elijah or
2431 Handel's Messiah have the choral music and words on four
2432 staves, one for each of SATB, with a piano reduction of the
2433 orchestral accompaniment underneath. Here's an example
2434 from Handel's Messiah:
2436 @c The following should appear as music without code
2437 @lilypond[quote,ragged-right]
2438 global = { \key d \major \time 4/4 }
2439 sopranoMusic = \relative {
2441 r4 d''2 a4 | d4. d8 a2 | cis4 d cis2 |
2443 sopranoWords = \lyricmode {
2444 Wor -- thy is the lamb that was slain
2446 altoMusic = \relative {
2448 r4 a'2 a4 | fis4. fis8 a2 | g4 fis e2 |
2450 altoWords = \sopranoWords
2451 tenorMusic = \relative {
2453 r4 fis'2 e4 | d4. d8 d2 | e4 a, cis2 |
2455 tenorWords = \sopranoWords
2456 bassMusic = \relative {
2458 r4 d'2 cis4 | b4. b8 fis2 | e4 d a'2 |
2460 bassWords = \sopranoWords
2464 r4 <a' d fis>2 <a e' a>4
2465 <d fis d'>4. <d fis d'>8 <a d a'>2
2466 <g cis g'>4 <a d fis> <a cis e>2
2471 <d, d'>4 <d d'>2 <cis cis'>4
2472 <b b'>4. <b' b'>8 <fis fis'>2
2473 <e e'>4 <d d'> <a' a'>2
2477 << % combine ChoirStaff and PianoStaff in parallel
2479 \new Staff = "sopranos" <<
2480 \set Staff.instrumentName = #"Soprano"
2481 \new Voice = "sopranos" {
2486 \new Lyrics \lyricsto "sopranos" {
2489 \new Staff = "altos" <<
2490 \set Staff.instrumentName = #"Alto"
2491 \new Voice = "altos" {
2496 \new Lyrics \lyricsto "altos" { \altoWords }
2497 \new Staff = "tenors" <<
2498 \set Staff.instrumentName = #"Tenor"
2499 \new Voice = "tenors" {
2504 \new Lyrics \lyricsto "tenors" { \tenorWords }
2505 \new Staff = "basses" <<
2506 \set Staff.instrumentName = #"Bass"
2507 \new Voice = "basses" {
2512 \new Lyrics \lyricsto "basses" {
2517 \set PianoStaff.instrumentName = #"Piano"
2518 \new Staff = "upper" \upper
2519 \new Staff = "lower" \lower
2525 None of the templates provides this layout exactly. The nearest is
2526 @q{SATB vocal score and automatic piano reduction} -- see @ref{Vocal
2527 ensembles} -- but we need to change the layout and add a piano
2528 accompaniment which is not derived automatically from the vocal parts.
2529 The variables holding the music and words for the vocal parts are
2530 fine, but we shall need to add variables for the piano reduction.
2532 The order in which the contexts appear in the ChoirStaff of the
2533 template do not correspond with the order in the vocal score shown
2534 above. We need to rearrange them so there are four staves with the
2535 words written directly underneath the notes for each part. All the
2536 voices should be @code{\voiceOne}, which is the default, so the
2537 @code{\voiceXXX} commands should be removed. We also need to specify
2538 the tenor clef for the tenors. The way in which lyrics are specified
2539 in the template has not yet been encountered so we need to use the
2540 method with which we are familiar. We should also add the names of
2543 Doing this gives for our ChoirStaff:
2547 \new Staff = "sopranos" <<
2548 \set Staff.instrumentName = #"Soprano"
2549 \new Voice = "sopranos" @{
2554 \new Lyrics \lyricsto "sopranos" @{
2557 \new Staff = "altos" <<
2558 \set Staff.instrumentName = #"Alto"
2559 \new Voice = "altos" @{
2564 \new Lyrics \lyricsto "altos" @{
2567 \new Staff = "tenors" <<
2568 \set Staff.instrumentName = #"Tenor"
2569 \new Voice = "tenors" @{
2574 \new Lyrics \lyricsto "tenors" @{
2577 \new Staff = "basses" <<
2578 \set Staff.instrumentName = #"Bass"
2579 \new Voice = "basses" @{
2584 \new Lyrics \lyricsto "basses" @{
2590 Next we must work out the piano part. This is
2591 easy - we just pull out the piano part from the
2592 @q{Solo piano} template:
2596 \set PianoStaff.instrumentName = #"Piano "
2597 \new Staff = "upper" \upper
2598 \new Staff = "lower" \lower
2602 and add the variable definitions for @code{upper}
2605 The ChoirStaff and PianoStaff must be combined
2606 using angle brackets as we want them to be
2607 stacked one above the other:
2610 << % combine ChoirStaff and PianoStaff one above the other
2612 \new Staff = "sopranos" <<
2613 \new Voice = "sopranos" @{
2618 \new Lyrics \lyricsto "sopranos" @{
2621 \new Staff = "altos" <<
2622 \new Voice = "altos" @{
2627 \new Lyrics \lyricsto "altos" @{
2630 \new Staff = "tenors" <<
2631 \clef "G_8" % tenor clef
2632 \new Voice = "tenors" @{
2637 \new Lyrics \lyricsto "tenors" @{
2640 \new Staff = "basses" <<
2642 \new Voice = "basses" @{
2647 \new Lyrics \lyricsto "basses" @{
2653 \set PianoStaff.instrumentName = #"Piano"
2654 \new Staff = "upper" \upper
2655 \new Staff = "lower" \lower
2660 Combining all these together and adding the music
2661 for the three bars of the example above gives:
2663 @lilypond[quote,verbatim,ragged-right,addversion]
2668 sopranoMusic = \relative {
2670 r4 d''2 a4 | d4. d8 a2 | cis4 d cis2 |
2672 sopranoWords = \lyricmode {
2673 Wor -- thy is the lamb that was slain
2675 altoMusic = \relative {
2677 r4 a'2 a4 | fis4. fis8 a2 | g4 fis fis2 |
2679 altoWords = \sopranoWords
2680 tenorMusic = \relative {
2682 r4 fis'2 e4 | d4. d8 d2 | e4 a, cis2 |
2684 tenorWords = \sopranoWords
2685 bassMusic = \relative {
2687 r4 d'2 cis4 | b4. b8 fis2 | e4 d a'2 |
2689 bassWords = \sopranoWords
2693 r4 <a' d fis>2 <a e' a>4
2694 <d fis d'>4. <d fis d'>8 <a d a'>2
2695 <g cis g'>4 <a d fis> <a cis e>2
2700 <d, d'>4 <d d'>2 <cis cis'>4
2701 <b b'>4. <b' b'>8 <fis fis'>2
2702 <e e'>4 <d d'> <a' a'>2
2706 << % combine ChoirStaff and PianoStaff in parallel
2708 \new Staff = "sopranos" <<
2709 \set Staff.instrumentName = #"Soprano"
2710 \new Voice = "sopranos" {
2715 \new Lyrics \lyricsto "sopranos" {
2718 \new Staff = "altos" <<
2719 \set Staff.instrumentName = #"Alto"
2720 \new Voice = "altos" {
2725 \new Lyrics \lyricsto "altos" {
2728 \new Staff = "tenors" <<
2729 \set Staff.instrumentName = #"Tenor"
2730 \new Voice = "tenors" {
2735 \new Lyrics \lyricsto "tenors" {
2738 \new Staff = "basses" <<
2739 \set Staff.instrumentName = #"Bass"
2740 \new Voice = "basses" {
2745 \new Lyrics \lyricsto "basses" {
2751 \set PianoStaff.instrumentName = #"Piano "
2752 \new Staff = "upper" \upper
2753 \new Staff = "lower" \lower
2760 @node Kotta létrehozása az alapoktól
2761 @subsection Kotta létrehozása az alapoktól
2762 @translationof Building a score from scratch
2764 @cindex template, writing your own
2765 @cindex example of writing a score
2766 @cindex writing a score, example
2767 @cindex score, example of writing
2769 After gaining some facility with writing LilyPond code, you
2770 may find that it is easier to build a score from scratch
2771 rather than modifying one of the templates. You can also
2772 develop your own style this way to suit the sort of music you
2773 like. Let's see how to put together the score for an organ
2774 prelude as an example.
2776 We begin with a header section. Here go the title, name
2777 of composer, etc, then come any variable definitions, and
2778 finally the score block. Let's start with these in outline
2779 and fill in the details later.
2781 We'll use the first two bars of Bach's prelude
2782 based on @emph{Jesu, meine Freude} which is written for two
2783 manuals and pedal organ. You can see these two bars of music
2784 at the bottom of this section. The top manual part has two voices,
2785 the lower and pedal organ one each. So we need four
2786 music definitions and one to define the time signature
2790 \version @w{"@version{}"}
2792 title = "Jesu, meine Freude"
2793 composer = "J S Bach"
2799 ManualOneVoiceOneMusic = @{ s1 @}
2800 ManualOneVoiceTwoMusic = @{ s1 @}
2801 ManualTwoMusic = @{ s1 @}
2802 PedalOrganMusic = @{ s1 @}
2808 For now we've just used a spacer note, @code{s1},
2809 instead of the real music. We'll add that later.
2811 Next let's see what should go in the score block.
2812 We simply mirror the staff structure we want.
2813 Organ music is usually written on three staves,
2814 one for each manual and one for the pedals. The
2815 manual staves should be bracketed together, so we
2816 need to use a PianoStaff for them. The first
2817 manual part needs two voices and the second manual
2822 \new Staff = "ManualOne" <<
2824 \ManualOneVoiceOneMusic
2827 \ManualOneVoiceTwoMusic
2829 >> % end ManualOne Staff context
2830 \new Staff = "ManualTwo" <<
2834 >> % end ManualTwo Staff context
2835 >> % end PianoStaff context
2838 Next we need to add a staff for the pedal organ.
2839 This goes underneath the PianoStaff, but it must
2840 be simultaneous with it, so we need angle brackets
2841 around the two. Missing these out would generate
2842 an error in the log file. It's a common mistake
2843 which you'll make sooner or later! Try copying
2844 the final example at the end of this section,
2845 remove these angle brackets, and compile it to
2846 see what errors it generates.
2849 << % PianoStaff and Pedal Staff must be simultaneous
2851 \new Staff = "ManualOne" <<
2853 \ManualOneVoiceOneMusic
2856 \ManualOneVoiceTwoMusic
2858 >> % end ManualOne Staff context
2859 \new Staff = "ManualTwo" <<
2863 >> % end ManualTwo Staff context
2864 >> % end PianoStaff context
2865 \new Staff = "PedalOrgan" <<
2873 It is not necessary to use the simultaneous construct
2874 @code{<< .. >>} for the manual two staff and the pedal organ staff,
2875 since they contain only one music expression, but it does no harm,
2876 and always using angle brackets after @code{\new Staff} is a good
2877 habit to cultivate in case there are multiple voices. The opposite
2878 is true for Voices: these should habitually be followed by braces
2879 @code{@{ .. @}} in case your music is coded in several variables
2880 which need to run consecutively.
2882 Let's add this structure to the score block, and adjust the indenting.
2883 We also add the appropriate clefs, ensure stems, ties and slurs in
2884 each voice on the upper staff point to the right direction with
2885 @code{\voiceOne} and @code{\voiceTwo}, and enter the time signature
2886 and key to each staff using our predefined variable, @code{\TimeKey}.
2890 << % PianoStaff and Pedal Staff must be simultaneous
2892 \new Staff = "ManualOne" <<
2893 \TimeKey % set time signature and key
2897 \ManualOneVoiceOneMusic
2901 \ManualOneVoiceTwoMusic
2903 >> % end ManualOne Staff context
2904 \new Staff = "ManualTwo" <<
2910 >> % end ManualTwo Staff context
2911 >> % end PianoStaff context
2912 \new Staff = "PedalOrgan" <<
2918 >> % end PedalOrgan Staff
2920 @} % end Score context
2923 That completes the structure. Any three-staff organ music
2924 will have a similar structure, although the number of voices
2925 may vary. All that remains now
2926 is to add the music, and combine all the parts together.
2928 @lilypond[quote,verbatim,ragged-right,addversion]
2930 title = "Jesu, meine Freude"
2931 composer = "J S Bach"
2937 ManualOneVoiceOneMusic = \relative {
2941 ManualOneVoiceTwoMusic = \relative {
2942 ees'16 d ees8~ 16 f ees d c8 d~ d c~
2943 c c4 b8 c8. g16 c b c d
2945 ManualTwoMusic = \relative {
2946 c'16 b c8~ 16 b c g a8 g~ 16 g aes ees
2947 f ees f d g aes g f ees d e8~ 8es16 f ees d
2949 PedalOrganMusic = \relative {
2950 r8 c16 d ees d ees8~ 16 a, b g c b c8
2951 r16 g ees f g f g8 c,2
2955 << % PianoStaff and Pedal Staff must be simultaneous
2957 \new Staff = "ManualOne" <<
2958 \TimeKey % set time signature and key
2962 \ManualOneVoiceOneMusic
2966 \ManualOneVoiceTwoMusic
2968 >> % end ManualOne Staff context
2969 \new Staff = "ManualTwo" <<
2975 >> % end ManualTwo Staff context
2976 >> % end PianoStaff context
2977 \new Staff = "PedalOrgan" <<
2983 >> % end PedalOrgan Staff context
2985 } % end Score context
2989 @node Kevesebb gépelés változókkal és függvényekkel
2990 @subsection Kevesebb gépelés változókkal és függvényekkel
2991 @translationof Saving typing with variables and functions
2996 By this point, you've seen this kind of thing:
2998 @lilypond[quote,verbatim,ragged-right]
2999 hornNotes = \relative { c''4 b dis c }
3007 You may even realize that this could be useful in minimalist music:
3009 @lilypond[quote,verbatim,ragged-right]
3010 fragmentA = \relative { a'4 a8. b16 }
3011 fragmentB = \relative { a'8. gis16 ees4 }
3012 violin = \new Staff {
3025 However, you can also use these variables (also known as
3026 macros, or user-defined commands) for tweaks:
3028 @c TODO Avoid padtext - not needed with skylining
3029 @lilypond[quote,verbatim,ragged-right]
3030 dolce = \markup { \italic \bold dolce }
3031 padText = { \once \override TextScript.padding = #5.0 }
3032 fthenp=_\markup { \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p }
3033 violin = \relative {
3035 c''4._\dolce b8 a8 g a b
3037 c4.^"hi there!" d8 e' f g d
3038 c,4.\fthenp b8 c4 c-.
3045 \layout { ragged-right=##t }
3049 These variables are obviously useful for saving
3050 typing. But they're worth considering even if you
3051 only use them once -- they reduce complexity. Let's
3052 look at the previous example without any
3053 variables. It's a lot harder to read, especially
3057 violin = \relative @{
3059 c''4._\markup @{ \italic \bold dolce @} b8 a8 g a b
3060 \once \override TextScript.padding = #5.0
3061 c4.^"hi there!" d8 e' f g d
3062 c,4.\markup @{ \dynamic f \italic \small @{ 2nd @}
3063 \hspace #0.1 \dynamic p @}
3069 @c TODO Replace the following with a better example -td
3070 @c Skylining handles this correctly without padText
3072 So far we've seen static substitution -- when LilyPond
3073 sees @code{\padText}, it replaces it with the stuff that
3074 we've defined it to be (ie the stuff to the right of
3077 LilyPond can handle non-static substitution, too (you
3078 can think of these as functions).
3080 @lilypond[quote,verbatim,ragged-right]
3082 #(define-music-function (padding) (number?)
3084 \once \override TextScript.padding = #padding
3088 c'''4^"piu mosso" b a b
3090 c4^"piu mosso" d e f
3092 c4^"piu mosso" fis a g
3096 Using variables is also a good way to reduce work if the
3097 LilyPond input syntax changes (see
3098 @rprogram{Updating files with convert-ly}). If
3099 you have a single definition (such as @code{\dolce}) for all your
3100 input files (see @ref{Style sheets}), then if the syntax changes, you
3101 only need to update your single @code{\dolce} definition,
3102 instead of making changes throughout every @file{.ly} file.
3105 @node Partitúra és szólamkották
3106 @subsection Partitúra és szólamkották
3107 @translationof Scores and parts
3109 In orchestral music, all notes are printed twice. Once in a part for
3110 the musicians, and once in a full score for the conductor. Variables can
3111 be used to avoid double work. The music is entered once, and stored in
3112 a variable. The contents of that variable is then used to generate
3113 both the part and the full score.
3115 It is convenient to define the notes in a special file. For example,
3116 suppose that the file @file{horn-music.ly} contains the following part
3117 of a horn/@/bassoon duo
3120 hornNotes = \relative @{
3127 Then, an individual part is made by putting the following in a file
3130 \include "horn-music.ly"
3132 instrument = "Horn in F"
3136 \transpose f c' \hornNotes
3143 \include "horn-music.ly"
3147 substitutes the contents of @file{horn-music.ly} at this position in
3148 the file, so @code{hornNotes} is defined afterwards. The command
3149 @code{\transpose f@tie{}c'} indicates that the argument, being
3150 @code{\hornNotes}, should be transposed by a fifth upwards. Sounding
3151 @code{f} is denoted by notated @code{c'}, which corresponds with the
3152 tuning of a normal French Horn in@tie{}F. The transposition can be seen
3153 in the following output
3155 @lilypond[quote,ragged-right]
3156 \transpose f c' \relative {
3162 In ensemble pieces, one of the voices often does not play for many
3163 measures. This is denoted by a special rest, the multi-measure
3164 rest. It is entered with a capital @code{R} followed by a duration
3165 (@code{1}@tie{}for a whole note, @code{2}@tie{}for a half note,
3166 etc.). By multiplying the
3167 duration, longer rests can be constructed. For example, this rest
3168 takes 3@tie{}measures in 2/4 time
3174 When printing the part, multi-rests
3175 must be condensed. This is done by setting a run-time variable
3178 \set Score.skipBars = ##t
3182 This command sets the property @code{skipBars} in the
3183 @code{Score} context to true (@code{##t}). Prepending the rest and
3184 this option to the music above, leads to the following result
3186 @lilypond[quote,ragged-right]
3187 \transpose f c' \relative {
3189 \set Score.skipBars = ##t
3196 The score is made by combining all of the music together. Assuming
3197 that the other voice is in @code{bassoonNotes} in the file
3198 @file{bassoon-music.ly}, a score is made with
3201 \include "bassoon-music.ly"
3202 \include "horn-music.ly"
3205 \new Staff \hornNotes
3206 \new Staff \bassoonNotes
3213 @lilypond[quote,ragged-right]
3222 r4 d,8 f | gis4 c | b bes |
3223 a8 e f4 | g d | gis f |