Features of abcm2ps 5.4.1 (J.F. Moine, April 2007) ================================================== Características de abcm2ps 5.4.1 [5.4.3] ================================ Tradução de 'features.txt' por Hudson Lacerda (rev. 09-06-2007) abcm2ps procura seguir o padrão ABC versão 2.0: http://abc.sourceforge.net/standard/abc2-draft.html Aqui estão listadas somente as diferenças em relação à minuta IV (14/8/2003) desse padrão. Características não implementadas ================================= Campos de informação. - Os campos %%abc-xxx (exceto %%abc-version) são ignorados. Corpo da peça (tune body). - As seguintes decorações não estão implementadas: +dacoda+, +dacapo+ - Campos 'U' não podem conter acordes cifrados (guitar chords) nem anotações. - +none+ e +nil+ não funcionam. - Os valores atribuídos pelo campo 'U' são sempre globais (não são restaurados ao final de uma peça). Vozes múltiplas. - O operador '&' não funciona nos campos 'w' e 's'. Características que funcionam de maneira diferente ================================================== Estrutura de arquivo. - O campo de cabeçalho 'X' pode ser omitido em livros de peças (tunebooks), com as peças começando com um campo de cabeçalho 'T'. - O campo de cabeçalho 'T' pode ser omitido (quando 'X' estiver presente). - Não existe a noção de 'cabeçalho de arquivo': qualquer campo ABC válido encontrado fora das peças é considerado global, e aplica-se às peças remanescentes. - Quando %%abc-version é menor que '2.0', uma barra invertida como último caractere de uma linha significa 'concatene a próxima linha do mesmo tipo com esta linha'. Isso funciona somente para linhas de música e para os campos 'd', 's' e 'w'. Em uma linha de música, isso impede quebra de linha. Exemplo: DEF|\ M:C GABc| w:bla bla bla\ %%vocalfont Times-Roman 14 w:bla bla bla bla Também: gf|e2dc B2A2|B2G2 E2D2|.G2.G2 GABc|d4 B2 w: Sa-ys my au-l' wan to your aul' wan\ Will~ye come to the Wa-x-ies dar-gle? não funciona. Campos de informação. - No corpo de uma peça, as linhas que começam com uma letra no intervalo A-G ou a-g imediatamente seguida por dois pontos são interpretadas como campos de informação. - Quando %%abc-version for menor que '2.0', o campo 'A' será 'Área', e não 'Autor da letra'. Ele é mostrado somente com 'infoline'. - Em um campo 'K', quando utilizado, a lista de acidentes sempre substitui os acidentes da armadura de tonalidade (como se 'exp' estivesse presente). - Em campos 'K', a lista de acidentes pode ser 'none' (para nenhum acidente). - Quando um campo 'K' ou 'M' for encontrado dentro de uma peça, na primeira voz, sozinho em uma linha (não delimitado por '[' / ']'), e quando a voz é vazia, ele será aplicado a todas as vozes. Corpo da peça. - Algumas barras de compasso são desenhadas conforme definidas (ex: ':|:'), algumas outras são expandidas, como '|::' para '[|::'. - '@' em anotações deve ser seguido pelos deslocamentos <x> e <y> do texto em relação à posição da nota (em pontos). Os valores <x> e <y> são separados por uma vírgula, e <y> pode ser seguido por um espaço (útil se o texto começa com um dígito, um ponto ou pelas letras 'E' ou 'e' - veja sample3.abc para um exemplo). - Notinhas (grace notes) podem aparecer antes de qualquer símbolo e podem conter acordes. Sua duração pode ser controlada. A unidade de valor não é ligada a (L:) ou (M:). Ao invés disso, para compatibilidade, é: - uma colcheia para uma única nota e uma semicolcheia para muitas notas em peças padrão, - uma fusa em peças de gaita de foles (bagpipe tunes). Notinhas (grace notes) de duração maior que semínima serão desenhadas como semínimas. - Quiálteras podem ter valores maiores que 9. - Quiálteras podem ser aninhadas. Claves. - Quando 'clef=' estiver presente, o nome da clave poderá ser uma nota com sua altura. A nota pode ser somente 'G' (clave de sol), 'C' (clave de dó) ou 'F' (clave de fá). A altura define a nota na linha da clave. As duas definições seguintes são equivalentes: K: clef=f K: bass middle=d Vozes múltiplas. - O campo de informação 'P' dentro de uma peça e sozinho em uma linha (não delimitado por '[' / ']') é definido na primeira voz, sem alterar a voz corrente. Formato de dados. - As seqüências especiais de caracteres dependem da codificação. Somente ISO-Latin 1 a 6 são suportadas. A codificação é definida por '-L' ou %%encoding. - A mudança de fonte ($n em strings) não funciona em todos os casos. ABC Stylesheet specification. [Diretivas para formatação/'layout' de partitura] - '%%staves' coexiste com '%%score'. As diferenças em '%%staves' são: - barras de compasso são desenhadas entre as pautas quando não há '|' entre os nomes das vozes (esse recurso é invertido em %%score). - Uma voz móvel (flutuante) pode ser somente a segunda em uma chave (brace) abarcando três vozes. - Algumas diretivas de formatação não estão implementadas, e algumas novas são definidas. Veja o arquivo 'formato.txt' ('format.txt') para detalhes. Extensões ========= Estrutura de arquivo. - Linhas que começam com '\' são ignoradas (compatibilidade com abc2mtex). Campos de informação. - O campo 'M' pode especificar metros mais complexos com uma combinação de dígitos, parênteses, barras e espaços. Pode também especificar metros antigos como 'M:2', 'M:3', e ainda 'M:o' (perfeito menor), 'M:o.' (perfeito maior), 'M:c' (imperfeito menor) e 'M:c.' (imperfeito maior). Uma duração explícita para o compasso pode ser especificada colocando seu valor após um sinal de '=' (ex.:'M:C|=2/1'). - O campo 'Q' pode conter texto, o qual é escrito antes e/ou depois da definição do tempo. O valor do tempo pode ser qualquer string. O valor do tempo pode ser uma figura de duração (como '1/4'). A unidade e o tempo podem ser omitidos. Pode haver até 4 unidades. Ex: Q: "string before" 1/4 3/8 1/4 3/8=40-50 "string after" - O campo 'd' é o mesmo que 's' (linha de símbolos). Corpo da peça. - Alturas microtonais são indicadas por uma fração depois de um acidente, como "^3/4c". Quando omitido, o numerador é definido como 1 e o denominador como 2 ("^/c" é o mesmo que "^1/2c"). O numerador e o denominador não podem ser maiores que 256. Existe suporte para sustenidos e bemóis 1/2 e 3/2. Para outros valores, funções PostScript devem ser definidas (através de %%postscript). O nome de uma tal função é: <accidental_type><micro_value> onde - <accidental_type> é "sh" (sustenido) ou "ft" (bemol) (ou ainda "nt", "dsh" ou "dft" !) - <micro_value> é computado da fração como: ( <numerador> - 1 ) * 256 + <denominador> - 1 - Uma duração começada por '0' (zero) indica uma semínima sem haste (a duração deve ser uma semínima). - Um espaço ('y') pode ser seguido por uma largura em pontos. O valor "default" é 20 pontos. - '[]' é o mesmo que '[|]' (barra de compasso invisível). - ':' (dois pontos sozinhos) é o mesmo que '.|' (barra de compasso pontilhada). - Barras de repetição (ritornelos ou voltas) podem conter um grupo de dígitos, '-' (hífen), ',' (vírgula) ou '.' (ponto), ou ainda uma string livre. Ex: |: ... [1,3 ... :|2,4-6 :|["\'ultima vez" ... (note que um '[' é necessário antes da string - ela pode ser vazia). - ']' indica o fim explícito de uma seção de repetição. Ele pode ser usado como uma barra invisível. - Pode haver ligaduras de fraseado (slurs) de notas para notinhas (grace notes) e vice-versa. - O ínicio das ligaduras de fraseado (slurs) pode ser seguido por "'" ou "," para forçar sua direção (acima ou abaixo). - O caractere de ligadura de prolongamento ("-") pode ser seguido por "'" ou "," para forçar a direção da ligadura (acima ou abaixo). - As seguintes decorações são adicionadas: +beambr1+ e +beambr2+ deixa somente 1 ou 2 colchetes desde a nota anterior +beamon+ não quebra o travessão (em uma barra de compasso) +gmark+ grace mark (ornamento "~") +invisible+ impede que uma nota seja mostrada +rbstop+ interrompe aqui a casa de repetição atual +trem1+ .. +trem4+ tremolo (na segunda nota de um par - ver sample4.abc para um exemplo) +xstem+ desenha uma haste para cima até a nota da pauta anterior. !+! o mesmo que +plus+ - Pode haver decorações em notas dentro de acordes. Tais decorações não podem ser as comuns, elas devem ser definidas por %%deco e %%postscript (não há controle). - Pode haver decorações em notinhas (grace notes). - Linhas múltiplas de acordes cifrados (guitar chords) / anotações podem ser indicadas por '\n', ';' ou uma nova linha dentro da string delimitada por aspas duplas. Ex: "G3""4"G "G3\n4"G "G3;4"G "G3 4"G - Anotações podem conter '\#', '\b' e '\=' para mostrar acidentes. - Strings com codificação ISO latin podem conter '\201', '\202' e '\203' para mostrar acidentes. Claves. - 'clef=P' é o mesmo que 'perc'. - Quando a clave for 'perc' (ou 'P'), acidentes mudam a forma da cabeça da nota. Por "default", notas sustenidas são desenhadas como um 'x' e notas bemolizadas como um 'x' circulado. Esse comportamento pode ser modificado redefinindo as funções PostScript 'pshhd' e 'pfthd' ou definindo 'pnthd' (bequadro), 'pdshhd' (dobrado sustenido) e + 'pdfthd' (dobrado bemol). - Quando não há clave especificada, a clave muda automaticamente quando necessário ('bass' ou 'treble'). - Quando a clave for 'bass' ou 'alto', para compatibilidade com abc2ps, abcm2ps varre o início da peça para ver se alguma transposição foi aplicada. Se a opção CLEF_TRANSPOSE foi definida durante a geração de abcm2ps, transposição à maneira de abc2ps sempre ocorre. Vozes múltiplas. - 'gstem=up' ou 'gstem=down' em um campo 'V' força a direção das hastes das notinhas (grace notes). - 'stem=auto' e 'gstem=auto' em um campo 'V' reabilita a computação automática da direção das hastes (valores default). - 'dyn=up', 'dyn=down' ou 'dyn=auto' em um campo V: força posição dos sinais de dinâmica (acima ou abaixo da pauta - default é auto). - 'lyrics=up', 'lyrics=down' ou 'lyrics=auto' em um campo V: força o posicionamento das letras de música (acima ou abaixo da pauta - default é auto). - 'staffscale=<value>' em um campo V define a dimensão da pauta associada. O valor default é '1'. - 'merge' em um campo 'V' faz com que a voz fique na mesma pauta que a voz anterior (compatibilidade com BarFly). - A mudança de voz dentro de uma peça de acordo com a sintaxe usada por BarFly ('V:x <notas>', ou seja: voz + notas na mesma linha) pode funcionar. - O operador '(&...&...&)' permite superposição de vozes em muitos compassos. Ver sample3.abc para exemplo. Sintaxe ABC obsoleta [Deprecated ABC syntax]. - Admite-se a sintaxe ABC obsoleta.
This document is based on abcm2ps: Copyright (C) 1998-2007 Jean-François Moine, adapted from abc2ps-1.2.5: Copyright (C) 1996,1997 Michael Methfessel. Released under the terms of the GNU General Public License, Version 2.
Este documento é baseado em abcm2ps: Copyright (C) 1998-2007 Jean-François Moine, por sua vez adaptado de abc2ps-1.2.5: Copyright (C) 1996,1997 Michael Methfessel. Distribuído segundo os termos da Licença Pública Geral do GNU, Versão 2.
A versão mais recente deste documento pode ser obtida em: