
@@LEIA-ME
$
			Parmetros de Formato
			=====================
	Traduo de 'format.txt' por Hudson Lacerda (04-04-2005)
			   (abcm2ps 4.9.4)

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

	1- em tempo de compilao, definindo os valores em abc2ps.h;
	2- em tempo de execuo, com um arquivo de 'formato';
	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 formato contm linhas definindo os valores dos
parmetros, de acordo com a sintaxe:

	parmetro [lista de parmetros]

Em um arquivo de formato, 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 formato podem aparecer na linha de comando da seguinte
maneira:

	--parmetro [lista de parmetros]

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


Lista dos parmetros de formato
-------------------------------

 
$
@@aligncomposer
$
aligncomposer

aligncomposer <int>
	Default: 1
	Compilation: nenhum
	Linha de comando: nenhum
	Descrio:
		Diz onde mostrar o campo de 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 sequncia PostScript que termina em 'endps'.
		Esse parmetro pode ser usado somente em um arquivo de
		formato 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.

 
$
@@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  0, nmero de compasso em repeties [casa 2] 
		o mesmo da primeira vez [casa 1].
		Se  1, os compassos so numerados seqencialmente.

 
$
@@continueall
$
continueall

continueall <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: -c
	Descrio:
		Ignora quebras de linha se  '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 hora.
		Os valores possveis desse permetro 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  o nome de uma
		decorao pr-existente, ela  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: trilo 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 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 ISO-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 tomas os valores de '0' a '6'.
		O valor '0'  o mesmo que '1', mas o vetor de
		codificao PostScript para Latin1 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 h 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
		formato.
		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 
		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,
			- '$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).
		Uma pequena dica: quando um cabealho ('header') ou
		rodap ('footer')  definido dentro de uma pea [ou
		aps a impresso de algum texto], ele  impresso a
		partir da prxima pgina. Isso pode ser usado para
		evitar um cabealho/rodap 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 formato <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').

 
$
@@halfbeam
$
halfbeam

halfbeam <bool>
	Default: 1
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Quebra os travesses ('beams') em seqncias de fusas.

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

 
$
@@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:
		Indenta 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:').

 
$
@@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) so escolhidas automaticamente.
		<float> deve estar entre 0 e 1.

 
$
@@maxstaffsep
$
maxstaffsep

maxstaffsep <unit>
	Default: 2000pt
	Compilao: nenhum
	Linha de comando: nenhum
	Descrio:
		Define o espao vertical mximo entre pautas
		(sistemas) como <unit>.

 
$
@@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' est 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'  adicionado ao final
		dessa opo, uma caixa  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  '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 
		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>
	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).

 
$
@@shifthnote
$
shifthnote

shifthnote <bool>
	Default: 0
	Compilao: nenhum
	Linha de comando: nenhum
	Descrio:
		Em msicas com vrias vozes, quando ocorre unssono
		entre uma mnima e uma nota mais curta (nota preta),
		h somente uma cabea de nota, uma cabea de mnima.
		Quando essa opo  ativada, um deslocamento de nota 
		feito.

 
$
@@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 comea em nova pgina se no cabe
		na atual. Se 'true', No h teste de pgina, e a pea
		pode ser dividida.

 
$
@@squarebreve
$
squarebreve

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

 
$
@@staffsep
$
staffsep

staffsep <unit>
	Default: 46pt
	Compilao: nenhum
	Linha de Comando: -d<unit>
	Descrio:
		Define o espao vertical entre pautas ('interstaff')
		como <unit>.

 
$
@@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 no
		est cheia ('when underfull').

 
$
@@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:
		Define o espao vertical entre pautas de um sistema
		como <unit>.

 
$
@@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: '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'.
		<int> pode ser uma palavra-chave; ver 'begintext' para
		saber os valores.

 
$
@@textspace
$
textspace

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

 
$
@@titlecaps
$
titlecaps

titlecaps <bool>
	Default: 0
	Compilao: nenhum
	Linha de Comando: nenhum
	Descrio:
		Imprime o ttulo em 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>.

 
$
@@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>.

 
$
@@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: 0.5cm
	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:
		Escreve notas ('notes'), histria ('history')...



Lista de pseudo-comentrios tratados durante a interpretao ('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)

 
$
@@center
$
center

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

 
$
@@EPS
$
EPS

EPS <eps_file>
	Insere o arquivo <eps_file>.

 
$
@@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).

 
$
@@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.

 
$
@@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 ocorre 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).

 
$
@@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.

 
$
@@text
$
text

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

 
$
@@vskip
$
vskip

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



$
