
@@LEIA-ME
$
		       Parmetros de Formatao
		       =======================
	Traduo de 'format.txt' por Hudson Lacerda (09-06-2007)
			   (abcm2ps 5.4.3)

O 'layout' geral das partituras impressas pode ser alterado de quatro
maneiras:

	1- no momento da compilao, definindo os valores em abc2ps.h;
	2- no momento da execuo, com um arquivo de 'formatao';
	3- ao incio da execuo, na linha de comando;
	4- por meio de pseudo-comentrios dentro do arquivo fonte ABC.

Para mais informaes sobre 3), veja o arquivo 'opes.txt'
('options.txt').

Um arquivo de formatao contm linhas definindo os valores dos
parmetros, de acordo com a sintaxe:

	parmetro [lista de parmetros]

Em um arquivo de formatao, linhas vazias e linhas que comeam com
'#' so ignoradas.

Os pseudo-comentrios usados para formatao tm a seguinte forma:

	%%parmetro [lista de parmetros]

Parmetros de formatao podem aparecer na linha de comando da
seguinte maneira:

	--parmetro [lista de parmetros]

Alguns pseudo-comentrios so tratados na fase de processamento do
arquivo ABC ('while being parsed') e no podem aparecer em um arquivo
de formatao nem na linha de comando. Eles so listados ao final
deste arquivo.

Em definies de fontes, <font>, <encoding> e <size> podem ser
especificados como '*' (asterisco), caso em que a fonte, codificao
ou tamanho permanece sem alterao. Quando <encoding>  omitido, a
codificao global (ver 'encoding') ou a ltima codificao da mesma
fonte  utilizada.


Lista dos parmetros de formatao
----------------------------------

 
$
@@abc2pscompat
$
abc2pscompat

abc2pscompat <bool>
	Default: 0
	Compilao: nenhum
	Linha de comando: -u
	Descrio:
		Quando ativado, define 'M' como a decorao +tenuto+
		e realiza transposio (em oitavas) se as notas forem
		muito altas para uma clave de f.

 
$
@@alignbars
$
alignbars

alignbars <int>
	Default: 1
	Compilao: nenhum
	Linha de comando: nenhum
	Descrio:
		Alinha os compassos das prximas <int> linhas de
		msica. Esse alinhamento funciona somente quando h
		somente uma voz nas linhas de msica (no so
		permitidos V:, %%staves ou %%score).

 
$
@@aligncomposer
$
aligncomposer

aligncomposer <int>
	Default: 1
	Compilao: nenhum
	Linha de comando: nenhum
	Descrio:
		Diz onde mostrar o campo 'compositor'.
		Um valor negativo significa 'na esquerda', 0 significa
		'centralizado' e um valor positivo significa 'na
		direita'.

 
$
@@annotationfont
$
annotationfont

annotationfont <font> [<encoding>] [<size>]
	Default: Helvetica 12
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a fonte usada em anotaes como <font> de
		tamanho <size>.

 
$
@@autoclef
$
autoclef

autoclef <bool>
	Default: 1
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Quando verdadeiro, define as claves e possivelmente insere
		mudanas de clave se nenhuma clave for definida no campo
		K: ou V:.

 
$
@@barnumbers
$
barnumbers

barnumbers <int>
	Mesmo que 'measurenb'.

 
$
@@barsperstaff
$
barsperstaff

barsperstaff <int>
	Default: 0
	Compilao: nenhum
	Linha de Comando: -B<int>
	Descrio:
		Tenta dispor <int> compassos em cada linha.

 
$
@@beginps
$
beginps

beginps
	Default: nenhum
	Compilao: nenhum
	Linha de comando: nenhum
	Descrio:
		Inicia uma seqncia PostScript que termina em
		'endps'.  Esse parmetro pode ser usado somente em um
		arquivo de formatao ou arquivo ABC (ele no pode
		aparecer na linha de comando).
		Cada linha entre 'beginps' e 'endps'  includa no
		arquivo PostScript de sada.

 
$
@@botmargin
$
botmargin

botmargin <unit>
	Default: 1cm
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a margem inferior como <unit>.

 
$
@@bstemdown
$
bstemdown

bstemdown <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Quando esta opo  definida como 'true' ou '1', a
		nota do meio da pauta  desenhada com haste para
		baixo. Seno, a haste vai para cima ou para baixo de
		acordo com a nota anterior.

 
$
@@comball
$
comball

comball <bool>
	Default: 0
	Compilao: nenhum
	Linha de comando: nenhum
	Descrio:
		Quando 'combinevoice' est ativado, combinao de
		vozes no ocorre quando as alturas formam uma segunda,
		unssono ou esto invertidas.
		Ativar essa opo faz a combinao ocorrer em todos os
		casos.

 
$
@@combinevoices
$
combinevoices

combinevoices <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Se 1, as notas de mesma durao pertencentes a vozes da
		mesma pauta so combinadas formando acordes.

 
$
@@composerfont
$
composerfont

composerfont <font> [<encoding>] [<size>]
	Default: Times-Italic 14
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a fonte do campo 'compositor' [C:] como <font>
		de tamanho <size>.

 
$
@@composerspace
$
composerspace

composerspace <unit>
	Default: 0.2cm
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define o espao vertical antes do compositor como <unit>.

 
$
@@contbarnb
$
contbarnb

contbarnb <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Se for 0, nmero de compasso em repeties [casa 2] ser
		o mesmo da primeira vez [casa 1].
		Se for 1, os compassos sero numerados seqencialmente.

 
$
@@continueall
$
continueall

continueall <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: -c
	Descrio:
		Ignora quebras de linha se for 'true' ('1').

 
$
@@dateformat
$
dateformat

dateformat <text>
	Default: "\%b \%e, \%Y \%H:\%M"
 	Compilao: nenhum
 	Linha de comando: nenhum
 	Descrio:
		Define o formato da data e da hora.
		Os valores possveis desse parmetro so descritos
		nas pginas de manual de date(1) e strftime(3).
		Nota: o '%' deve ser escapado como '\%'.

 
$
@@deco
$
deco

deco <name> <c_func> <ps_func> <h> <wl> <wr> [<str>]
	Default: nenhum
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define uma decorao.
		!! ESTE  UM RECURSO EXPERIMENTAL QUE EST SUJEITO A
		MUDANAS NAS PRXIMAS VERSES E EXIGE UM BOM
		CONHECIMENTO DO INTERIOR DE abcm2ps - VEJA deco.abc
		PARA EXEMPLOS !!
		Os argumentos atuais so:
		<name>: nome da decorao. Se for o nome de uma
		decorao pr-existente, ela ser redefinida.
		<c_func>: ndice de uma funo C (definida em deco.c).
			Os valores possveis so:
			0, 1, 2: decorao prxima  nota, dentro da pauta.
				0: 'dot' e 'tenuto'
				1: 'slide'
				2: 'arpeggio'
			3, 4, 5: decorao prxima  nota, fora da
		pauta, geralmente impressa acima da pauta.
				3: geral
				4: abaixo da pauta
				5: trinado longo (long 'trill') (com
				nicio e fim)
			6, 7: decorao associada  pauta, geralmente
			      impressa abaixo da pauta.
				6: geral
				7: sinais longos de dinmica (com incio e fim)
		<ps_func>: nome da funo postscript ou '-' para
		        nicio de uma decorao longa.
		<h>: altura da decorao.
			Para +arpeggio+  a altura mnima.
		<wl> e <wr>: largura  esquerda e  direita.
			     Esses valores so atualmente usados para smbolos
			     gerais de dinmica somente.
		<str>: texto a ser mostrado (para algumas funes postscript
			     - veja o cdigo).
		Decoraes cujos nomes comeam com 'head-' impedem que
		a cabea da nota seja desenhada (ou as cabeas, em um
		acorde).

 
$
@@dynalign
$
dynalign

dynalign <bool>
	Default: 1
	Compilao: nenhum
	Linha de comando: nenhum
	Descrio:
		Quando verdadeiro, alinha horizontalmente os sinais de
		dinmica.

 
$
@@encoding
$
encoding

encoding <encoding> | <int>
	Default: 0
	Compilao: nenhum
	Linha de Comando: -L<int>
	Descrio:
		Define a codificao global da fonte como <encoding>,
		ou como 'Latin<int>'.
		As codificaes reconhecidas so:
			us-ascii
			iso-8859-1	(Latin1)
			iso-8859-2	(Latin2)
			iso-8859-3	(Latin3)
			iso-8859-4	(Latin4)
			iso-8859-9	(Latin5)
			iso-8859-10	(Latin6)
			native
		Quando a codificao  nativa ('native'), os vetores
		de codificao das fontes no so alterados.
		<encoding> pode ser qualquer string. Nesse caso, o
		vetor de codificao deve ser definido por uma
		seqncia de comandos 'postscript'.

		<int> pode tomar os valores de '0' a '6'. O valor '0'
		 o mesmo que '1', mas o vetor de codificao
		PostScript para 'ISOLatin1Encoding' no  enviado para
		a sada.

 
$
@@exprabove
$
exprabove

exprabove <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Desenha as decoraes de expresso [dinmica] acima da
		pauta.  Quando ambos 'exprabove' e 'exprbelow' so
		'false' ('0'), as decoraes de expresso so
		desenhadas acima da pauta se houver letras de msica
		('lyrics') na pauta, e abaixo em caso
		contrrio. 'exprabove' toma precedncia sobre
		'exprbelow'.

 
$
@@exprbelow
$
exprbelow

exprbelow <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Desenha as decoraes de expresso [dinmica] abaixo da
		pauta.
		Quando ambos 'exprabove' e 'exprbelow' so 'false'
		('0'), as decoraes de expresso so desenhadas acima
		da pauta se h letras de msica ('lyrics') na pauta, e
		abaixo em caso contrrio. 'exprabove' toma precedncia
		sobre 'exprbelow'.

 
$
@@flatbeams
$
flatbeams

flatbeams <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: -f
	Descrio:
		Usa travesses ('beams') retos em msicas de
		gaita-de-foles ('bagpipe tunes').

 
$
@@font
$
font

font <font> [<encoding>]
	Default: nenhum
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define uma fonte e sua codificao.
		Esse parmetro  requerido quando fontes especficas
		so definidas posteriormente em arquivos/peas ABC, e
		devem ser redefinidas antes que qualquer sada
		PostScript seja feita, geralmente em um arquivo de
		formatao.
		Quando ausente, <encoding> segue o parmetro de
		codificao 'encoding' corrente (ver acima).

 
$
@@footer
$
footer

footer <text>
	Default: nenhum
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define o texto a ser impresso no p de cada pgina
		[rodap].
		Pode haver uma ou duas linhas. Duas linhas devem ser
		separadas pelos 2 caracteres "\n" (e no por uma
		verdadeira 'nova linha').
		Em cada linha, 3 reas podem ser definidas: esquerda,
		centro e direita.
		Essas reas so separadas por tabulaes (TABs reais,
		no '\t') e podem ser vazias (se a rea esquerda for
		vazia, a string deve ser delimitada por aspas duplas -
		veja sample3.abc para exemplo).
		O caracter '$' introduz expanso varivel:
			- '$d'  a data e hora da ltima modificao
			  do arquivo de entrada (ABC) corrente,
			- '$D'  a data e hora atual,
			- '$F'  o nome do arquivo de entrada atual,
			- '$Ix'  qualquer campo de informao de
 
$
@@
$


                        cabealho ('x'  uma letra de 'A' a 'Z').
			- '$P'  o nmero da pgina atual,
			- '$P0' e '$P1' tambm so o nmero de pgina,
			   mas somente quando ela  par ('0') ou mpar ('1'),
			- '$T'  o ttulo da pea atual,
			- '$V'  'abcm2ps-' seguido pela verso do
			   programa.
		Por exemplo, a opo de linha de comando '-N3'  o
		mesmo que:
			%%header "$P0		$P1"
		(note as 2 TABs).
		Se o rodap (footer) ou cabealho (header) comea com
		'-' (hfen/menos), ele no  impresso na primeira
		pgina.

 
$
@@footerfont
$
footerfont

footerfont <font> [<encoding>] [<size>]
	Default: Times-Roman 12
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a fonte de rodap ('footer') como <font>
		de tamanho <size>.
		Note que o rodap no  afetado por 'scale'.

 
$
@@format
$
format

format <nomedoarquivo>
	Default: nenhum
	Compilao: nenhum
	Linha de comando: nenhum
	Descrio:
		L o arquivo de formatao (ou PostScript) <nomedoarquivo>.
		Quando encontrado na linha de comando, esse parmetro
		 o mesmo que '-F'.

 
$
@@freegchord
$
freegchord

freegchord <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Impede os caracteres '#', 'b' e '=' de serem mostrados
		como sustenido, bemol e bequadro em acordes cifrados
		('guitar chords').
		Quando este sinalizador  definido ('1'), acidentes
		podem ser mostrados atravs de seqncias de escape
		('\#', '\b' e '\=').

 
$
@@gchordbox
$
gchordbox

gchordbox <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Desenha uma caixa em torno dos acordes cifrados.
		Esse valor pode ser definido como 'true' atravs de
		%%gchordfont.

 
$
@@gchordfont
$
gchordfont

gchordfont <font> [<encoding>] <size> [box]
	Default: Helvetica 12
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a fonte usada em acordes cifrados ('guitar
		chords') como <font> de tamanho <size>.
		Se 'box' est presente, desenha uma caixa em torno das
		cifras.

 
$
@@graceslurs
$
graceslurs

graceslurs <bool>
	Default: 1
	Compilao: nenhum
	Linha de Comando: -G
	Descrio:
		Desenha ligaduras ('slurs') em notinhas ('grace notes').

 
$
@@gracespace
$
gracespace

gracespace <float> <float> <float>
	Default: 6.5 8.0 12.0
	Compilation: none
	Command line: none
	Description:
		Define o espao antes, entre e aps notinhas (grace
		notes).

 
$
@@header
$
header

header <text>
	Default: nenhum
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define o texto mostrado no topo de cada pgina
		[cabealho].
		Veja 'footer' acima para a sintaxe do cabealho.

 
$
@@headerfont
$
headerfont

headerfont <font> [<encoding>] [<size>]
	Default: Times-Roman 12
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a fonte de cabealho como <font> de tamanho
		<size>.
		Note que o cabealho no  afetado por 'scale'.

 
$
@@historyfont
$
historyfont

historyfont <font> [<encoding>] [<size>]
	Default: Times-Roman 16
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a fonte do texto do 'histrico' como <font> de
		tamanho <size>.

 
$
@@hyphencont
$
hyphencont

hyphencont <bool>
	Default: 0
	Compilao: nenhum
	Linha de comando: nenhum
	Descrio:
		Quando uma letra de msica (`lyric') sob a pauta
		termina com um hfen, coloca um hfen na linha
		seguinte.

 
$
@@indent
$
indent

indent <unit>
	Default: 0
	Compilao: nenhum
	Linha de Comando: -I<unit>
	Descrio:
		Recua a primeira linha de uma pea por <unit>.

 
$
@@infofont
$
infofont

infofont <font> [<encoding>] [<size>]
	Default: Times-Italic 14
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a fonte da linha de informao ('infoline')
		como <font> de tamanho <size>.

 
$
@@infoline
$
infoline

infoline <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Mostra o nome do ritmo e a origem em uma mesma linha,
		e tambm mostra a rea ('A:').

 
$
@@infoline
$
infoline

infoline <letra maiscula> <nome da informao>
	Default:
		R "Rhythm: "
		B "Book: "
		S "Source: "
		D "Discography: "
		N "Notes: "
		Z "Transcription: "
		H "History: "
	Compilao: nenhum
	Linha de comando: nenhum
	Descrio:
		Define os tipos de informao e nome a serem impressos
		aps as peas quando 'writehistory' (ou -n) est
		ativado.

 
$
@@infospace
$
infospace

infospace <unit>
	Default: 0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define o espao vertical antes da 'infoline' como <unit>.

 
$
@@landscape
$
landscape

landscape <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: -l
	Descrio:
		Define a orientao de pgina como "paisagem".

 
$
@@leftmargin
$
leftmargin

leftmargin <unit>
	Default: 1.8cm
	Compilao: nenhum
	Linha de Comando: -m<unit>
	Descrio:
		Define a margem esquerda como <unit>.

 
$
@@lineskipfac
$
lineskipfac

lineskipfac <float>
	Default: 1.1
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define o fator para espaamento entre linhas de texto
		como <float>.

 
$
@@maxshrink
$
maxshrink

maxshrink <float>
	Default: 0.65
	Compilao: nenhum
	Linha de Comando: -a<float>
	Descrio:
		Define o grau de compresso horizontal quando quebras
		de linha (pautas) forem escolhidas automaticamente.
		<float> deve estar entre 0 e 1.

 
$
@@maxstaffsep
$
maxstaffsep

maxstaffsep <unit>
	Default: 2000pt
	Compilao: nenhum
	Linha de comando: nenhum
	Descrio:
		No coloca um sistema de pautas a mais de <unit> do
		sistema anterior.

 
$
@@maxsysstaffsep
$
maxsysstaffsep

maxsysstaffsep <unit>
	Default: 2000pt
	Compilao: nenhum
	Linha de comando: nenhum
	Descrio:
		Define o espao vertical mximo entre as pautas de um
		sistema como <unit>.

 
$
@@measurebox
$
measurebox

measurebox <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: acrescentando 'b' no final de -j ou -k
			  - ver measurenb.
	Descrio:
		Desenha uma caixa ao redor dos nmeros de compasso.
		Esse valor pode ser definido como 'true' atravs de
		'%%measurefont'.

 
$
@@measurefirst
$
measurefirst

measurefirst <int>
	Default: 1
	Compilao: nenhum
	Linha de Comando: -b<int>
	Descrio:
		Inicia a numerao de compassos da pea a partir de
		<int>.
		Este parmetro  obsoleto e deve ser substitudo por
		'%%setbarnb' (fora do corpo da pea).

 
$
@@measurefont
$
measurefont

measurefont <font> [<encoding>] <size> [box]
	Default: Times-Italic 14
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a fonte da numerao de compassos como <font>
		de tamanho <size>.
		Se 'box' estiver presente, desenha uma caixa em torno
		do nmero do compasso.

 
$
@@measurenb
$
measurenb

measurenb <int>
	Default: -1
	Compilao: nenhum
	Linha de Comando: -j<int>[b] or -k<int>[b]
	Descrio:
		Se positivo, desenha o nmero de compasso a cada <int>
		compassos.
		Se <int> = 0, o nmero de compasso aparece somente 
		esquerda de cada sistema.
		Na linha de comando, se um 'b' for adicionado ao final
		dessa opo, uma caixa ser desenhada em torno dos
		nmeros de compasso.

 
$
@@musiconly
$
musiconly

musiconly <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: -M
	Descrio:
		No imprime as letras das msicas ('lyrics'), se for
		'true'.

 
$
@@musicspace
$
musicspace

musicspace <unit>
	Default: 0.2cm
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define o espao vertical antes da primeira pauta como
		<unit>.

 
$
@@notespacingfactor
$
notespacingfactor

notespacingfactor <float>
	Default: 1.414
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define o fator de espaamento entre notas como <float>.
		Esse valor  usado para computar o espao normal das
		notas. O espao de base da semnima  sempre 40
		pontos. Quando a durao de um tipo de figura  o
		dobro de um outro tipo, seu espao  multiplicado por
		esse fator.
		O valor "default" faz com que o espao de uma nota
		seja multiplicado por dois quando sua durao for
		multiplicada por 4, ou seja, o espao da semibreve 
		80 pontos e o espao da semicolcheia  20 pontos.
		Definir esse parmetro com valor 1 torna o espaamento
		igual a 40 pontos para todas as notas.

 
$
@@oneperpage
$
oneperpage

oneperpage <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: -1
	Descrio:
		Coloca uma pea em cada pgina.

 
$
@@pageheight
$
pageheight

pageheight <unit>
	Default: PAGEHEIGHT
	Compilao: PAGEHEIGHT= (A4: 29.7cm - US: 11in)
	Linha de Comando: nenhum
	Descrio:
		Define a altura da pgina como <unit>.

 
$
@@pagewidth
$
pagewidth

pagewidth <unit>
	Default: PAGEWIDTH
	Compilao: PAGEWIDTH= (A4: 21.0cm - US: 8.5in)
	Linha de Comando: nenhum
	Descrio:
		Define a largura da pgina como <unit>.

 
$
@@parskipfac
$
parskipfac

parskipfac <float>
	Default: 0.4
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define o fator para espaamento entre pargrafos de
		texto como <float>.

 
$
@@partsbox
$
partsbox

partsbox <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Desenha uma caixa em torno dos nomes das partes
		('parts').
		Esse valor pode ser definido como 'true' atravs de
		%%partsfont.

 
$
@@partsfont
$
partsfont

partsfont <font> [<encoding>] <size> [box]
	Default: Times-Roman 15
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a fonte das partes ('parts') como <font> de
		tamanho <size>.
		Se 'box' est presente, desenha uma caixa em torno dos
		nomes das partes.

 
$
@@partsspace
$
partsspace

partsspace <unit>
	Default: 0.3cm
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define o espao vertical antes de uma nova parte como
		<unit>.

 
$
@@postscript
$
postscript

postscript <text>
	Default: nenhum
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define uma linha a ser includa no arquivo 
		PostScript de sada.
		Esse parmetro pode ser usado para sobrescrever
		qualquer funo PostScript ou para definir novas
		funes para uso em um formato 'deco'.

 
$
@@pslevel
$
pslevel

pslevel <int>
	.
		[--- %%pslevel FOI REMOVIDO EM abcm2ps VERSO 5.2.1 ---]
	.
	Default: 2
	Compilao: nenhum
	Linha de comando: nenhum
	Descrio:
		Define o nvel da linguagem PostScript de sada. Pode
		ser 1, 2 ou 3.

 
$
@@printparts
$
printparts

printparts <bool>
	Default: 1
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Imprime as indicaes de partes (P:).

 
$
@@printtempo
$
printtempo

printtempo <bool>
	Default: 1
	Compilao: nenhum
	Linha de Comando: -Q (sim) / +Q (no)
	Descrio:
		Imprime as indicaes de tempo (Q:).

 
$
@@repeatfont
$
repeatfont

repeatfont <font> [<encoding>] [<size>]
	Default: Times-Roman 13
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a fonte de nmero/texto usados em repeties
		(voltas) como <font> de tamanho <size>.

 
$
@@rightmargin
$
rightmargin

rightmargin <unit>
	Default: 1.8cm
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a margem direita como <unit>.

 
$
@@scale
$
scale

scale <float>
	Default: 0.75
	Compilao: nenhum
	Linha de Comando: -s<float>
	Descrio:
		Define o fator de magnificao como <float>.
		Note que cabealho ('header') e rodap ('footer') no
		so afetados.
 
$
@@setdefl
$
setdefl

setdefl <bool>
	Default: 0
	Compilation: nenhum
	Command line: nenhum
	Description:
		Quando verdadeiro, inclui algumas indicaes sobre a
		nota/acorde e/ou decoraes para propsito de
		personalizao. Essas indicaes so armazenadas na
		varivel PostScript 'defl'.

 
$
@@setfont-1
$
setfont-1

Ver 'setfont-4'.

setfont-1 <font> [<encoding>] <size>
 
$
@@setfont-2
$
setfont-2

Ver 'setfont-4'.

setfont-2 <font> [<encoding>] <size>
 
$
@@setfont-3
$
setfont-3

Ver 'setfont-4'.

setfont-3 <font> [<encoding>] <size>
 
$
@@setfont-4
$
setfont-4

setfont-4 <font> [<encoding>] <size>
	Default: Times-Roman 0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define as fontes alternativas para strings.
		Em muitas strings, a fonte atual pode ser alterada
		atravs de "$n" (n = 0, 1 .. 4 - "$0" restaura a fonte
		normal).
		Nota: <size>  obrigatrio na primeira definio.

 
$
@@shiftunisson
$
shiftunisson

shiftunisson <bool>
	Default: 0
	Compilao: nenhum
	Linha de comando: nenhum
	Descrio:
		Em msicas com vrias vozes, quando ocorre unssono,
		freqentemente h apenas uma cabea de nota. Ativar
		essa opo mantm as duas cabeas de notas, com um
		deslocamento quando houver uma mnima e uma nota mais
		curta (de cabea preta), e tambm quando houver uma
		nota pontuada e outra no.

 
$
@@slurheight
$
slurheight

slurheight <float>
	Default: 1.0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define o fator de altura das ligaduras como <float>.

 
$
@@splittune
$
splittune

splittune <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: -0
	Descrio:
		Se 'false', uma pea comear em nova pgina se no
		couber na atual. Se 'true', no haver teste de
		pgina, e a pea poder ser dividida.

 
$
@@squarebreve
$
squarebreve

squarebreve <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Mostra as breves em formato quadrado.

 
$
@@staffnonote
$
staffnonote

staffnonote <bool>
	Default: 1
	Compilao: nenhum
	Linha de comando: nenhum
	Descrio:
		Se desativado, no mostra as pautas que no tiverem
		notas nas linhas de msica.

 
$
@@staffsep
$
staffsep

staffsep <unit>
	Default: 46pt
	Compilao: nenhum
	Linha de Comando: -d<unit>
	Descrio:
		No coloca um sistema de pautas a menos de <unit> do
		sistema anterior.

 
$
@@staffwidth
$
staffwidth

staffwidth <unit>
	Default: nenhum
	Compilao: nenhum
	Linha de Comando: -w<unit>
	Descrio:
		Ajusta a margem direita de modo que a largura da pauta
		seja <unit>.

 
$
@@stemheight
$
stemheight

stemheight <float>
	Default: 20.0
	Compilao: nenhum
	Linha de comando: nenhum
	Descrio:
		Define a altura (comprimento) das hastes como <float>.

 
$
@@straightflags
$
straightflags

straightflags <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Desenha bandeirolas retas nas hastes de msica para
		gaita-de-foles ('bagpipe tunes').

 
$
@@stretchlast
$
stretchlast

stretchlast <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Estende ('stretch') a ltima pauta da pea quando mais
		expandida que a linha anterior.

 
$
@@stretchstaff
$
stretchstaff

stretchstaff <bool>
	Default: 1
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Estende pautas no-cheias ('underfull') atravs da
		pgina.

 
$
@@subtitlefont
$
subtitlefont

subtitlefont <font> [<encoding>] [<size>]
	Default: Times-Roman 16
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a fonte do subttulo como <font> de tamanho
		<size>.

 
$
@@subtitlespace
$
subtitlespace

subtitlespace <unit>
	Default: 0.1cm
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define o espao vertical antes do subttulo como
		<unit>.

 
$
@@sysstaffsep
$
sysstaffsep

sysstaffsep <unit>
	Default: 36pt
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		No coloca as pautas a distncia menor que <uni> em um
		sistema.
		Aplica-se a todas as pautas quando global ou em
		cabealho de msica. Seno, define o espao vertical
		mnimo antes da prxima pauta.

 
$
@@tempofont
$
tempofont

tempofont <font> [<encoding>] [<size>]
	Default: Times-Bold 15
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a fonte do tempo como <font> de tamanho <size>.

 
$
@@textfont
$
textfont

textfont <font> [<encoding>] [<size>]
	Default: Times-Roman 16
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a fonte de texto como <font> de tamanho <size>.

 
$
@@textoption
$
textoption

textoption <int>
	Default: 0 (obeylines)
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a opo de formatao default de textos.
		Essa opo  usada para texto entre '%%begintext' e
		'%%endtext', '%%text' e '%%EPS'.
		<int> pode ser uma palavra-chave; Os valores so:
			0: obeylines
			1: justify
			2: fill
			3: center
			4: skip
			5: right
		Quando <int>  4 (skip), nem texto (incluindo
		%%center) nem EPS so impressos.

 
$
@@textspace
$
textspace

textspace <unit>
	Default: 0.5cm
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define como <unit> o espao vertical antes do histrico
		('history').

 
$
@@timewarn
$
timewarn

timewarn <bool>
	Default: 0
	Compilao: nenhum
	Linha de comando: nenhum
	Descrio:
		Quando ativado, se uma mudana de compasso ocorrer no
		incio de uma linha de msica, uma indicao de
		compasso ser adicionada no final da linha anterior.

 
$
@@titlecaps
$
titlecaps

titlecaps <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Imprime os ttulos em letras maisculas.

 
$
@@titlefont
$
titlefont

titlefont <font> [<encoding>] [<size>]
	Default: Times-Roman 20
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a fonte do ttulo como <font> de tamanho
		<size>.

 
$
@@titleformat
$
titleformat

titleformat <text>
	Default: nenhum
	Compilao: nenhum
	Linha de comando: nenhum
	Descrio:
		Define o formato do ttulo da pea de msica.
		Esse formato sobrescreve a maneira padro de mostrar o
		ttulo da pea. Assim, parmetros como %%titleleft,
		%%infoline ou %%composerspace sero ignorados. O
		formato  um conjunto de letras, nmeros, +, - e
		vrgulas. Caracteres no reconhecidos sero ignorados.
		Uma letra  o tipo de informao do cabealho ABC.
		Pode ser qualquer tipo de 'A' a 'Z'.
		Um nmero pode seguir uma letra. Pode ser:
			'0' para 'centralizar',
			'1' para alinhar  direita', ou
			'-1' para alinhar  esquerda.
		Quando ausente, assume-se o nmero default '0'
		(centralizar).
		Um sinal de mais ('+') pode aparecer entre dois
		campos, para concaten-los (isso funciona somente com
		campos do mesmo tipo e alinhamento).
		Quando ausente, assume-se alinhamento centralizado ('0').
		Uma vrgula define o limite de um bloco. Em cada bloco,
		os campos so adicionados verticalmente em suas zonas de
		alinhamento.
		Exemplo:
			%%titleformat R-1 P-1 Q-1 T C1 O1 , T + T N1
		mostra:
		- no primeiro bloco:
		   - na esquerda: ritmo, parte e tempo
		   - no meio: o ttulo principal (somente)
		   - na direita: compositor e origem
		- no segundo bloco:
		   - no meio: os subttulos concatenados
		   - na direita: as notas

 
$
@@titleleft
$
titleleft

titleleft <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Imprime o ttulo  esquerda (ao invs de
		centralizado).

 
$
@@titlespace
$
titlespace

titlespace <unit>
	Default: 0.2cm
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define o espao vertical antes do ttulo como <unit>.

 
$
@@titletrim
$
titletrim

titletrim <bool>
	Default: 1
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:

		Quando ativado, se a ltima palavra de um ttulo
		comea com letra maiscula e  precedida por uma
		vrgula e um espao, esta palavra  movida para o
		comeo. Por exemplo: o ttulo
			T:Clair de la lune, Au
		 impresso como:
			Au Clair de la lune

 
$
@@topmargin
$
topmargin

topmargin <unit>
	Default: 1cm
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a margem superior como <unit>.

 
$
@@topspace
$
topspace

topspace <unit>
	Default: 0.8cm
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define o espao vertical superior ('top') como
		<unit>. Esse espao  colocado acima de pea e tambm
		no topo de pginas de continuao ('continuation
		pages').

 
$
@@tuplets
$
tuplets

tuplets <int> <int> <int>
	Default: 0 0 0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define como desenhar as quilteras.
		O primeiro <int> diz quando desenhar:
			0: auto (desenha quando no h travesso nos extremos)
			1: nunca
			2: sempre
		O segundo <int> diz o que desenhar:
			0: um colchete
			1: uma ligadura
			2: estender travesso sobre pausas (no funciona ainda)
		O terceiro <int> diz que valor imprimir:
			0: um nmero simples (valor de 'p')
			1: nenhum valor
			2: uma proporo ('p':'q')

 
$
@@vocalabove
$
vocalabove

vocalabove <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Coloca a letra ('vocals') acima da pauta.

 
$
@@vocalfont
$
vocalfont

vocalfont <font> [<encoding>] [<size>]
	Default: Times-Bold 13
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a fonte da letra ('lyrics') sob a pauta como
		<font> de tamanho <size>.

 
$
@@vocalspace
$
vocalspace

vocalspace <unit>
	Default: 23pt
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define o espao vertical antes da letra ('lyrics')
		como <unit>.

 
$
@@voicefont
$
voicefont

voicefont <font> [<encoding>] [<size>]
	Default: Times-Bold 13
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a fonte dos nomes das vozes como <font> de
		tamanho <size>.

 
$
@@withxrefs
$
withxrefs

withxrefs <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: -x
		Imprime o nmero X: no ttulo.

 
$
@@wordsfont
$
wordsfont

wordsfont <font> [<encoding>] [<size>]
	Default: Times-Roman 16
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define a fonte da letra ('lyrics') ao fim da pea como
		<font> de tamanho <size>.

 
$
@@wordsspace
$
wordsspace

wordsspace <unit>
	Default: 0cm
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Define o espao vertical antes da letra ('lyrics') ao
		fim da pea como <unit>.

 
$
@@writehistory
$
writehistory

writehistory <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: -n
	Descrio:
		Imprime a informao definida por 'infoname'.



=============================================================================



Lista de pseudo-comentrios tratados durante o processamento ('while parsed')
-----------------------------------------------------------------------------

 
$
@@begintext
$
begintext

begintext [<option>]
	Inicia a impresso de um texto livre. O texto aparece nas
	linhas seguintes (que podem comear com '%%' ou no). O texto
	termina em uma linha contendo
		%%endtext
	<option> pode ser:
	    'obeylines':          mantm as linhas como esto (default)
	    'align' ou 'justify': justifica as linhas
	    'ragged' ou 'fill':   preenche as linhas
	    'skip':               no imprime as linhas (o mesmo que
				  um comentrio)
	    'right':              alinha no lado direito

 
$
@@center
$
center

center <line of text>
	Imprime uma linha de texto centralizado.

 
$
@@EPS
$
EPS

EPS <eps_file>
	Insere o arquivo <eps_file>.
	O contedo do arquivo  alinhado  esquerda, direita ou
	centralizado de acordo com o valor atual de 'textoption'.

 
$
@@endtext
$
endtext

endtext
	Ver 'begintext'.

 
$
@@multicol
$
multicol

multicol <command>
	Define impresso em vrias colunas.
	<command> pode ser:
	    'start':	salva a posio vertical corrente e as margens
			esquerda e direita. Ento, essas margens podem
			ser alteradas para imprimir msica ou texto.
	    'new':	restaura a posio vertical de acordo com o
			prvio '%%multicol start', e restaura as
			margens esquerda e direita.
	    'end':	restaura as margens esquerda e direita, e
			salta verticalmente para um lugar vazio.
	(ver 'sample3.abc' para exemplo).
	Este comando pode tambm ser usado para agrupar algumas
	msicas e texto em uma mesma pgina.


 
$
@@newpage
$
newpage

newpage [<int>]
	Continua imprimindo em uma nova pgina e possivelmente
	reinicia a numerao de pginas em <int>.

 
$
@@repbra
$
repbra

repbra <bool>
	As casas de repeties (casa 1, casa 2 etc.) so normalmente
	mostradas quando so encontradas em uma voz. '%%repbra 0'
	impede sua impresso na voz corrente.

 
$
@@repeat
$
repeat

repeat [<n> [k]]
	Tenta substituir a seqncia por um ou mais sinais de
	repetio.
	Quando utilizado aps uma barra de compasso, <n> indica o
	nmero de compassos a serem repetidos. Pode ser somente um ou
	dois. Se <n> for um, <k> indica quantas vezes o compasso
	anterior deve ser repetido. Se <n> for dois, <k> no ser
	usado.
	Quando usado aps uma nota ou pausa, <n> indica o nmero de
	notas e pausas a serem repetidas, e <k> quantas vezes essa
	repetio ocorre.
	Quando omitidos, <n> e <k> so iguais a 1.
	Nenhuma checagem  feita quanto  igualdade das seqncias.
	Ver 'sample5.abc' para exemplos.

 
$
@@score
$
score

score <definio>
	Consulte o padro ABC verso 2.0 para a descrio.

 
$
@@sep
$
sep

sep [<h1> <h2> <len>]
	Imprime um separador [uma linha horizontal] de tamanho <len>
	com espao <h1> acima e espao <h2> abaixo
	(defaults: h1 = h2 = 0.5cm, len = 3.0cm).

 
$
@@setbarnb
$
setbarnb

setbarnb <int>
	Define o nmero do compasso como <int>.
	Quando encontrado fora de uma pea, esse comando  o mesmo que
	'%%measurefirst'. Se ocorrer no incio de uma pea (depois do
	campo K:), a nova numerao inicia a partir do segundo
	compasso.

 
$
@@staff
$
staff

staff <["+" | "-"] int>
	Coloca os prximos smbolos da voz corrente na pauta <int>
	(1..n - ver sample4.abc para exemplo), ou na <+int>-sima ou
	<-int>-sima pauta.

 
$
@@staffbreak
$
staffbreak

staffbreak <unit>
	Faz uma quebra na pauta corrente. <unit> d a largura da
	quebra (em pontos (pt), polegadas (in) ou centmetros (cm)).
	Como efeito colateral, quando a largura  maior que 0.5cm, o
	lado esquerdo do sistema de pautas  redesenhado.
	Quando usada em uma pea com vrias vozes, uma quebra de pauta
	deve ser inserida em cada voz.

 
$
@@staves
$
staves

staves <definition>
	Ver 'features.txt' para descrio.

 
$
@@tablature
$
tablature

tablature [<unit-1>] <unit-2> <head-func> <note-func> <bar-func>
	Define uma tablatura para a voz atual.
	<unit-1> d a altura da tablatura acima da pauta.
	<unit-2> d a altura da tablatura abaixo da pauta.
	<head-func>  a funo Postscript chamada no incio da
	tablatura. Quando chamada, a pilha contm:
		- a largura da linha de msica,
		- as coordenadas x e y,
		- o nmero da linha w: [0 .. n-1].
	<note-func>  a funo Postscript chamada para cada nota.
	Quando chamada, a pilha contm:
		- a string tal como definida pela linha 'w:'.
		- as coordenadas x e y.
		- o nmero da linha w: (0 .. n-1).
	<note-bar>  a funo PostScript chamada a cada barra de compasso.
	Quando chamada, a pilha contm:
		- a barra de compasso como string ABC.
		- as coordenadas x e y.
		- o nmero da linha w: (0 .. n-1).
	Para exemplos, ver 'accordion.abc',
	http://moinejf.free.fr/abc/banjo.abc
	http://moinejf.free.fr/abc/bataille.abc e
	http://moinejf.free.fr/abc/tabyf1.abc .

 
$
@@text
$
text

text <line of text>
	Imprime uma linha de texto.

 
$
@@vskip
$
vskip

vskip <h>
	Salta um espao vertical de altura <h>.



$
