HudLac

abcm2ps – Características

Documentação de abcm2ps (caracter.txt)


Documentação de abcm2ps (caracter.txt)


	Features of abcm2ps 5.9.0 (J.F. Moine, September 2008)
	======================================================

	       Características de abcm2ps 5.9.0 [5.9.6]
	       ========================================
      Tradução de 'features.txt' por Hudson Lacerda (rev. 31-01-2009)

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), caso uma peça comece 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 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 ']'), 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 '[' e ']') é 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 por exemplo)
		+xstem+		desenha uma haste para cima até a nota
				da pauta anterior.
		!+!		o mesmo que +plus+
		+/+ .. +///+	tremolo sobre uma nota

	- 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', ';'. Nesse caso,
	  as linhas são do mesmo tipo (acorde cifrado ou anotação).
		"_ann1" "_ann2" "G3" "4" G
		"_ann1;ann2" "G3;4" G
		"_ann1\nann2" "G3\n4" 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').

	- O nome da clave pode ser delimitado por aspas duplas, caso
          em que ele é o nome de uma função PostScript que desenhará a
          clave. Os argumentos dessa função são as coordenadas x e y.

Vozes múltiplas.

	- 'stem=auto' e 'gstem=auto' em um campo 'V' reabilita a
	   computação automática da direção das hastes (valores
	   default).

	- 'gstem=up' ou 'gstem=down' em um campo 'V' força a direção
	  das hastes das notinhas (grace notes).

	- 'gchord=up' (default) or 'gchord=down' em um campo V força a
          exibição de acordes cifrados acima ou abaixo da pauta.

	- '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).

	- 'stafflines=<value>' em um campo V determina o número de
          linhas da pauta associada. O valor default é '5'.

	- '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.


Copyright (C) 2004-2009 Hudson Lacerda

This document is based on abcm2ps:
Copyright (C) 1998-2009 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-2009 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.

(Hudson Lacerda)



Anúncios

Deixe um comentário »

Nenhum comentário ainda.

RSS feed for comments on this post.

Deixe um comentário

Preencha os seus dados abaixo ou clique em um ícone para log in:

Logotipo do WordPress.com

Você está comentando utilizando sua conta WordPress.com. Sair / Alterar )

Imagem do Twitter

Você está comentando utilizando sua conta Twitter. Sair / Alterar )

Foto do Facebook

Você está comentando utilizando sua conta Facebook. Sair / Alterar )

Foto do Google+

Você está comentando utilizando sua conta Google+. Sair / Alterar )

Conectando a %s

Blog no WordPress.com.