Metadane

Metatagi to sposób na dostarczenie informacji o utworze i jest wyrażony w sekcji metadanych. Metadane są wyrażone w pierwszej sekcji utworu przed pierwszą pustą linią lub do momentu napotkania ostatniego metatagu. Metatagi to pary nazwa/wartość, gdzie nazwa znajduje się po lewej stronie, a wartość po prawej stronie, oddzielone dwukropkiem. Tylko jeden metatag może pojawić się w jednej linii. Aby uzyskać szczegółowe informacje na temat wyrażania metadanych w formacie ChordPro, zapoznaj się z dokumentacją Format pliku 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 przedstawiono 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

Poniższe tagi są wspierane przez OnSong:

• Title: Tytuł utworu. Może być również wyrażony w pierwszej linii zawartości utworu.
• Artist: Nazwa artysty lub inne informacje o podpisie. Może być również wyrażony w drugiej linii zawartości utworu. Możesz określić wielu artystów, oddzielając nazwiska średnikami. - Kim Walker-Smith; Chris Quilala
• Author: Nazwa osoby, która utworzyła arkusz akordów. Jest wyświetlany u dołu arkusza akordów i w projekcji tekstów.
• Key: Tonacja utworu zapisana jako tonacja z preferencją enharmoniczną i opcjonalnym ""m"" wskazującym dur moll. - alfabetycznie, np. Bb lub Em
• TransposedKey: Pożądana tonacja, w której utwór powinien być grany, która może się różnić od tonacji, w której utwór jest napisany. - alfabetycznie, np. Bb lub Em
• In: jest synonimem tagu metadanych transponowanej tonacji.
• Capo: Kapodastr ustawiony jako liczba progów. Zwykle jest to liczba całkowita dodatnia (od 1 do 11), ale może być również liczbą całkowitą ujemną. - numeryczne
• Tempo: Liczba uderzeń na minutę (BPM). - numeryczne
• Time: Oznaczenie metrum. - numeryczne, licznik nad mianownikiem, np. 3/4
• Duration: Długość utworu do autoscrolowania. - sekundy lub mm:ss
• Book: Nazwa książki lub książek, w których umieścić utwór. To jest rozdzielana przecinkami lista nazw książek, do których zostanie umieszczony utwór. Jeśli książka nie istnieje, zostanie automatycznie utworzona.
• Number: Numer utworu - numeryczne. Używane dla hymnów, lat itp. Możesz sortować utwory według numeru jako odniesienie.
• Flow: Układ sekcji. - lista etykiet sekcji. Zapoznaj się z dokumentacją Flow, aby uzyskać szczegółowe informacje na temat rozmieszczenia przepływu utworu.
• MIDI: Polecenia MIDI do wysłania, gdy utwór jest wyświetlany. Zapoznaj się z dokumentacją Składnia MIDI, aby dowiedzieć się, jak wyrazić polecenia MIDI jako tekst w OnSong.
• MIDI-Index: Polecenia MIDI, które wyzwolą otwarcie tego utworu w Song Viewer. Zapoznaj się z dokumentacją Składnia MIDI, aby dowiedzieć się, jak wyrazić polecenia MIDI jako tekst w OnSong.
• Keywords: lub Topic: Lista tagów do użytku przy wyszukiwaniu tematycznym. Zapoznaj się z dokumentacją Topics, aby uzyskać więcej informacji na temat przeglądania według tematu.
• Copyright: lub Footer: lub f: Informacje o prawach autorskich do utworu. Pojawi się u dołu arkusza akordów i projekcji tekstów.
• CCLI: Numer CCLI utworu. Pojawi się u dołu arkusza akordów i projekcji tekstów.
• Restrictions: To są ograniczenia, które uniemożliwiają wykonanie pewnych akcji w obrębie utworu. Zapoznaj się z dokumentacją Restrictions, aby uzyskać szczegółowe informacje na temat ustawiania ograniczeń dla Twojego utworu.
• Pitch: Nota lub nuty do odtworzenia przy użyciu funkcji Pitch Pipe. Jest to zdefiniowane jako oddzielona spacjami lista nut z opcjonalnymi oktawami. - np. A3 C#4 E5
• Subdivision: lub Beat: pozwala wybrać podział dla utworu. Może to być wartość, w tym: whole, half, quarter, eighth, shuffle, lub sixteenth. Alternatywnie możesz użyć liczby całkowitej, takiej jak 1, 2, 4, 8, lub 16.
• Transpose: Liczba półtonów do transponowania utworu. Jest to 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ą.
• Tuning: Stroik instrumentu do przypisania do utworu. Te wartości są specyficzne dla instrumentu i obecnie obsługiwane są tylko gitary 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.
• Scene: Scena do odtworzenia, gdy utwór zostanie załadowany. Można to ustawić, wpisując nazwę sceny po dwukropku.

Tagi wbudowane

Niektóre tagi mogą być używane w obrębie utworu, aby wpłynąć na transponowanie w środku utworu. Obejmują one:

• Capo: może być użyty do zastosowania kapodastru w środku utworu, modulując utwór w dół, aby zapewnić akordy do grania z zastosowanym kapodastem. Możesz dostosować kierunek modulacji w Capo Settings. Zwykle jest to liczba całkowita dodatnia (od 1 do 11), ale może być również liczbą całkowitą ujemną, aby usunąć poprzedni kapodastr. - numeryczne
• Key: aby jawnie ustawić tonację w utworze. Jeśli otoczyć wartość nawiasami kwadratowymi przy użyciu akordów w nawiasach, wynikowa tonacja zostanie również transponowana. - alfabetycznie, np. Bb lub Em
• Transpose: transpozycja utworu o pożądaną liczbę półtonów. To jest dodatnia lub ujemna liczba całkowita. Na przykład użyj 2 lub +2, aby transponować utwór w górę o całość, lub użyj -3, aby transponować w dół o trzy półtony. - numeryczne

Tagi sekcji

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

• MIDI: Polecenia MIDI do wysłania, gdy sekcja zostanie wybrana. Zapoznaj się z dokumentacją Składnia MIDI, aby dowiedzieć się, jak wyrazić polecenia MIDI jako tekst w OnSong.
• Scene: Scena do odtworzenia, gdy sekcja zostanie wybrana. Można to ustawić, wpisując nazwę sceny po dwukropku.

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