Metaadatok

A metatagek egy módja annak, hogy információkat adjunk egy dalról, és egy metaadat szakaszban vannak kifejezve. A metaadat a dal első szakaszában jelenik meg, az első üres sor előtt vagy amíg nem találunk több metatagot. A metatagek név/érték párok, ahol a név a bal oldalon van, az érték pedig a jobb oldalon, kettőspont választja el őket. Soronként csak egy metatag jelenhet meg. A ChordPro formátumban történő metaadat kifejezéshez lásd a ChordPro File Format dokumentumot.

Az OnSong automatikusan a szövegfájl első sorát rendeli hozzá a dal címéhez, ha az nem metatag formátumban van. Ezenkívül a második sor a dal előadójaként/kreditjeként működik, hacsak nincs metatag definiálva. Az alábbi egy tipikus dal metaadat szakaszának példája, amely beállítja a címet és az előadót az első és második sorban, valamint a tonalitást és a tempót.

Amazing Grace
Daniel Thomas
Key: D
Tempo: 76

Lyrics and chords start here...

Metaadat tagek

Az OnSong a következő tagokat támogatja:

• Title: A dal címe. Ez a dal tartalma első soraként is kifejezhető.
• Artist: Az előadó neve vagy bármilyen egyéb kreditinformáció. Ez a dal tartalma második soraként is kifejezhető. Több előadót is megadhat pontosvesszővel elválasztva. - Kim Walker-Smith; Chris Quilala
• Author: Annak a személynek a neve, aki a akkord diagramot készítette. Ez az akkord diagram alján és a dalszöveges vetítésben jelenik meg.
• Key: A dal tonalitása, enharmonikus preferenciával és opcionálisan egy „m" betűvel a moll jelzésére. - alfabetikus, például Bb vagy Em
• TransposedKey: A kívánt tonalitás, amelyben a dalt játszani szeretnénk, ami eltérhet az írott tonalitástól. - alfabetikus, például Bb vagy Em
• In: a transzponált tonalitás metaadat tagjének szinonimája.
• Capo: A kapodastra beállítása a bundok számaként. Ez általában egy pozitív egész szám (1–11), de negatív egész szám is lehet. - numerikus
• Tempo: Az ütemek száma percenként (BPM). - numerikus
• Time: Az ütemjelzés. - numerikus ütem osztva sávval, például 3/4
• Duration: A dal hossza az automatikus görgetéshez. - másodperc vagy mm:ss
• Book: A könyv vagy könyvek neve, amelyekbe a dalt helyezzük. Ez a könyvnevek vesszővel elválasztott listája, amelyekbe a dal kerül. Ha a könyv nem létezik, automatikusan létrehozásra kerül.
• Number: A dal száma - numerikus. Használja himnuszokhoz, évekhez stb. Szortírozhatja a dalokat szám alapján referenciaként.
• Flow: A szakaszok elrendezése. - szakaszcímkék listája. A dal folyamatának rendezéséhez lásd a Flow dokumentumot.
• MIDI: A MIDI parancsok, amelyeket akkor kell elküldeni, amikor a dalt megtekintik. A MIDI parancsok OnSongban való szövegként való kifejezéséhez lásd a MIDI Syntax dokumentumot.
• MIDI-Index: A MIDI parancsok, amelyek a Song Viewer megnyitásakor aktiválódnak. A MIDI parancsok OnSongban való szövegként való kifejezéséhez lásd a MIDI Syntax dokumentumot.
• Keywords: vagy Topic: A témakereséssel használandó tagek listája. A témánként történő böngészésről lásd a Topics dokumentumot.
• Copyright: vagy Footer: vagy f: A dal szerzői jogi információi. Ez az akkord diagram és a dalszöveges vetítés alján jelenik meg.
• CCLI: A dal CCLI száma. Ez az akkord diagram és a dalszöveges vetítés alján jelenik meg.
• Restrictions: Ezek az olyan korlátozások, amelyek megakadályoznak bizonyos műveletek elvégzését egy dalban. A dal korlátozásainak beállításáról lásd a Restrictions dokumentumot.
• Pitch: A hangok vagy hangok, amelyeket a Pitch Pipe funkció használatakor játszanak. Ez szóközzel elválasztott hangok listájaként van definiálva opcionális oktávokkal. - például A3 C#4 E5
• Subdivision: vagy Beat: lehetővé teszi a dal felosztásának kiválasztását. Ez egy érték lehet, beleértve: whole, half, quarter, eighth, shuffle vagy sixteenth. Alternatív megoldásként egész számokat használhat, például 1, 2, 4, 8 vagy 16.
• Transpose: A dal transzponálásának félhangok száma. Ez a dal közepén használatos a dal modulálásához fel vagy le, és alkalmazkodik a transzpozíciós csúszkában beállított tonalitáshoz. Ez a szám pozitív vagy negatív egész szám lehet.
• Tuning: A hangszerhez rendelhető hangolás. Ezek az eszközhöz specifikusak, és jelenleg csak a gitár támogatott ezekkel az értékekkel: Standard, Celtic, Drop D, Drop DD, Drop C, Drop B, Drop A, Open C, Open D, Open G vagy Open E.
• Scene: A jelenet, amely a dal betöltésekor játszódik. Ez beállítható a jelenet nevének beírásával a kettőspont után.

Inline tagek

Néhány tag a dalokon belül használható a transzpozíció módosításához. Ezek közé tartoznak:

• Capo: a kapodastra dal közepén történő alkalmazásához használható, amely modulálja a dalt le, hogy a kapo alkalmazásával akkordokat lehessen játszani. A moduláció irányát a Capo Settings alkalmazásban lehet módosítani. Ez általában egy pozitív egész szám (1–11), de negatív egész szám is lehet az előző kapo eltávolításához. - numerikus
• Key: a tonalitás explicit beállításához a dalban. Ha szögletes zárójellel körülvett akkordokat használ, az eredményül kapott tonalitás szintén transzponálódik. - alfabetikus, például Bb vagy Em
• Transpose: transzponálja a dalt a kívánt félhangok számával. Ez egy pozitív vagy negatív egész szám. Például 2 vagy +2 használatával transzponálhatja a dalt egy egész lépésgyel felfelé, vagy -3 segítségével lefelé három félhanggal. - numerikus

Section tagek

Néhány tag használható a dal egyes szakaszaira vonatkozó információk biztosítására. Ezek közé tartoznak:

• MIDI: A MIDI parancsok, amelyeket akkor kell elküldeni, amikor a szakaszt kiválasztják. A MIDI parancsok OnSongban való szövegként való kifejezéséhez lásd a MIDI Syntax dokumentumot.
• Scene: A jelenet, amely a szakasz kiválasztásakor játszódik. Ez beállítható a jelenet nevének beírásával a kettőspont után.

Megjegyzés: A metatagek nem különböztetik meg a kis- és nagybetűket