Metadane

Metatagi to sposób na podanie informacji o utworze i wyrażone są w sekcji metadanych. Metadane są wyrażone w pierwszej sekcji utworu przed pierwszą pustą linią lub do momentu, gdy nie będą już napotykane metatagi. Metatagi to pary nazwa/wartość, gdzie nazwa znajduje się po lewej stronie, a wartość po prawej stronie, oddzielone dwukropkiem. W każdej linii może pojawić się tylko jeden metatag. Zapoznaj się z Formatem pliku ChordPro aby uzyskać szczegóły na temat wyrażania metadanych w formacie ChordPro.

OnSong automatycznie przypisuje pierwszą linię pliku tekstowego jako tytuł utworu, jeśli nie jest w formacie metatagu. Ponadto druga linia uważana jest za artystę/podpis utworu, chyba że zdefiniowany jest metatag. Poniżej znajduje się przykład typowej sekcji metadanych utworu, która ustawia tytuł i artystę w pierwszej i drugiej linii, a także tonację i tempo.

Amazing Grace
Daniel Thomas
Key: D
Tempo: 76

Lyrics and chords start here...

Tagi metadanych

Następujące tagi są obsługiwane przez OnSong:

• Tytuł: Tytuł utworu. Można go również wyrazić w pierwszej linii zawartości utworu.
• Artysta: Nazwa artysty lub inne informacje o podpisie. Można to również wyrazić w drugiej linii zawartości utworu. Możesz określić wielu artystów, oddzielając ich nazwy średnikiem. - Kim Walker-Smith; Chris Quilala
• Autor: Imię i nazwisko osoby, która stworzyła kartę akordów. Jest wyświetlany u dołu karty akordów i w projekcji tekstu.
• Tonacja: Tonacja utworu zapisana jako tonacja z preferencją enharmoniczną i opcjonalnym „m" wskazującym moll. - alfabetycznie, np. Bb lub Em
• Transponowana tonacja: Pożądana tonacja, w której utwor powinien być grany, co może się różnić od tonacji, w której utwor został napisany. - alfabetycznie, np. Bb lub Em
• W: pseudonim tagu metadanych transponowanej tonacji.
• Kapodaster: Kapodaster ustawiony na liczbę progów. Zwykle jest to dodatnia liczba całkowita (1 do 11), ale może być również ujemną liczbą całkowitą. - numeryczne
• Tempo: Uderzenia na minutę (BPM). - numeryczne
• Metrum: Metrum taktowe. - numeryczne uderzenie nad taktem, np. 3/4
• Czas trwania: Długość utworu dla autoscrollu. - sekundy lub mm:ss
• Książka: Nazwa książki lub książek, do których umieścić utwór. Jest to lista rozdzielona przecinkami nazw książek, do których umieszczony będzie utwór. Jeśli książka nie istnieje, zostanie automatycznie utworzona.
• Numer: Numer utworu - numeryczne. Używaj do hymnów, lat itp. Możesz sortować utwory według numeru jako odniesienie.
• Przebieg: Aranżacja sekcji. - lista etykiet sekcji. Zobacz Przebieg aby uzyskać szczegóły na temat układania przebiegu utworu.
• MIDI: Polecenia MIDI do wysłania, gdy utwór jest wyświetlany. Zapoznaj się z Składnią MIDI aby dowiedzieć się, jak wyrażać polecenia MIDI jako tekst w OnSong.
• MIDI-Index: Polecenia MIDI, które spowodują otwarcie tego utworu w Przeglądarce utworów. Zapoznaj się z Składnią MIDI aby dowiedzieć się, jak wyrażać polecenia MIDI jako tekst w OnSong.
• Słowa kluczowe: lub Temat: Lista tagów do użytku z wyszukiwaniem tematycznym. Zapoznaj się z Tematami aby uzyskać więcej informacji na temat przeglądania według tematu.
• Prawa autorskie: lub Stopka: lub f: Informacja o prawach autorskich utworu. Pojawi się u dołu karty akordów i projekcji tekstu.
• CCLI: Numer CCLI utworu. Pojawi się u dołu karty akordów i projekcji tekstu.
• Ograniczenia: To są ograniczenia, które uniemożliwiają wykonanie pewnych czynności w utworze. Zapoznaj się z Ograniczeniami aby uzyskać szczegóły na temat ustawiania ograniczeń dla swojego utworu.
• Wysokość dźwięku: Nuta lub nuty do zagrania podczas korzystania z funkcji Strychni do stroikowania. Jest zdefiniowana jako lista nut oddzielonych spacją z opcjonalnymi oktawami. - np. A3 C#4 E5
• Subdivizja: lub Uderzenie: pozwala wybrać subdivizję dla utworu. Może to być wartość obejmująca: całą, połowę, ćwierć, ósmą, szufflę lub szesnastkę. Alternatywnie możesz użyć liczby całkowitej, takiej jak 1, 2, 4, 8 lub 16.
• Transponuj: Liczba półtonów do transponowania utworu. Jest używane w środku utworu do modulacji utworu w górę lub w dół i dostosowuje się do tonacji ustawionej w suwakach transponowania. Ta liczba musi być dodatnią lub ujemną liczbą całkowitą.
• Strój: Strój instrumentu do przypisania do utworu. Są one specyficzne dla instrumentu i tylko gitara jest obecnie obsługiwana z następującymi wartościami: Standard, Celtic, Drop D, Drop DD, Drop C, Drop B, Drop A, Open C, Open D, Open G, lub Open E.
• Scena: Scena do odtworzenia po załadowaniu utworu. Można ją ustawić, wpisując nazwę sceny po dwukropku.

Tagi wbudowane

Niektóre tagi mogą być używane w utworze do efektu transponowania w środku utworu. Obejmują one:

• Kapodaster: może być użyty do zastosowania kapodastru w środku utworu, modulując utwór w dół, aby zapewnić akordy do grania z zastosowanym kapodastrem. Możesz dostosować kierunek modulacji w Ustawieniach kapodastru. Zwykle jest to dodatnia liczba całkowita (1 do 11), ale może być również ujemną liczbą całkowitą, aby usunąć poprzedni kapodaster. - numeryczne
• Tonacja: aby ustawić tonację wyraźnie w utworze. Jeśli otoczyć wartość nawiasami przy używaniu nawiasowych akordów, wynikowa tonacja również zostanie transponowana. - alfabetycznie, np. Bb lub Em
• Transponuj: transponuje utwór żądaną liczbę półtonów. To dodatnia lub ujemna liczba całkowita. Na przykład użyj 2 lub +2, aby transponować utwór w górę o całą sekundę, lub użyj -3 aby transponować w dół o trzy półtony. - numeryczne

Tagi sekcji

Niektóre tagi mogą być używane do podania informacji o każdej sekcji utworu. Obejmują one:

• MIDI: Polecenia MIDI do wysłania, gdy sekcja jest wybrana. Zapoznaj się z Składnią MIDI aby dowiedzieć się, jak wyrażać polecenia MIDI jako tekst w OnSong.
• Scena: Scena do odtworzenia po wybraniu sekcji. Można ją ustawić, wpisując nazwę sceny po dwukropku.

Uwaga: Metatagi nie są wrażliwe na wielkość liter