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 onde o nome está à 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.

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/crédito da música, a menos que uma metatag seja definida. A seguir está um exemplo de uma seção típica de metadados de música que define o título e o artista como 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 crédito. 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 pseudônimo para a metatag de tonalidade transposta.
• Capo: O capotrasto a ser definido como número de trastes. Normalmente é um inteiro positivo (1 a 11), mas também pode ser definido como um inteiro negativo. - numérico
• Tempo: Os batimentos por minuto (BPM). - numérico
• Time: A assinatura de tempo. - numérico de batimento 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 dos livros nos quais colocar a música. Esta é uma lista delimitada por vírgulas de nomes de livros nos quais a música será colocada. Se o livro não existir, ele será criado automaticamente.
• Number: O número da música - numérico. Use para hinos, anos, etc. Você pode classificar as músicas pelo número para referência.
• Flow: O arranjo das seções. - lista de rótulos de seção. Consulte Flow para obter detalhes sobre como organizar o fluxo de uma música.
• MIDI: Os comandos MIDI a serem enviados quando a música for visualizada. Consulte Sintaxe MIDI para saber como expressar comandos MIDI como texto no OnSong.
• MIDI-Index: Os comandos MIDI que acionarão a abertura desta música no Visualizador de Músicas. Consulte Sintaxe MIDI para saber como expressar comandos MIDI como texto no OnSong.
• Keywords: ou Topic: A lista de marcas a serem usadas com a busca por tópico. Consulte Tópicos para obter mais informações sobre navegação por tópico.
• Copyright: ou Footer: ou f: As informações de direitos autorais da música. Isso aparecerá na parte inferior do gráfico de acordes e projeção de letras.
• CCLI: O número CCLI da música. Isso aparecerá na parte inferior do gráfico de acordes e projeção de letras.
• Restrictions: Estas são restrições que impedem certas ações de ocorrerem em uma música. Consulte Restrições para obter detalhes sobre como definir restrições para sua música.
• Pitch: A nota ou notas a serem tocadas ao usar o recurso Tuner. 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 da música. 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 transportar 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.
• Scene: A cena a ser reproduzida quando a música é carregada. Isso pode ser definido inserindo o nome da cena após o dois-pontos.

Marcas Inline

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

• Capo: pode ser usado para aplicar um capotrasto no meio da música, modulando a música para baixo para fornecer acordes a serem tocados com o capotrasto aplicado. Você pode ajustar a direção da modulação em Configurações de Capotrasto. Normalmente é um inteiro positivo (1 a 11), mas também pode ser definido como um inteiro negativo para remover um capotrasto anterior. - numérico
• Key: para definir explicitamente a tonalidade na música. Se você circundar 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 o número desejado de semitons. Este é um inteiro positivo ou negativo. Por exemplo, use 2 ou +2 para transportar a música uma oitava completa para cima, ou use -3 para transportar 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. Estas incluem:

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

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