ChordPro

O formato de arquivo ChordPro é um formato comum usado em outros aplicativos de software. OnSong compreende este formato nativamente. OnSong reconhece arquivos com as seguintes extensões de arquivo: .chordpro, .chopro, .cho, .crd, .pro

O formato ChordPro permite que as informações da música sejam expressas em tags delimitadas por chaves. Estas informações podem ser divididas logicamente em tags de metadados e tags inline.

Tags de Metadados

Estas são tags ChordPro que você usaria na porção de metadados da música. Nas tags a seguir, três pontos (...) representam o texto que você fornece, que fica entre os dois pontos e a chave de fechamento. Por exemplo:

{title: Amazing Grace}
{key: G}

OnSong suporta as seguintes tags ChordPro:

• {title: ...} ou {t: ...} O título da música.
• {subtitle: ...}, {st: ...} ou {su: ...} O nome do artista ou qualquer outra informação de assinatura. Você pode especificar vários artistas separando os nomes com um ponto e vírgula. - Kim Walker-Smith; Chris Quilala
• {album: ...} O nome do álbum onde a música está localizada.
• {artist: ...} ou {a: ...} O nome do artista ou qualquer outra informação de assinatura. 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. Isto é exibido na parte inferior do gráfico de acordes e na projeção de letras.
• {key: ...} ou {k: ...} ou {ok: ...} A tonalidade da música escrita como uma tonalidade com preferência enarmônica e um opcional "m" para indicar menor. - alfabético, por ex. Bb ou Em
• {capo: ...} O capotraste a ser definido como número de trastes - numérico
• {tempo: ...} Os batimentos por minuto (BPM) - numérico
• {time: ...} A assinatura de tempo - batida numérica sobre compasso, por ex. 3/4
• {duration: ...} O comprimento da música para rolagem automática - segundos ou mm:ss
• {book: ...} 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.
• {number: ...} O número da música - numérico, use para hinos, anos, etc. Você pode classificar músicas pelo número para referência.
• {flow: ...} O arranjo de seções - lista de rótulos de seções. Veja Fluxo para detalhes sobre como arranjar o fluxo de uma música.
• {midi: ...} Os comandos MIDI a enviar quando a música é visualizada. Veja Sintaxe MIDI para saber como expressar comandos MIDI como texto em OnSong.
• {midi-index: ...} Os comandos MIDI que acionarão a abertura desta música no Visualizador de Música. Veja Sintaxe MIDI para saber como expressar comandos MIDI como texto em OnSong.
• {pitch: ...} As notas a tocar ao usar o recurso Afinador.
• {keywords: ...} ou {topic: ...} A lista de tags para usar com busca por tópico. Veja Tópicos para mais informações sobre navegação por tópico.
• {copyright: ...} ou {footer: ...} ou {f: ...} Especifica o texto do rodapé de direitos autorais a aparecer na parte inferior da página ou projeção de letras.
• {ccli: ...} O número CCLI da música.
• {restrictions: ...} O gerenciamento de direitos da música, lista delimitada por vírgulas de restrições. Veja Restrições para detalhes sobre como definir restrições para sua música.
• {composer: ...} Os indivíduos que compuseram a música. Esta lista deve ser separada com ponto e vírgula para valores separados.
• {lyricist: ...} Os indivíduos que escreveram a letra da música. Esta lista deve ser separada com ponto e vírgula para valores separados.

Tags Inline

Estas tags são usadas dentro do conteúdo da música e podem ser usadas para definir seções ou formatar partes da música.

• {define: ...} é usado para definir diagramas de acordes personalizados. Veja Definindo Acordes para mais informações.
• {comment: ...} ou {c: ...} Define um comentário e aparece como uma instrução musical.
• {comment_bold: ...} ou {cb: ...} Define o texto a aparecer em negrito.
• {comment_italic: ...} ou {ci: ...} Define o texto a aparecer em itálico.
• {guitar_comment: ...} ou {gc: ...} Define um comentário que aparece como uma instrução musical.
• {start_of_verse: ..} ou {sov} Declara o início de uma seção de verso com um rótulo de seção opcional.
• {end_of_verse} ou {eov} Declara o fim de uma seção de verso.
• {start_of_chorus: ...} ou {soc} Declara o início de uma seção de refrão com um rótulo de seção opcional.
• {end_of_chorus} ou {eoc} Declara o fim de uma seção de refrão.
• {start_of_bridge: ...} ou {sob} Declara o início de uma seção de ponte com um rótulo de seção opcional.
• {end_of_bridge} ou {eob} Declara o fim de uma seção de ponte.
• {start_of_part: ..} ou {sop} Declara o início de uma parte com um rótulo de seção opcional.
• {end_of_part} ou {eop} Declara o fim de uma parte.
• {start_of_tab} ou {sot} Declara o início da tablatura que OnSong renderiza em uma fonte monoespaçada.
• {end_of_tab} ou {eot} Declara o fim de uma seção de tablatura.
• {new_page} ou {np} Isto é usado para declarar uma nova página.
• {new_physical_page} ou {npp} Isto é usado para declarar uma nova página.

Tags de Formatação

As seguintes tags são usadas para definir a fonte padrão e o tamanho das letras e acordes no gráfico de acordes.

• {textsize: ...} Define o tamanho da letra como um valor numérico em pontos.
• {textfont: ...} Define o nome da fonte a usar para a letra. Deve ser suportado na plataforma.
• {chordsize: ...} Define o tamanho dos acordes como um valor numérico em pontos.
• {chordfont: ...} Define o nome da fonte a usar para acordes. Deve ser suportado na plataforma.

Extensões de Arquivo Suportadas

O formato de arquivo ChordPro é único no sentido de que é uma sintaxe comumente acordada, mas não um formato padrão. Isto significa que vários fornecedores podem implementá-lo de diferentes formas e com diferentes extensões de arquivo. OnSong suporta as seguintes extensões de arquivo ao importar arquivos formatados em ChordPro:

• .chopro
• .cho
• .chordpro
• .crd
• .pro
• .cpm