Metadados

As metatags são uma forma de fornecer informações sobre uma música e são expressas em uma seção de metadados. Os metadados são expressos na primeira seção da música antes da primeira linha em branco ou até que não haja mais metatags. As metatags são pares nome/valor, em que o nome fica à esquerda e o valor à direita, separados por dois-pontos. Apenas uma metatag pode aparecer por linha. Consulte o Formato de Arquivo ChordPro para obter detalhes sobre como expressar metadados no formato ChordPro.

O OnSong atribui automaticamente a primeira linha de um arquivo de texto como o título da música se não estiver no formato de metatag. Além disso, a segunda linha é considerada o artista/assinatura da música, a menos que uma metatag seja definida. A seguir, há um exemplo de uma seção de metadados de música típica que define o título e o artista como a primeira e segunda linhas, bem como a tonalidade e o andamento.

Amazing Grace
Daniel Thomas
Key: D
Tempo: 76

Lyrics and chords start here...

Marcas de Metadados

As seguintes marcas são suportadas pelo OnSong:

• Title: O título da música. Isso também pode ser expresso na primeira linha do conteúdo da música.
• Artist: O nome do artista ou qualquer outra informação de assinatura. Isso também pode ser expresso na segunda linha do conteúdo da música. Você pode especificar vários artistas separando os nomes com um ponto-e-vírgula. - Kim Walker-Smith; Chris Quilala
• Author: O nome da pessoa que criou o gráfico de acordes. Isso é exibido na parte inferior do gráfico de acordes e na projeção de letras.
• Key: A tonalidade da música escrita como uma tonalidade com preferência enarmônica e um opcional "m" para indicar menor. - alfabético, p.ex. Bb ou Em
• TransposedKey: A tonalidade desejada na qual a música deve ser tocada, que pode ser diferente da tonalidade em que a música foi escrita. - alfabético, p.ex. Bb ou Em
• In: é um sinônimo para a metatag de tonalidade transposta.
• Capo: O capotraste a ser definido como número de casas. Normalmente é um inteiro positivo (1 a 11), mas também pode ser definido como um inteiro negativo. - numérico
• Tempo: Os batidas por minuto (BPM). - numérico
• Time: A assinatura de tempo. - batida numérica sobre compasso, p.ex. 3/4
• Duration: O comprimento da música para rolagem automática. - segundos ou mm:ss
• Book: O nome do livro ou livros para colocar a música. Esta é uma lista delimitada por vírgula de nomes de livros nos quais a música será colocada. Se o livro não existir, ele também será criado automaticamente.
• Number: O número da música - numérico. Use para hinos, anos, etc. Você pode classificar músicas pelo número como referência.
• Flow: O arranjo das seções. - lista de rótulos de seção. Consulte Flow para obter detalhes sobre como arranjar o fluxo de uma música.
• MIDI: Os comandos MIDI a serem enviados quando a música é visualizada. Consulte Sintaxe MIDI para obter detalhes sobre como expressar comandos MIDI como texto no OnSong.
• MIDI-Index: Os comandos MIDI que acionarão esta música para ser aberta no Song Viewer. Consulte Sintaxe MIDI para obter detalhes sobre como expressar comandos MIDI como texto no OnSong.
• Keywords: ou Topic: A lista de marcas a serem usadas com a pesquisa de tópicos. Consulte Topics para obter mais informações sobre como navegar por tópico.
• Copyright: ou Footer: ou f: As informações de copyright da música. Isso aparecerá na parte inferior do gráfico de acordes e da projeção de letras.
• CCLI: O número CCLI da música. Isso aparecerá na parte inferior do gráfico de acordes e da projeção de letras.
• Restrictions: Essas são restrições que impedem certas ações de ocorrerem dentro de uma música. Consulte Restrictions para obter detalhes sobre como definir restrições para sua música.
• Pitch: A nota ou notas a serem tocadas ao usar o recurso Pitch Pipe. Isso é definido como uma lista de notas separadas por espaço com oitavas opcionais. - p.ex. A3 C#4 E5
• Subdivision: ou Beat: permite que você escolha a subdivisão para a música. Isso pode ser um valor incluindo: whole, half, quarter, eighth, shuffle ou sixteenth. Alternativamente, você pode usar um número inteiro como 1, 2, 4, 8 ou 16.
• Transpose: O número de semitons para transpor a música. Isso é usado no meio da música para modular a música para cima ou para baixo e se adapta à tonalidade definida nos controles deslizantes de transposição. Este número deve ser um inteiro positivo ou negativo.
• Tuning: A afinação do instrumento a ser atribuída à música. Essas são específicas do instrumento e apenas violão é atualmente suportado com estes valores: Standard, Celtic, Drop D, Drop DD, Drop C, Drop B, Drop A, Open C, Open D, Open G ou Open E.
• Scene: A cena a ser tocada quando a música é carregada. Isso pode ser definido inserindo o nome da cena após os dois-pontos.

Marcas Inline

Algumas marcas podem ser usadas dentro de uma música para efeitar a transposição no meio da música. Essas incluem:

• Capo: pode ser usado para aplicar um capotraste no meio da música, modulando a música para baixo para fornecer acordes a serem tocados com o capotraste aplicado. Você pode ajustar a direção da modulação em Capo Settings. Normalmente é um inteiro positivo (1 a 11), mas também pode ser definido como um inteiro negativo para remover um capotraste anterior. - numérico
• Key: para definir a tonalidade explicitamente na música. Se você envolver o valor com colchetes ao usar acordes entre colchetes, a tonalidade resultante também será transposta. - alfabético, p.ex. Bb ou Em
• Transpose: transpõe a música pelo número desejado de semitons. Esse é um inteiro positivo ou negativo. Por exemplo, use 2 ou +2 para transpor a música um tom inteiro para cima, ou use -3 para transpor três semitons para baixo. - numérico

Marcas de Seção

Algumas marcas podem ser usadas para fornecer informações sobre cada seção da música. Essas incluem:

• MIDI: Os comandos MIDI a serem enviados quando a seção é selecionada. Consulte Sintaxe MIDI para obter detalhes sobre como expressar comandos MIDI como texto no OnSong.
• Scene: A cena a ser tocada quando a seção é selecionada. Isso pode ser definido inserindo o nome da cena após os dois-pontos.

Observação: As metatags não diferenciam maiúsculas de minúsculas