Felhasználói kézikönyv
Metaadatok
A metatágok információt nyújtanak egy dalról, és metaadat szakaszban vannak kifejezve. A metaadat a dal első szakaszában jelenik meg az első üres sor előtt vagy amíg több metatág találkozik. A metatágok név/érték párok, ahol a név a bal oldalon és az érték a jobb oldalon található, kettőspont választja el őket. Csak egy metatág jelenhet meg soronként. A ChordPro formátumban a metaadat kifejezésének részleteiért tekintse meg a ChordPro fájlformátumot.
Az OnSong automatikusan a szövegfájl első sorát rendeli hozzá a dal címeként, ha az nem metatág formátumban van. Ezenkívül a második sor a dal előadójának/szerzőjének tekintendő, hacsak nincs metatág meghatározva. Az alábbiakban egy tipikus dal metaadat szakasz példája látható, amely a címet és az előadót az első és második sorban, valamint a kulcsot és a tempót állítja be.
Amazing Grace
Daniel Thomas
Key: D
Tempo: 76
Lyrics and chords start here...
Metaadat címkék
Az alábbi címkéket támogatja az OnSong:
- Title: A dal címe. Ez a dal tartalmának első sorában is kifejezhető.
- Artist: Az előadó neve vagy bármilyen egyéb szerzői információ. Ez a dal tartalmának második sorában is kifejezhető. Több előadót adhat meg pontosvesszővel elválasztva. - Kim Walker-Smith; Chris Quilala
- Author: A daladat-diagram készítőjének neve. Ez a daladat-diagram alján és a lyriken-projekcióban jelenik meg.
- Key: A dal kulcsa, enharmonikus preferenciával és opcionális „m" karakterrel a mollhoz. - alfabetikus, pl. Bb vagy Em
- TransposedKey: A kívánt kulcs, amelyen a dalt játszani kell, amely eltérhet attól a kulcstól, amelyben a dal írva van. - alfabetikus, pl. Bb vagy Em
- In: a transzponált kulcs metaadat-címke szinonimája.
- Capo: A kapo beállítása a bundák számaként. Ez általában pozitív egész szám (1–11), de negatív egész szám is lehet. - numerikus
- Tempo: Az ütés percenkénti száma (BPM). - numerikus
- Time: Az ütemjelzés. - numerikus ütés a bar felett, pl. 3/4
- Duration: A dal hossza az automatikus görgetéshez. - másodperc vagy óó:mm
- Book: A könyv vagy könyvek neve, amelybe a dalt helyezni kell. Ez a könyvnevek vesszővel elválasztott listája, amelybe a dal kerül. Ha a könyv nem létezik, akkor automatikusan létrehozódik.
- Number: A dal száma - numerikus. Hymnuszokhoz, évekhez stb. használható. Szortírozhat dalokat szám szerint referenciaként.
- Flow: A szakaszok elrendezése. - szakaszcímkék listája. A dal folyamának elrendezésével kapcsolatos részletekért tekintse meg a Folyamatot.
- MIDI: A MIDI parancsok, amelyeket el kell küldeni, amikor a dalt megtekintik. A MIDI parancsok OnSong szövegként való kifejezésének módját lásd a MIDI szintaxisban.
- MIDI-Index: A MIDI parancsok, amelyek ezt a dalt megnyitják a Dalnézetben. A MIDI parancsok OnSong szövegként való kifejezésének módját lásd a MIDI szintaxisban.
- Keywords: vagy Topic: A témakereséshez használandó címkék listája. A témakörök szerinti böngészéssel kapcsolatos további információkért lásd a Témákat.
- Copyright: vagy Footer: vagy f: A dal szerzői jogi információja. Ez a daladat-diagram alján és a lyriken-projekcióban jelenik meg.
- CCLI: A dal CCLI száma. Ez a daladat-diagram alján és a lyriken-projekcióban jelenik meg.
- Restrictions: Ezek az olyan korlátozások, amelyek megakadályozzák bizonyos műveletek végrehajtását egy dalokon belül. A dal korlátozásainak megadásával kapcsolatos részletekért tekintse meg a Korlátozásokat.
- Pitch: A megjátszandó hang vagy hangok a Hangadó funkció használatakor. Ez szóközzel elválasztott hangok listájaként van definiálva opcionális oktávokkal. - pl. A3 C#4 E5
- Subdivision: vagy Beat: lehetővé teszi a dal felosztásának kiválasztását. Ez olyan érték lehet, amely a következőket tartalmazza: whole, half, quarter, eighth, shuffle vagy sixteenth. Alternatív megoldásként használhat egész számot, például 1, 2, 4, 8 vagy 16.
- Transpose: A dal transzponálásához szükséges féllépcső száma. Ezt a dalokon belül használják a dal modulálásához felfelé vagy lefelé, és alkalmazkodik a transzpozíciós csúszkákon beállított kulcshoz. Ez a szám pozitív vagy negatív egész szám kell, hogy legyen.
- Tuning: A dalhoz hozzárendelendő hangszer hangolása. Ezek hangszerre vonatkozóan 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, amelyet a dal betöltésekor le kell játszani. Ez a jelenet nevének a kettőspont után való beírásával állítható be.
Sorok közötti címkék
Egyes címkék a dalokon belül használhatók a transzpozíció módosításához. Ezek a következőket foglalják magukban:
- Capo: a kapo alkalmazására használható a dal közepén, modulálva a dalt, hogy hangokat biztosítson a kapo alkalmazásához. A modulálási irányt a Kapo beállításaiban állíthatja be. Ez általában 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 kulcs explicit beállításához a dalokon belül. Ha a zárójelezett akkordokat használva szögletes zárójelbe helyezi az értéket, az eredményül kapott kulcs is transzponálódik. - alfabetikus, pl. Bb vagy Em
- Transpose: transzponálja a dalt a kívánt féllépcső számára. Ez pozitív vagy negatív egész szám. Például használja a 2 vagy +2 értéket a dal teljes lépésből felfelé való transzponálásához, vagy a –3 értéket három féllépcső lefelé való transzponálásához. - numerikus
Szakaszcímkék
Egyes címkék információt nyújthatnak a dal egyes szakaszairól. Ezek a következőket foglalják magukban:
- MIDI: A MIDI parancsok, amelyeket el kell küldeni, amikor a szakasz ki van választva. A MIDI parancsok OnSong szövegként való kifejezésének módját lásd a MIDI szintaxisban.
- Scene: A jelenet, amelyet a szakasz kiválasztásakor le kell játszani. Ez a jelenet nevének a kettőspont után való beírásával állítható be.
Megjegyzés: A metatágok nem különböztetik meg a kis- és nagybetűket