Metadados

As metatags são uma forma de fornecer informações sobre uma música e são expressas numa secção de metadados. Os metadados são expressos na primeira secção da música antes da primeira linha em branco ou até não haver 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 Ficheiro ChordPro para obter detalhes sobre como expressar metadados no formato ChordPro.

OnSong atribui automaticamente a primeira linha de um ficheiro 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 esteja definida. O seguinte é um exemplo de uma secção de metadados típica de uma música que define o título e o artista nas primeira e segunda linhas, bem como a tonalidade e o andamento.

Amazing Grace
Daniel Thomas
Key: D
Tempo: 76

Lyrics and chords start here...

Etiquetas de Metadados

As seguintes etiquetas são suportadas por OnSong:

• Title: O título da música. Isto 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. Isto também pode ser expresso na segunda linha do conteúdo da música. 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. Isto é apresentado na parte inferior do gráfico de acordes e na projecçã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 em que 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 etiqueta de metadados de tonalidade transposta.
• Capo: O capotrasto a definir como número de trastes. Isto é tipicamente 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 compasso. - numérico de batida sobre compasso, p.ex. 3/4
• Duration: O comprimento da música para deslocamento automático. - segundos ou mm:ss
• Book: O nome do livro ou livros para colocar a música. Esta é uma lista separada por vírgulas de nomes de livros nos quais a música será colocada. Se o livro não existir, será automaticamente criado também.
• Number: O número da música - numérico. Use para hinos, anos, etc. Pode ordenar músicas pelo número para referência.
• Flow: O arranjo de secções. - lista de rótulos de secção. Consulte Fluxo para obter detalhes sobre como organizar o fluxo de uma música.
• MIDI: Os comandos MIDI a enviar quando a música é visualizada. Consulte Sintaxe MIDI para saber como expressar comandos MIDI como texto em OnSong.
• MIDI-Index: Os comandos MIDI que irão activar a abertura desta música no Visualizador de Músicas. Consulte Sintaxe MIDI para saber como expressar comandos MIDI como texto em OnSong.
• Keywords: ou Topic: A lista de etiquetas a utilizar com a pesquisa de tópicos. Consulte Tópicos para obter mais informações sobre como procurar por tópico.
• Copyright: ou Footer: ou f: A informação de copyright da música. Esta irá aparecer na parte inferior do gráfico de acordes e na projecção de letras.
• CCLI: O número CCLI da música. Esta irá aparecer na parte inferior do gráfico de acordes e na projecção de letras.
• Restrictions: Estas são restrições que impedem que certas acções ocorram dentro de uma música. Consulte Restrições para obter detalhes sobre como definir restrições para a sua música.
• Pitch: A nota ou notas a tocar ao utilizar a funcionalidade Diapasão. Isto é definido como uma lista de notas separadas por espaços com oitavas opcionais. - p.ex. A3 C#4 E5
• Subdivision: ou Beat: permite-lhe escolher a subdivisão para a música. Isto pode ser um valor incluindo: whole, half, quarter, eighth, shuffle, ou sixteenth. Em alternativa, pode utilizar um número inteiro como 1, 2, 4, 8, ou 16.
• Transpose: O número de meios tons para transpor a música. Isto é utilizado no meio da música para modular a música para cima ou para baixo e adapta-se com a tonalidade definida nos controles deslizantes de transposição. Este número deve ser um inteiro positivo ou negativo.
• Tuning: O afinamento do instrumento a atribuir à música. Estes são específicos do instrumento e apenas guitarra é actualmente suportada 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 reproduzida quando a música é carregada. Isto pode ser definido ao introduzir o nome da cena após os dois pontos.

Etiquetas Incorporadas

Algumas etiquetas podem ser utilizadas dentro de uma música para afectar a transposição no meio da música. Estas incluem:

• Capo: pode ser utilizado para aplicar um capotrasto no meio da música, modulando a música para baixo para fornecer acordes a tocar com o capotrasto aplicado. Pode ajustar a direcção da modulação nas Definições de Capotrasto. Isto é tipicamente 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 a tonalidade explicitamente na música. Se envolver o valor com parênteses rectos ao utilizar acordes entre parênteses rectos, 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 meios tons. Este é um inteiro positivo ou negativo. Por exemplo, utilize 2 ou +2 para transpor a música para cima um tom inteiro, ou utilize -3 para transpor para baixo três meios tons. - numérico

Etiquetas de Secção

Algumas etiquetas podem ser utilizadas para fornecer informações sobre cada secção da música. Estas incluem:

• MIDI: Os comandos MIDI a enviar quando a secção é seleccionada. Consulte Sintaxe MIDI para saber como expressar comandos MIDI como texto em OnSong.
• Scene: A cena a ser reproduzida quando a secção é seleccionada. Isto pode ser definido ao introduzir o nome da cena após os dois pontos.

Nota: As metatags não são sensíveis a maiúsculas