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

• Título: O título da música. Isto também pode ser expresso na primeira linha do conteúdo da música.
• Artista: 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 múltiplos artistas separando os nomes com um ponto e vírgula. - Kim Walker-Smith; Chris Quilala
• Autor: 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.
• Tonalidade: A tonalidade da música escrita como uma tonalidade com preferência enarmónica e um "m" opcional para indicar menor. - alfabético, p.ex. Bb ou Em
• Tonalidade Transposta: 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
• Em: é um sinónimo para a etiqueta de metadados de tonalidade transposta.
• Capotrasto: 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
• Andamento: Os batidas por minuto (BPM). - numérico
• Compasso: A assinatura de tempo. - numérico, batida sobre compasso, p.ex. 3/4
• Duração: O comprimento da música para auto-scroll. - segundos ou mm:ss
• Livro: O nome do livro ou livros onde 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, será criado automaticamente.
• Número: O número da música - numérico. Use para hinos, anos, etc. Pode ordenar músicas pelo número para referência.
• Fluxo: 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 é apresentada. Consulte Sintaxe MIDI para saber como expressar comandos MIDI como texto em OnSong.
• MIDI-Index: Os comandos MIDI que irão acionar a abertura desta música no Visualizador de Música. Consulte Sintaxe MIDI para saber como expressar comandos MIDI como texto em OnSong.
• Palavras-chave: ou Tópico: A lista de etiquetas a usar com a pesquisa de tópico. Consulte Tópicos para obter mais informações sobre navegação por tópico.
• Direitos de Autor: ou Rodapé: ou f: A informação de direitos de autor da música. Isto aparecerá na parte inferior do gráfico de acordes e projecção de letras.
• CCLI: O número CCLI da música. Isto aparecerá na parte inferior do gráfico de acordes e projecção de letras.
• Restrições: Estas são restrições que impedem certas acções de ocorrer dentro de uma música. Consulte Restrições para obter detalhes sobre como definir restrições para a sua música.
• Tonalidade de Referência: A nota ou notas a tocar ao utilizar a funcionalidade Diapasão. Isto é definido como uma lista de notas separadas por espaço com oitavas opcionais. - p.ex. A3 C#4 E5
• Subdivisão: ou Batida: permite-lhe escolher a subdivisão da música. Isto pode ser um valor incluindo: inteira, metade, semínima, colcheia, shuffle, ou dezasseis avos. Alternativamente, pode utilizar um número inteiro tal como 1, 2, 4, 8, ou 16.
• Transposição: O número de semitons a transpor a música. Isto é usado a meio da música para modular a música para cima ou para baixo e adapta-se à tonalidade definida nos controles deslizantes de transposição. Este número deve ser um inteiro positivo ou negativo.
• Cena: A cena a ser reproduzida quando a música é carregada. Isto pode ser definido introduzindo o nome da cena após os dois pontos.

Etiquetas Inline

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

• Capotrasto: pode ser utilizado para aplicar um capotrasto a meio da música, modulando a música para baixo para fornecer acordes para tocar com o capotrasto aplicado. Pode ajustar a direcção de modulação em 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
• Tonalidade: para definir a tonalidade explicitamente na música. Se rodear o valor com parênteses ao utilizar acordes entre parênteses, a tonalidade resultante também será transposta. - alfabético, p.ex. Bb ou Em
• Transposição: transpõe a música o número desejado de semitons. Isto é 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

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 é selecionada. Consulte Sintaxe MIDI para saber como expressar comandos MIDI como texto em OnSong.
• Cena: A cena a ser reproduzida quando a secção é selecionada. Isto pode ser definido introduzindo o nome da cena após os dois pontos.

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