Metadados

As Metatags são uma forma de fornecer informações sobre uma canção e são expressas numa secção de metadados. Os metadados são expressos na primeira secção da canção antes da primeira linha em branco ou até não haver mais metatags. Os Metatags são pares nome/valor onde o nome está à esquerda e o valor à direita separados por dois pontos. Apenas um metatag pode aparecer por linha. Por favor consulte o Formato de Ficheiro ChordPro para detalhes sobre como expressar metadados no formato ChordPro.

OnSong atribui automaticamente a primeira linha de um ficheiro de texto como o título da canção se não estiver no formato metatag. Além disso, a segunda linha é considerada o artista/crédito da canção a menos que um metatag seja definido. O seguinte é um exemplo de uma secção típica de metadados de canção que define o título e 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...

Etiquetas de Metadados

As seguintes etiquetas são suportadas por OnSong:

• Título: O título da canção. Isto também pode ser expresso na primeira linha do conteúdo da canção.
• 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 canção. Você pode especificar vários artistas separando os nomes com um ponto e vírgula. - Kim Walker-Smith; Chris Quilala
• Autor: O nome da pessoa que criou o diagrama de acordes. Isto é apresentado na parte inferior do diagrama de acordes e na projecção de letras.
• Tonalidade: A tonalidade da canção escrita como uma tonalidade com preferência enarmónica e um opcional "m" para indicar menor. - alfabético, por ex. Bb ou Em
• TonalidedeTransposta: A tonalidade desejada em que a canção deve ser tocada que pode ser diferente da tonalidade em que a canção foi escrita. - alfabético, por ex. Bb ou Em
• Em: é um pseudónimo para a etiqueta de metadados de tonalidade transposta.
• Capotrasto: O capotrasto definido 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 batimentos por minuto (BPM). - numérico
• Compasso: A fórmula de compasso. - batimento numérico sobre compasso, por ex. 3/4
• Duração: O comprimento da canção para deslocamento automático. - segundos ou mm:ss
• Livro: O nome do livro ou livros em que colocar a canção. Esta é uma lista delimitada por vírgulas de nomes de livros em que a canção será colocada. Se o livro não existir, será criado automaticamente também.
• Número: O número da canção - numérico. Use para hinos, anos, etc. Você pode ordenar canções pelo número como referência.
• Fluxo: O arranjo das secções. - lista de etiquetas de secção. Consulte Fluxo para detalhes sobre como arranjar o fluxo de uma canção.
• MIDI: Os comandos MIDI a enviar quando a canção é visualizada. Consulte Sintaxe MIDI para como expressar comandos MIDI como texto em OnSong.
• MIDI-Index: Os comandos MIDI que acionarão a abertura desta canção no Visualizador de Canções. Consulte Sintaxe MIDI para como expressar comandos MIDI como texto em OnSong.
• Palavras-chave: ou Tópico: A lista de etiquetas a usar com a busca de tópicos. Consulte Tópicos para mais informações sobre a navegação por tópico.
• Direitos de Autor: ou Rodapé: ou f: A informação de direitos de autor da canção. Isto aparecerá na parte inferior do diagrama de acordes e projecção de letras.
• CCLI: O número CCLI da canção. Isto aparecerá na parte inferior do diagrama de acordes e projecção de letras.
• Restrições: Estas são restrições que impedem certas acções de ocorrer dentro de uma canção. Consulte Restrições para detalhes sobre como definir restrições para a sua canção.
• Tom: A nota ou notas a tocar quando utilizar a funcionalidade Tubo de Tom. Isto é definido como uma lista de notas separadas por espaço com oitavas opcionais. - por ex. A3 C#4 E5
• Subdivisão: ou Batimento: permite escolher a subdivisão para a canção. Isto pode ser um valor incluindo: whole, half, quarter, eighth, shuffle, ou sixteenth. Em alternativa pode usar um número inteiro como 1, 2, 4, 8, ou 16.
• Transpor: O número de semitons a transpor a canção. Isto é utilizado a meio da canção para modular a canção para cima ou para baixo e adapta-se com a tonalidade definida nos controlos deslizantes de transposição. Este número deve ser um inteiro positivo ou negativo.
• Cena: A cena a ser executada quando a canção é carregada. Isto pode ser definido inserindo o nome da cena após o dois pontos.

Etiquetas Inline

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

• Capotrasto: pode ser utilizado para aplicar um capotrasto a meio da canção, modulando a canção para baixo para fornecer acordes a tocar com o capotrasto aplicado. Você pode ajustar a direcção da 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 canção. Se rodear o valor com parênteses quando usar acordes entre parênteses, a tonalidade resultante também será transposta. - alfabético, por ex. Bb ou Em
• Transpor: transpõe a canção o número desejado de semitons. Isto é um inteiro positivo ou negativo. Por exemplo, use 2 ou +2 para transpor a canção para cima um tom inteiro, ou use -3 para transpor para baixo três semitons. - numérico

Etiquetas de Secção

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

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

Nota: Os Metatags não diferenciam maiúsculas de minúsculas