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: .chordpro, .chopro, .cho, .crd, .pro

O formato ChordPro permite que informações de música sejam expressas em tags delimitadas por chaves. Essas 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 linha de crédito. Você pode especificar vários artistas separando os nomes com 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 linha de crédito. Você pode especificar vários artistas separando os nomes com ponto-e-vírgula. - Kim Walker-Smith; Chris Quilala
• {author: ...} O nome da pessoa que criou o diagrama de acordes. Isto é exibido na parte inferior do diagrama 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 "m" opcional para indicar menor. - alfabético, p. 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, p. ex. 3/4
• {duration: ...} A duração da música para o deslocamento automático - segundos ou mm:ss
• {book: ...} O nome do livro ou livros nos quais colocar a música. Esta é uma lista delimitada por vírgula 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 músicas pelo número para referência.
• {flow: ...} O arranjo de seções - lista de rótulos de seção. Veja Fluxo para detalhes sobre como organizar 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úsicas. Veja Sintaxe MIDI para saber como expressar comandos MIDI como texto em OnSong.
• {pitch: ...} As notas a tocar ao usar o recurso Diapasão.
• {keywords: ...} ou {topic: ...} A lista de tags a usar com busca por tópico. Veja Tópicos para mais informações sobre como navegar por tópico.
• {copyright: ...} ou {footer: ...} Especifica texto de rodapé de copyright a aparecer na parte inferior da página ou projeção de letras.
• {ccli: ...} O número CCLI da música.
• {restrictions: ...} A gestão de direitos da lista de restrições delimitada por vírgula da música. Veja Restrições para detalhes sobre como definir restrições para sua música.

Tags Inline

Essas tags são usadas dentro do conteúdo da música e podem ser usadas para definir seções ou para 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 texto a aparecer em negrito.
• {comment_italic: ...} ou {ci: ...} Define 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 de uma tablatura que OnSong renderiza em uma fonte monoespacial.
• {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 da letra e acordes no diagrama 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 suportada 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 suportada na plataforma.

Extensões de Arquivo Suportadas

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

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