Felhasználói kézikönyv
Szövegfájlok kezelése
Amikor az OnSong bizonyos fájlokat importál, előfordulhat, hogy utasítást kell adnia a fájl kódolásáról vagy formátumáról. A szövegfájl-kezelési beállítások segítik az OnSong-ot abban, hogy tussa, hogyan kezelje az általa talált bizonyos fájlokat.
Sorszám beszerzése a címből
Amikor egy olyan dalt importálnak, amelynek címe egy számmal kezdődik, amelyet egy pont követ, az OnSong a számot megszerezheti a dal sorszámaként a megfelelő rendezéshez és kereséshez.
ChordPro kompatibilitási feldolgozás
A ChordPro egy szintaxis, nem pedig egy szabványos fájlformátum. Emiatt a különböző szállítók a ChordPro funkcióit különböző módon használták. Ez az opció a ChordPro-t feldolgozza, hogy a lehető legkompatibilisebb legyen a jövőre vonatkozóan, például az olyan megjegyzésekkel ellátott szekciócímkéket valódi szekciókká alakítja.
Intelligens idézőjelek konvertálása
Ez az opció megpróbálja az inkompatibilis intelligens idézőjel karaktereket kompatibilis verzióikra konvertálni.
Akkordok észlelése a szövegben
Az OnSong szövegalapú daltartalmat használ az akkorddiagramok képernyőn történő megjelenítéséhez. Az OnSong és a ChordPro fájlformátumok is jelölik az akkordokat szögletes zárójelben a szövegen belül. Azonban a legtöbb akkorddiagram úgy érhető el, hogy az akkordok a szöveg felett külön sorban helyezkednek el. Ha ez az opció be van kapcsolva, az OnSong észleli a szöveg feletti akkordokat, és automatikusan elhelyezi az akkordokat a szöveghez. Az alapértelmezés be van kapcsolva.
Számszerű akkordok észlelése
Ha ez az opció be van kapcsolva, az OnSong felismeri az 1, 4 és 5m-hez hasonló számozott akkordokat, ahogyan a Nashville Number System használja. Kapcsolja ki, ha a diagramok számai akkordként vannak kezelve. Az alapértelmezés be van kapcsolva.
Kulcs felismerése: ezzel
Ha a dal kulcsa nem egyértelműen deklarálva van a dal metaadataiban, az OnSong-nak másképpen kell megtalálnia a kulcsot a transzponálás engedélyezéséhez. Az OnSong a következő módszerek egyikével észleli a kulcsot:
- Első akkord az első akkordot használja a dalban mint alapot a kulcshoz. Például, ha az első akkord Am7, akkor a dal kulcsa Am-ra van beállítva. Alapértelmezés.
- Utolsó akkord az utolsó akkordot használja a dalban mint alapot a kulcshoz. Például, ha az utolsó akkord a dalban Bbsus4, a kulcs Bb-ra lesz beállítva.
- Jegyzetszámlálás a dal kulcsának meghatározása egy módszer, amely összeadja a dalban szereplő összes akkord által használt jegyzeteket, majd számolja a kereszteket és laposságot a kulcs meghatározásához. Ez pontosabb lehet, mint az első vagy utolsó akkord a dalban, de még akkor is lehet téves, ha nem elég akkord van a dalban.
- Harmonikus analízis összegyűjt minden akkordot a dalban, és kiszámítja a kulcsot az egész akkordprogresszióból.
- Csak metaadatok csak a dal metaadatait fogja használni a kulcs alapjaként. Ez azt jelenti, hogy ha a kulcs nincs deklarálva, a transzponálás nem lesz elérhető.
Tartalék fájlkiterjesztés
Az OnSong a fájl fájlkiterjesztésével határozza meg annak fájlformátumát. Ez fontos az importálási folyamat során, hogy szövegkonverzió történhessen egy támogatott belső formátumra, vagy olyan külső fájlok, mint például a PDF, megfelelően megtekinthetők legyenek.
A legtöbb esetben a fájloknak van fájlkiterjesztésük. Az OpenSong fájlok általában kiterjesztés nélküliek, de valójában XML-formátumú fájlok. Ezért az OnSong automatikusan hozzáadja a .xml fájlkiterjesztést azokhoz a fájlokhoz, amelyeknek nincs kiterjesztésük. Ez azonosítja a fájlt OpenSong fájlként, és megfelelően konvertálja azt.
Ha sok olyan fájlja van, amelyeknek nincs kiterjesztésük, és a fájl típusa ismert, írja be a fájlkiterjesztést erre a helyre.
Fájlkódolás
A szövegkódolás annak a folyamata, hogy a nyelvben szereplő karaktereket olyan bináris értékekké alakítja, amelyeket egy számítógép tárolhat. Az OnSong úgy van tervezve, hogy megkísérelje kitalálni a fájl fájlkódolását, de vannak olyan alkalmak, amikor a fájlkódolás nem ismert. Ennek alapértelmezett beállítása az Auto, ami azt jelenti, hogy a kódolás sejtés. Ha ismeri a fájl kódolását, válassza ki az egyik lehetőség közül:
- Auto felismeri a kódolást a fájl tartalmára alapozva. Alapértelmezés.
- ASCII egy alapvető szövegkódolás, amely a legtöbb nyugati karakterkészletet felöleli.
- UTF-8 az ASCII egyik felsőkészlete, amely a világ nagy részén található legtöbb karaktert tartalmazza, de nem tartalmaz egyes karaktereket, például az ázsiai nyelvekben találhatókat. Az OnSong belsőleg UTF-8-at használ, és nagyobb karakterkészleteket olyan módon tárol, amely lehetővé teszi lekérésüket.
- UTF-16 16 bites értékeket használ a karakterkészlet meghatározásához, 32 768 lehetséges karaktert megengedve.
- UTF-32 32 bites értékeket használ a karakterkészlet meghatározásához, 2 milliárd lehetséges karaktert megengedve.
- ISO-Latin vagy jobban ismert kódlapja "iOS-8859-1". Hasonló az UTF-8-hoz és latin alapú karaktereket tartalmaz.
Szövegfájl konvertálása
Amikor szövegfájlokat importálnak, az OnSong automatikusan lefordíthatja őket az OnSong fájlformátumában. Ez automatikusan szögletes zárójelbe helyezi az akkordokat. Mivel az OnSong már automatikusan kezelni tudja az akkordokat a szöveg felett a dal megtekintőben, ez alapértelmezés szerint szövegre van beállítva. Továbbra is lehetősége van az OnSong-nak az énekek automatikus konvertálására, ha az OnSong-ot választja helyette.