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: