Parâmetros de Formatação
		       =======================
	Tradução 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 compilação, definindo os valores em abc2ps.h;
	2- no momento da execução, com um arquivo de 'formatação';
	3- ao início da execução, na linha de comando;
	4- por meio de pseudo-comentários dentro do arquivo fonte ABC.

Para mais informações sobre 3), veja o arquivo 'opções.txt'
('options.txt').

Um arquivo de formatação contém linhas definindo os valores dos
parâmetros, de acordo com a sintaxe:

	parâmetro [lista de parâmetros]

Em um arquivo de formatação, linhas vazias e linhas que começam com
'#' são ignoradas.

Os pseudo-comentários usados para formatação têm a seguinte forma:

	%%parâmetro [lista de parâmetros]

Parâmetros de formatação podem aparecer na linha de comando da
seguinte maneira:

	--parâmetro [lista de parâmetros]

Alguns pseudo-comentários são tratados na fase de processamento do
arquivo ABC ('while being parsed') e não podem aparecer em um arquivo
de formatação nem na linha de comando. Eles são listados ao final
deste arquivo.

Em definições de fontes, <font>, <encoding> e <size> podem ser
especificados como '*' (asterisco), caso em que a fonte, codificação
ou tamanho permanece sem alteração. Quando <encoding> é omitido, a
codificação global (ver 'encoding') ou a última codificação da mesma
fonte é utilizada.


Lista dos parâmetros de formatação
----------------------------------

 

abc2pscompat <bool>
	Default: 0
	Compilação: nenhum
	Linha de comando: -u
	Descrição:
		Quando ativado, define 'M' como a decoração +tenuto+
		e realiza transposição (em oitavas) se as notas forem
		muito altas para uma clave de fá.

 

alignbars <int>
	Default: 1
	Compilação: nenhum
	Linha de comando: nenhum
	Descrição:
		Alinha os compassos das próximas <int> linhas de
		música. Esse alinhamento funciona somente quando há
		somente uma voz nas linhas de música (não são
		permitidos V:, %%staves ou %%score).

 

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

 

annotationfont <font> [<encoding>] [<size>]
	Default: Helvetica 12
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define a fonte usada em anotações como <font> de
		tamanho <size>.

 

autoclef <bool>
	Default: 1
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Quando verdadeiro, define as claves e possivelmente insere
		mudanças de clave se nenhuma clave for definida no campo
		K: ou V:.

 

barnumbers <int>
	Mesmo que 'measurenb'.

 

barsperstaff <int>
	Default: 0
	Compilação: nenhum
	Linha de Comando: -B<int>
	Descrição:
		Tenta dispor <int> compassos em cada linha.

 

beginps
	Default: nenhum
	Compilação: nenhum
	Linha de comando: nenhum
	Descrição:
		Inicia uma seqüência PostScript que termina em
		'endps'.  Esse parâmetro pode ser usado somente em um
		arquivo de formatação ou arquivo ABC (ele não pode
		aparecer na linha de comando).
		Cada linha entre 'beginps' e 'endps' é incluída no
		arquivo PostScript de saída.

 

botmargin <unit>
	Default: 1cm
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define a margem inferior como <unit>.

 

bstemdown <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Quando esta opção é definida como 'true' ou '1', a
		nota do meio da pauta é desenhada com haste para
		baixo. Senão, a haste vai para cima ou para baixo de
		acordo com a nota anterior.

 

comball <bool>
	Default: 0
	Compilação: nenhum
	Linha de comando: nenhum
	Descrição:
		Quando 'combinevoice' está ativado, combinação de
		vozes não ocorre quando as alturas formam uma segunda,
		uníssono ou estão invertidas.
		Ativar essa opção faz a combinação ocorrer em todos os
		casos.

 

combinevoices <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Se 1, as notas de mesma duração pertencentes a vozes da
		mesma pauta são combinadas formando acordes.

 

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

 

composerspace <unit>
	Default: 0.2cm
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define o espaço vertical antes do compositor como <unit>.

 

contbarnb <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Se for 0, número de compasso em repetições [casa 2] será
		o mesmo da primeira vez [casa 1].
		Se for 1, os compassos serão numerados seqüencialmente.

 

continueall <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: -c
	Descrição:
		Ignora quebras de linha se for 'true' ('1').

 

dateformat <text>
	Default: "\%b \%e, \%Y \%H:\%M"
 	Compilação: nenhum
 	Linha de comando: nenhum
 	Descrição:
		Define o formato da data e da hora.
		Os valores possíveis desse parâmetro são descritos
		nas páginas de manual de date(1) e strftime(3).
		Nota: o '%' deve ser escapado como '\%'.

 

deco <name> <c_func> <ps_func> <h> <wl> <wr> [<str>]
	Default: nenhum
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define uma decoração.
		!! ESTE É UM RECURSO EXPERIMENTAL QUE ESTÁ SUJEITO A
		MUDANÇAS NAS PRÓXIMAS VERSÕES E EXIGE UM BOM
		CONHECIMENTO DO INTERIOR DE abcm2ps - VEJA deco.abc
		PARA EXEMPLOS !!
		Os argumentos atuais são:
		<name>: nome da decoração. Se for o nome de uma
		decoração pré-existente, ela será redefinida.
		<c_func>: índice de uma função C (definida em deco.c).
			Os valores possíveis são:
			0, 1, 2: decoração próxima à nota, dentro da pauta.
				0: 'dot' e 'tenuto'
				1: 'slide'
				2: 'arpeggio'
			3, 4, 5: decoração próxima à 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: decoração associada à pauta, geralmente
			      impressa abaixo da pauta.
				6: geral
				7: sinais longos de dinâmica (com início e fim)
		<ps_func>: nome da função postscript ou '-' para
		        ínicio de uma decoração longa.
		<h>: altura da decoração.
			Para +arpeggio+ é a altura mínima.
		<wl> e <wr>: largura à esquerda e à direita.
			     Esses valores são atualmente usados para símbolos
			     gerais de dinâmica somente.
		<str>: texto a ser mostrado (para algumas funções postscript
			     - veja o código).
		Decorações cujos nomes começam com 'head-' impedem que
		a cabeça da nota seja desenhada (ou as cabeças, em um
		acorde).

 

dynalign <bool>
	Default: 1
	Compilação: nenhum
	Linha de comando: nenhum
	Descrição:
		Quando verdadeiro, alinha horizontalmente os sinais de
		dinâmica.

 

encoding <encoding> | <int>
	Default: 0
	Compilação: nenhum
	Linha de Comando: -L<int>
	Descrição:
		Define a codificação global da fonte como <encoding>,
		ou como 'Latin<int>'.
		As codificações reconhecidas são:
			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 codificação é nativa ('native'), os vetores
		de codificação das fontes não são alterados.
		<encoding> pode ser qualquer string. Nesse caso, o
		vetor de codificação deve ser definido por uma
		seqüência de comandos 'postscript'.

		<int> pode tomar os valores de '0' a '6'. O valor '0'
		é o mesmo que '1', mas o vetor de codificação
		PostScript para 'ISOLatin1Encoding' não é enviado para
		a saída.

 

exprabove <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Desenha as decorações de expressão [dinâmica] acima da
		pauta.  Quando ambos 'exprabove' e 'exprbelow' são
		'false' ('0'), as decorações de expressão são
		desenhadas acima da pauta se houver letras de música
		('lyrics') na pauta, e abaixo em caso
		contrário. 'exprabove' toma precedência sobre
		'exprbelow'.

 

exprbelow <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Desenha as decorações de expressão [dinâmica] abaixo da
		pauta.
		Quando ambos 'exprabove' e 'exprbelow' são 'false'
		('0'), as decorações de expressão são desenhadas acima
		da pauta se há letras de música ('lyrics') na pauta, e
		abaixo em caso contrário. 'exprabove' toma precedência
		sobre 'exprbelow'.

 

flatbeams <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: -f
	Descrição:
		Usa travessões ('beams') retos em músicas de
		gaita-de-foles ('bagpipe tunes').

 

font <font> [<encoding>]
	Default: nenhum
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define uma fonte e sua codificação.
		Esse parâmetro é requerido quando fontes específicas
		são definidas posteriormente em arquivos/peças ABC, e
		devem ser redefinidas antes que qualquer saída
		PostScript seja feita, geralmente em um arquivo de
		formatação.
		Quando ausente, <encoding> segue o parâmetro de
		codificação 'encoding' corrente (ver acima).

 

footer <text>
	Default: nenhum
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define o texto a ser impresso no pé de cada página
		[rodapé].
		Pode haver uma ou duas linhas. Duas linhas devem ser
		separadas pelos 2 caracteres "\n" (e não por uma
		verdadeira 'nova linha').
		Em cada linha, 3 áreas podem ser definidas: esquerda,
		centro e direita.
		Essas áreas são separadas por tabulações (TABs reais,
		não '\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 expansão variável:
			- '$d' é a data e hora da última modificação
			  do arquivo de entrada (ABC) corrente,
			- '$D' é a data e hora atual,
			- '$F' é o nome do arquivo de entrada atual,
			- '$Ix' é qualquer campo de informação de
 

                        cabeçalho ('x' é uma letra de 'A' a 'Z').
			- '$P' é o número da página atual,
			- '$P0' e '$P1' também são o número de página,
			   mas somente quando ela é par ('0') ou ímpar ('1'),
			- '$T' é o título da peça atual,
			- '$V' é 'abcm2ps-' seguido pela versão do
			   programa.
		Por exemplo, a opção de linha de comando '-N3' é o
		mesmo que:
			%%header "$P0		$P1"
		(note as 2 TABs).
		Se o rodapé (footer) ou cabeçalho (header) começa com
		'-' (hífen/menos), ele não é impresso na primeira
		página.

 

footerfont <font> [<encoding>] [<size>]
	Default: Times-Roman 12
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define a fonte de rodapé ('footer') como <font>
		de tamanho <size>.
		Note que o rodapé não é afetado por 'scale'.

 

format <nomedoarquivo>
	Default: nenhum
	Compilação: nenhum
	Linha de comando: nenhum
	Descrição:
		Lê o arquivo de formatação (ou PostScript) <nomedoarquivo>.
		Quando encontrado na linha de comando, esse parâmetro
		é o mesmo que '-F'.

 

freegchord <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		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 através de seqüências de escape
		('\#', '\b' e '\=').

 

gchordbox <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Desenha uma caixa em torno dos acordes cifrados.
		Esse valor pode ser definido como 'true' através de
		%%gchordfont.

 

gchordfont <font> [<encoding>] <size> [box]
	Default: Helvetica 12
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		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 <bool>
	Default: 1
	Compilação: nenhum
	Linha de Comando: -G
	Descrição:
		Desenha ligaduras ('slurs') em notinhas ('grace notes').

 

gracespace <float> <float> <float>
	Default: 6.5 8.0 12.0
	Compilation: none
	Command line: none
	Description:
		Define o espaço antes, entre e após notinhas (grace
		notes).

 

header <text>
	Default: nenhum
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define o texto mostrado no topo de cada página
		[cabeçalho].
		Veja 'footer' acima para a sintaxe do cabeçalho.

 

headerfont <font> [<encoding>] [<size>]
	Default: Times-Roman 12
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define a fonte de cabeçalho como <font> de tamanho
		<size>.
		Note que o cabeçalho não é afetado por 'scale'.

 

historyfont <font> [<encoding>] [<size>]
	Default: Times-Roman 16
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define a fonte do texto do 'histórico' como <font> de
		tamanho <size>.

 

hyphencont <bool>
	Default: 0
	Compilação: nenhum
	Linha de comando: nenhum
	Descrição:
		Quando uma letra de música (`lyric') sob a pauta
		termina com um hífen, coloca um hífen na linha
		seguinte.

 

indent <unit>
	Default: 0
	Compilação: nenhum
	Linha de Comando: -I<unit>
	Descrição:
		Recua a primeira linha de uma peça por <unit>.

 

infofont <font> [<encoding>] [<size>]
	Default: Times-Italic 14
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define a fonte da linha de informação ('infoline')
		como <font> de tamanho <size>.

 

infoline <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Mostra o nome do ritmo e a origem em uma mesma linha,
		e também mostra a área ('A:').

 

infoline <letra maiúscula> <nome da informação>
	Default:
		R "Rhythm: "
		B "Book: "
		S "Source: "
		D "Discography: "
		N "Notes: "
		Z "Transcription: "
		H "History: "
	Compilação: nenhum
	Linha de comando: nenhum
	Descrição:
		Define os tipos de informação e nome a serem impressos
		após as peças quando 'writehistory' (ou -n) está
		ativado.

 

infospace <unit>
	Default: 0
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define o espaço vertical antes da 'infoline' como <unit>.

 

landscape <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: -l
	Descrição:
		Define a orientação de página como "paisagem".

 

leftmargin <unit>
	Default: 1.8cm
	Compilação: nenhum
	Linha de Comando: -m<unit>
	Descrição:
		Define a margem esquerda como <unit>.

 

lineskipfac <float>
	Default: 1.1
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define o fator para espaçamento entre linhas de texto
		como <float>.

 

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

 

maxstaffsep <unit>
	Default: 2000pt
	Compilação: nenhum
	Linha de comando: nenhum
	Descrição:
		Não coloca um sistema de pautas a mais de <unit> do
		sistema anterior.

 

maxsysstaffsep <unit>
	Default: 2000pt
	Compilação: nenhum
	Linha de comando: nenhum
	Descrição:
		Define o espaço vertical máximo entre as pautas de um
		sistema como <unit>.

 

measurebox <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: acrescentando 'b' no final de -j ou -k
			  - ver measurenb.
	Descrição:
		Desenha uma caixa ao redor dos números de compasso.
		Esse valor pode ser definido como 'true' através de
		'%%measurefont'.

 

measurefirst <int>
	Default: 1
	Compilação: nenhum
	Linha de Comando: -b<int>
	Descrição:
		Inicia a numeração de compassos da peça a partir de
		<int>.
		Este parâmetro é obsoleto e deve ser substituído por
		'%%setbarnb' (fora do corpo da peça).

 

measurefont <font> [<encoding>] <size> [box]
	Default: Times-Italic 14
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define a fonte da numeração de compassos como <font>
		de tamanho <size>.
		Se 'box' estiver presente, desenha uma caixa em torno
		do número do compasso.

 

measurenb <int>
	Default: -1
	Compilação: nenhum
	Linha de Comando: -j<int>[b] or -k<int>[b]
	Descrição:
		Se positivo, desenha o número de compasso a cada <int>
		compassos.
		Se <int> = 0, o número de compasso aparece somente à
		esquerda de cada sistema.
		Na linha de comando, se um 'b' for adicionado ao final
		dessa opção, uma caixa será desenhada em torno dos
		números de compasso.

 

musiconly <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: -M
	Descrição:
		Não imprime as letras das músicas ('lyrics'), se for
		'true'.

 

musicspace <unit>
	Default: 0.2cm
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define o espaço vertical antes da primeira pauta como
		<unit>.

 

notespacingfactor <float>
	Default: 1.414
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define o fator de espaçamento entre notas como <float>.
		Esse valor é usado para computar o espaço normal das
		notas. O espaço de base da semínima é sempre 40
		pontos. Quando a duração de um tipo de figura é o
		dobro de um outro tipo, seu espaço é multiplicado por
		esse fator.
		O valor "default" faz com que o espaço de uma nota
		seja multiplicado por dois quando sua duração for
		multiplicada por 4, ou seja, o espaço da semibreve é
		80 pontos e o espaço da semicolcheia é 20 pontos.
		Definir esse parâmetro com valor 1 torna o espaçamento
		igual a 40 pontos para todas as notas.

 

oneperpage <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: -1
	Descrição:
		Coloca uma peça em cada página.

 

pageheight <unit>
	Default: PAGEHEIGHT
	Compilação: PAGEHEIGHT= (A4: 29.7cm - US: 11in)
	Linha de Comando: nenhum
	Descrição:
		Define a altura da página como <unit>.

 

pagewidth <unit>
	Default: PAGEWIDTH
	Compilação: PAGEWIDTH= (A4: 21.0cm - US: 8.5in)
	Linha de Comando: nenhum
	Descrição:
		Define a largura da página como <unit>.

 

parskipfac <float>
	Default: 0.4
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define o fator para espaçamento entre parágrafos de
		texto como <float>.

 

partsbox <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Desenha uma caixa em torno dos nomes das partes
		('parts').
		Esse valor pode ser definido como 'true' através de
		%%partsfont.

 

partsfont <font> [<encoding>] <size> [box]
	Default: Times-Roman 15
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		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 <unit>
	Default: 0.3cm
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define o espaço vertical antes de uma nova parte como
		<unit>.

 

postscript <text>
	Default: nenhum
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define uma linha a ser incluída no arquivo 
		PostScript de saída.
		Esse parâmetro pode ser usado para sobrescrever
		qualquer função PostScript ou para definir novas
		funções para uso em um formato 'deco'.

 

pslevel <int>
	.
		[--- %%pslevel FOI REMOVIDO EM abcm2ps VERSÃO 5.2.1 ---]
	.
	Default: 2
	Compilação: nenhum
	Linha de comando: nenhum
	Descrição:
		Define o nível da linguagem PostScript de saída. Pode
		ser 1, 2 ou 3.

 

printparts <bool>
	Default: 1
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Imprime as indicações de partes (P:).

 

printtempo <bool>
	Default: 1
	Compilação: nenhum
	Linha de Comando: -Q (sim) / +Q (não)
	Descrição:
		Imprime as indicações de tempo (Q:).

 

repeatfont <font> [<encoding>] [<size>]
	Default: Times-Roman 13
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define a fonte de número/texto usados em repetições
		(voltas) como <font> de tamanho <size>.

 

rightmargin <unit>
	Default: 1.8cm
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define a margem direita como <unit>.

 

scale <float>
	Default: 0.75
	Compilação: nenhum
	Linha de Comando: -s<float>
	Descrição:
		Define o fator de magnificação como <float>.
		Note que cabeçalho ('header') e rodapé ('footer') não
		são afetados.
 

setdefl <bool>
	Default: 0
	Compilation: nenhum
	Command line: nenhum
	Description:
		Quando verdadeiro, inclui algumas indicações sobre a
		nota/acorde e/ou decorações para propósito de
		personalização. Essas indicações são armazenadas na
		variável PostScript 'defl'.

 

Ver 'setfont-4'.

setfont-1 <font> [<encoding>] <size>
 

Ver 'setfont-4'.

setfont-2 <font> [<encoding>] <size>
 

Ver 'setfont-4'.

setfont-3 <font> [<encoding>] <size>
 

setfont-4 <font> [<encoding>] <size>
	Default: Times-Roman 0
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define as fontes alternativas para strings.
		Em muitas strings, a fonte atual pode ser alterada
		através de "$n" (n = 0, 1 .. 4 - "$0" restaura a fonte
		normal).
		Nota: <size> é obrigatório na primeira definição.

 

shiftunisson <bool>
	Default: 0
	Compilação: nenhum
	Linha de comando: nenhum
	Descrição:
		Em músicas com várias vozes, quando ocorre uníssono,
		freqüentemente há apenas uma cabeça de nota. Ativar
		essa opção mantém as duas cabeças de notas, com um
		deslocamento quando houver uma mínima e uma nota mais
		curta (de cabeça preta), e também quando houver uma
		nota pontuada e outra não.

 

slurheight <float>
	Default: 1.0
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define o fator de altura das ligaduras como <float>.

 

splittune <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: -0
	Descrição:
		Se 'false', uma peça começará em nova página se não
		couber na atual. Se 'true', não haverá teste de
		página, e a peça poderá ser dividida.

 

squarebreve <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Mostra as breves em formato quadrado.

 

staffnonote <bool>
	Default: 1
	Compilação: nenhum
	Linha de comando: nenhum
	Descrição:
		Se desativado, não mostra as pautas que não tiverem
		notas nas linhas de música.

 

staffsep <unit>
	Default: 46pt
	Compilação: nenhum
	Linha de Comando: -d<unit>
	Descrição:
		Não coloca um sistema de pautas a menos de <unit> do
		sistema anterior.

 

staffwidth <unit>
	Default: nenhum
	Compilação: nenhum
	Linha de Comando: -w<unit>
	Descrição:
		Ajusta a margem direita de modo que a largura da pauta
		seja <unit>.

 

stemheight <float>
	Default: 20.0
	Compilação: nenhum
	Linha de comando: nenhum
	Descrição:
		Define a altura (comprimento) das hastes como <float>.

 

straightflags <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Desenha bandeirolas retas nas hastes de música para
		gaita-de-foles ('bagpipe tunes').

 

stretchlast <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Estende ('stretch') a última pauta da peça quando mais
		expandida que a linha anterior.

 

stretchstaff <bool>
	Default: 1
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Estende pautas não-cheias ('underfull') através da
		página.

 

subtitlefont <font> [<encoding>] [<size>]
	Default: Times-Roman 16
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define a fonte do subtítulo como <font> de tamanho
		<size>.

 

subtitlespace <unit>
	Default: 0.1cm
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define o espaço vertical antes do subtítulo como
		<unit>.

 

sysstaffsep <unit>
	Default: 36pt
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Não coloca as pautas a distância menor que <uni> em um
		sistema.
		Aplica-se a todas as pautas quando global ou em
		cabeçalho de música. Senão, define o espaço vertical
		mínimo antes da próxima pauta.

 

tempofont <font> [<encoding>] [<size>]
	Default: Times-Bold 15
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define a fonte do tempo como <font> de tamanho <size>.

 

textfont <font> [<encoding>] [<size>]
	Default: Times-Roman 16
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define a fonte de texto como <font> de tamanho <size>.

 

textoption <int>
	Default: 0 (obeylines)
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define a opção de formatação default de textos.
		Essa opção é usada para texto entre '%%begintext' e
		'%%endtext', '%%text' e '%%EPS'.
		<int> pode ser uma palavra-chave; Os valores são:
			0: obeylines
			1: justify
			2: fill
			3: center
			4: skip
			5: right
		Quando <int> é 4 (skip), nem texto (incluindo
		%%center) nem EPS são impressos.

 

textspace <unit>
	Default: 0.5cm
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define como <unit> o espaço vertical antes do histórico
		('history').

 

timewarn <bool>
	Default: 0
	Compilação: nenhum
	Linha de comando: nenhum
	Descrição:
		Quando ativado, se uma mudança de compasso ocorrer no
		início de uma linha de música, uma indicação de
		compasso será adicionada no final da linha anterior.

 

titlecaps <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Imprime os títulos em letras maiúsculas.

 

titlefont <font> [<encoding>] [<size>]
	Default: Times-Roman 20
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define a fonte do título como <font> de tamanho
		<size>.

 

titleformat <text>
	Default: nenhum
	Compilação: nenhum
	Linha de comando: nenhum
	Descrição:
		Define o formato do título da peça de música.
		Esse formato sobrescreve a maneira padrão de mostrar o
		título da peça. Assim, parâmetros como %%titleleft,
		%%infoline ou %%composerspace serão ignorados. O
		formato é um conjunto de letras, números, +, - e
		vírgulas. Caracteres não reconhecidos serão ignorados.
		Uma letra é o tipo de informação do cabeçalho ABC.
		Pode ser qualquer tipo de 'A' a 'Z'.
		Um número pode seguir uma letra. Pode ser:
			'0' para 'centralizar',
			'1' para alinhar à direita', ou
			'-1' para alinhar à esquerda.
		Quando ausente, assume-se o número 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 vírgula define o limite de um bloco. Em cada bloco,
		os campos são 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 título principal (somente)
		   - na direita: compositor e origem
		- no segundo bloco:
		   - no meio: os subtítulos concatenados
		   - na direita: as notas

 

titleleft <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Imprime o título à esquerda (ao invés de
		centralizado).

 

titlespace <unit>
	Default: 0.2cm
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define o espaço vertical antes do título como <unit>.

 

titletrim <bool>
	Default: 1
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:

		Quando ativado, se a última palavra de um título
		começa com letra maiúscula e é precedida por uma
		vírgula e um espaço, esta palavra é movida para o
		começo. Por exemplo: o título
			T:Clair de la lune, Au
		é impresso como:
			Au Clair de la lune

 

topmargin <unit>
	Default: 1cm
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define a margem superior como <unit>.

 

topspace <unit>
	Default: 0.8cm
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define o espaço vertical superior ('top') como
		<unit>. Esse espaço é colocado acima de peça e também
		no topo de páginas de continuação ('continuation
		pages').

 

tuplets <int> <int> <int>
	Default: 0 0 0
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define como desenhar as quiálteras.
		O primeiro <int> diz quando desenhar:
			0: auto (desenha quando não há travessão nos extremos)
			1: nunca
			2: sempre
		O segundo <int> diz o que desenhar:
			0: um colchete
			1: uma ligadura
			2: estender travessão sobre pausas (não funciona ainda)
		O terceiro <int> diz que valor imprimir:
			0: um número simples (valor de 'p')
			1: nenhum valor
			2: uma proporção ('p':'q')

 

vocalabove <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Coloca a letra ('vocals') acima da pauta.

 

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

 

vocalspace <unit>
	Default: 23pt
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define o espaço vertical antes da letra ('lyrics')
		como <unit>.

 

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

 

withxrefs <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: -x
		Imprime o número X: no título.

 

wordsfont <font> [<encoding>] [<size>]
	Default: Times-Roman 16
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define a fonte da letra ('lyrics') ao fim da peça como
		<font> de tamanho <size>.

 

wordsspace <unit>
	Default: 0cm
	Compilação: nenhum
	Linha de Comando: nenhum
	Descrição:
		Define o espaço vertical antes da letra ('lyrics') ao
		fim da peça como <unit>.

 

writehistory <bool>
	Default: 0
	Compilação: nenhum
	Linha de Comando: -n
	Descrição:
		Imprime a informação definida por 'infoname'.



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



Lista de pseudo-comentários tratados durante o processamento ('while parsed')
-----------------------------------------------------------------------------

 

begintext [<option>]
	Inicia a impressão de um texto livre. O texto aparece nas
	linhas seguintes (que podem começar com '%%' ou não). O texto
	termina em uma linha contendo
		%%endtext
	<option> pode ser:
	    'obeylines':          mantém as linhas como estão (default)
	    'align' ou 'justify': justifica as linhas
	    'ragged' ou 'fill':   preenche as linhas
	    'skip':               não imprime as linhas (o mesmo que
				  um comentário)
	    'right':              alinha no lado direito

 

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

 

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

 

endtext
	Ver 'begintext'.

 

multicol <command>
	Define impressão em várias colunas.
	<command> pode ser:
	    'start':	salva a posição vertical corrente e as margens
			esquerda e direita. Então, essas margens podem
			ser alteradas para imprimir música ou texto.
	    'new':	restaura a posição vertical de acordo com o
			prévio '%%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 também ser usado para agrupar algumas
	músicas e texto em uma mesma página.


 

newpage [<int>]
	Continua imprimindo em uma nova página e possivelmente
	reinicia a numeração de páginas em <int>.

 

repbra <bool>
	As casas de repetições (casa 1, casa 2 etc.) são normalmente
	mostradas quando são encontradas em uma voz. '%%repbra 0'
	impede sua impressão na voz corrente.

 

repeat [<n> [k]]
	Tenta substituir a seqüência por um ou mais sinais de
	repetição.
	Quando utilizado após uma barra de compasso, <n> indica o
	número 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> não será
	usado.
	Quando usado após uma nota ou pausa, <n> indica o número de
	notas e pausas a serem repetidas, e <k> quantas vezes essa
	repetição ocorre.
	Quando omitidos, <n> e <k> são iguais a 1.
	Nenhuma checagem é feita quanto à igualdade das seqüências.
	Ver 'sample5.abc' para exemplos.

 

score <definição>
	Consulte o padrão ABC versão 2.0 para a descrição.

 

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

 

setbarnb <int>
	Define o número do compasso como <int>.
	Quando encontrado fora de uma peça, esse comando é o mesmo que
	'%%measurefirst'. Se ocorrer no início de uma peça (depois do
	campo K:), a nova numeração inicia a partir do segundo
	compasso.

 

staff <["+" | "-"] int>
	Coloca os próximos símbolos da voz corrente na pauta <int>
	(1..n - ver sample4.abc para exemplo), ou na <+int>-ésima ou
	<-int>-ésima pauta.

 

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

 

staves <definition>
	Ver 'features.txt' para descrição.

 

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 função Postscript chamada no início da
	tablatura. Quando chamada, a pilha contém:
		- a largura da linha de música,
		- as coordenadas x e y,
		- o número da linha w: [0 .. n-1].
	<note-func> é a função Postscript chamada para cada nota.
	Quando chamada, a pilha contém:
		- a string tal como definida pela linha 'w:'.
		- as coordenadas x e y.
		- o número da linha w: (0 .. n-1).
	<note-bar> é a função PostScript chamada a cada barra de compasso.
	Quando chamada, a pilha contém:
		- a barra de compasso como string ABC.
		- as coordenadas x e y.
		- o número 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 <line of text>
	Imprime uma linha de texto.

 

vskip <h>
	Salta um espaço vertical de altura <h>.

| abc2pscompat | alignbars | aligncomposer | annotationfont | autoclef | barnumbers | barsperstaff | beginps | begintext | botmargin | bstemdown | center | comball | combinevoices | composerfont | composerspace | contbarnb | continueall | dateformat | deco | dynalign | encoding | endtext | EPS | exprabove | exprbelow | flatbeams | font | footer | footerfont | format | freegchord | gchordbox | gchordfont | graceslurs | gracespace | header | headerfont | historyfont | hyphencont | indent | infofont | infoline | infoline | infospace | landscape | leftmargin | lineskipfac | maxshrink | maxstaffsep | maxsysstaffsep | measurebox | measurefirst | measurefont | measurenb | multicol | musiconly | musicspace | newpage | notespacingfactor | oneperpage | pageheight | pagewidth | parskipfac | partsbox | partsfont | partsspace | postscript | printparts | printtempo | pslevel | repbra | repeat | repeatfont | rightmargin | scale | score | sep | setbarnb | setdefl | setfont-1 | setfont-2 | setfont-3 | setfont-4 | shiftunisson | slurheight | splittune | squarebreve | staff | staffbreak | staffnonote | staffsep | staffwidth | staves | stemheight | straightflags | stretchlast | stretchstaff | subtitlefont | subtitlespace | sysstaffsep | tablature | tempofont | text | textfont | textoption | textspace | timewarn | titlecaps | titlefont | titleformat | titleleft | titlespace | titletrim | topmargin | topspace | tuplets | vocalabove | vocalfont | vocalspace | voicefont | vskip | withxrefs | wordsfont | wordsspace | writehistory

(127 tópicos)

Copyright (C) 2004-2007 Hudson Lacerda