Provided by: manpages-it_3.73-2_all 
NOME
abc2ps - Traduce il formato ABC in PostScript
SINTASSI
abc2ps [opzioni] file ...
DESCRIZIONE
Il programma abc2ps legge un file di input contenente musica in formato abc e lo impagina direttamente in
PostScript. Può essere usato anche per fornire una lista del contenuto di un file abc.
Per una descrizione della sintassi di abc, vedere la guida dell'utente di abc che è una parte del
pacchetto abc2mtex.
USO GENERALE
Fondamentalmente, l'uso è il seguente:
abc2ps file1 file2 ...
dove file1, file2 ... sono i file abc di input. Questo fornirà una lista del contenuto dei file. Per
generare output Postscript, aggiungere l'opzione -o:
abc2ps file1 file2 ... -o
SELEZIONE MELODIE
Per selezionare melodie specifiche dai file, usare:
abc2ps file1 file2 ... -e selettore1 selettore2 ...
dove ogni selettore è un insieme di numeri xref di abc o un modello. Senza l'opzione -o, fornirà solo la
lista di melodie selezionate trovate nei file. Con l'opzione -o, l'output è generato solo per le melodie
selezionate.
Opzionalmente, la ricerca può essere fatta su altri campi usando queste opzioni al posto di -e: -R cerca
il campo `ritmo', -C cerca il campo `compositore', -S cerca il campo `sorgente'. -T cerca il campo
`titolo' (questo è il modo predefinito per le ricerche di modelli). Se è usata l'opzione -C, viene
visualizzato anche il campo del compositore quando viene elencato il contenuto dei file. Avviene lo
stesso con le opzioni -R e -S. L'opzione -A seleziona tutte le melodie, sovrascrivendo gli altri
selettori.
Per filtrare diversi file con lo stesso insieme di selettori, il formato è:
abc2ps file1 file2 -e selettori ...
Per usare un insieme diverso di selettori per ciascun file, usare un comando come il seguente:
abc2ps file1 -e 1-3 -f file2 file3 -R Jig
Questo selezionerà le melodie 1-3 dal file1 e le melodie con 'Jig' nel campo ritmo dal file2 e dal file3.
Più precisamente, l'opzione -f indica che gli argomenti seguenti (fino alla successiva opzione -e) sono
nomi di file. Ogni insieme di selettori è applicato ai file che lo precedono. Come precedentemente, le
opzioni -C, -S, -R possono essere usate al posto di -e per cambiare il campo cercato.
Per convenienza, ci sono due convenzioni:
Un argomento con l'estensione .abc è sempre considerato come un nome di file ed è trattato come se
fosse preceduto da -f.
Un argomento che è ovviamente un insieme di numeri xref è considerato come un selettore ed è
trattato come se fosse preceduto da -e.
Per esempio, tutti questi tre comandi selezionano le melodie 1-3 dal file A.abc e le melodie 5-7 dal file
B.abc:
abc2ps A.abc -e 1-3 -f B.abc -e 5-7
abc2ps A.abc -e 1-3 B.abc -e 5-7
abc2ps A.abc 1-3 B.abc 5-7
D'altro canto, questo NON funzionerà nel modo consueto:
abc2ps A 1-3 B 5-7 -o
perché il programma non ha modo di riconoscere che B è il
nome di un file di input e non un selettore di modello.
Per selezioni complicate su file di input multipli, potrebbe
essere meglio eseguire il programma in modalità interattiva (vedere
di seguito).
Ottenere output PostScript
Aggiungendo l'opzione -o, le melodie selezionate sono impaginate e scritte sul file di output. Per
impaginare tutte le melodie nel file book1.abc:
abc2ps book1 -o
Per impaginare specifiche melodie, usare un comando come
abc2ps book1 -e 1-3 5,20- 'House*' Hall -o
L'idea è quella di variare il numero e/o i modelli fino a quando i titoli desiderati vengono elencati,
poi aggiungere l'opzione -o alla lista degli argomenti per ottenere il file di output.
In modo predefinito, tutte le melodie selezionate sono scritte nello stesso file, con l'aggiunta degli
adeguati salti pagina. Usando l'opzione -E , si ottiene l'output in EPSF; ogni melodia è allora messa in
un file separato con un corretto bounding box e nessuna interruzione di pagina.
L'opzione -O determina dove viene diretto l'output. L'argomento di -O può essere sia un nome di file che
un =. In quest'ultimo caso si dice a abc2ps di scegliere il nome da se stesso.
Per le modalità PS e EPS, il nome del file di output è:
modalità PS:
predefinito Out.ps
-O NOME NOME.ps
-O = L'output per "foo.abc" è scritto in "foo.ps"
modalità EPSF:
predefinito Outnnn.eps, dove nnn è un numero progressivo
-O NOME NOMEnnn.eps
-O = Il nome del file di output è <titolo_melodia>.eps
Nota: se un file output esiste già sarà sovrascritto. Ciò accadrà se due melodie hanno lo stesso nome ed
è usata l'opzione -O = per l'output EPSF.
L'effettivo formato di output è governato dalle impostazioni dei parametri che possono essere messi nei
file di formato. Il file di formato può essere selezionato usando l'opzione -F; i file di formato sono
usualmente cercati sia nella directory corrente che nella directory /usr/share/abc2ps. Si faccia
riferimento alla sezione Output formating nel file /usr/share/doc/abc2ps/New.Features per una descrizione
dettagliata dei parametri disponibili.
Modalità interattiva
Se la riga di comando contiene l'opzione -i, abc2ps viene eseguito in modalità interattiva. Questo rende
possibile costruire file di output pezzo per pezzo. Lo svantaggio è che si deve riavviare il programma se
si fanno degli errori.
La modalità interattiva si avvia con:
abc2ps -i
Poi il programma è pronto per un input con la riga
select tunes:
Si dovrebbe rispondere con una riga di argomenti, che sono trattati esattamente nella stessa maniera
della modalità non interattiva. La sola differenza è che l'input non è eseguito prima attraverso la
shell, cosi` che i caratteri jolly non sono espansi e le virgolette non vengono rimosse. Di conseguenza
si dovrebbe usare Jig* al posto di 'Jig*', ecc. quando si specificano le stringhe di selezione e i nomi
dei file devono essere scritti per esteso. Per uscire dalla modalità interattiva, inserire 'q', 'quit' o
un input vuoto.
Per esempio, una "sessione" potrebbe apparire come questa:
abc2ps -i avvia abc2ps interattivamente
book1 elenca le melodie in book1.abc
book1 -e 1-10 elenca le melodie con xrefs 1-10 in book1
book1 -e 1-10 -o scrive queste melodie nel file Out.ps
book2 elenca le melodie nel file book2.abc
book2 -e House -o scrive le melodie con 'House' nel titolo
quit esce da abc2ps
Per rendere le cose più facili, ci sono tre caratteri speciali:
? mostra l'ultimo input usato;
! all'inizio della riga è sostituito dagli ultimi
file usati;
* all'inizio della riga è sostituito dall'ultimo
input.
Questo significa che lo stesso effetto dell'esempio precedente può essere ottenuto con la forma
abbreviata nel seguente modo:
abc2ps -i avvia abc2ps interattivamente
book1 elenca le melodie
! 1-10 equivalente a 'book1 1-10'
* -o equivalente a 'book1 1-10 -o'
book2 elenca le melodie nel file book2.abc
! -e House -o equivalente a 'book2 -e House -o'
q esce da abc2ps
Si noti che l'opzione -e non è necessaria nella riga `* 1-10' perché è chiaro che 1-10 è un selettore
(vedere sopra).
Un altro punto è che se sono usate opzioni aggiuntive quando si avvia interattivamente, queste funzionano
come modo predefinito per la modalità interattiva. Per esempio, avviando il programma con
abc2ps -io
tutte le melodie selezionate sono scritte immediatamente nel file output. L'uso del programma è molto
simile a quello di abc2mtex. Naturalmente, non è possibile elencare il contenuto del file (per aiutare
nella scelta riguardo i titoli) quando si usa il programma in questo modo.
Nella modalità interattiva, -O ed -E possono essere usate prima di redirigere l'output. Quando si commuta
a un altro file di output, il file precedente viene chiuso. Ricommutare successivamente allo stesso file
iniziale sovrascriverà il file.
Differenze da abc2mtex
Essenzialmente, tutte le caratteristiche descritte nella guida di abc2mtex dovrebbero funzionare. Ci sono
un po' di eccezioni:
La notazione delle legature S è stata sostituita dalla sintassi (...) (vedere di seguito).
I segni di chiave HP e Hp probabilmente non sono trattati esattamente nel modo giusto.
Non c'è una verifica automatica dei gambi delle note.
In questa versione non c'è il modo per trasporre la musica automaticamente.
Alcune caratteristiche extra
Per gli esempi, vedere il file /usr/share/doc/abc2ps/examples/sample.abc.
Codici per le decorazioni.
Includendo quelle definite nella sintassi standard di abc, sono interpretate le decorazioni
seguenti:
. dot, staccato
J slide
M tenuto (M='em-phasis')
H corona (fermata)
~ abbellimento
R arpeggio
T 'tr' sopra la nota
u archetto verso l'alto
v archetto verso il basso
k >-come accento
K ^-come accento
Sequenze di escape.
L'inserzione di una stringa tra due barre inverse in una riga di musica delimita una sequenza di
escape. Nella versione attuale, queste sono trattate come campi di informazione. Ciò rende
semplice cambiare la tonalità, il metro o la lunghezza predefintita all'interno di una riga
(vedere sample.abc).
Gruppi irregolari (N-uple).
abc2ps può gestire casi generali di gruppi irregolari usando la sintassi:
(p:q:r abcd ...
Questo significa `metti p note nel tempo di q per le successive r note.' Se q non è fornito, usa
le impostazioni predefinite come descritto nella guida dell'utente di abc2mtex. Se r non è dato,
usa il valore di p in modo predefinito. Per esempio:
(3::2 = (3:2:2; (3 = (3:2:3
Il numero scritto sopra il gruppo irregolare è p. Questa sintassi generalizzata è compatibile con
il vecchio uso. In realtà, q non è per niente usato qui; è rilevante solo per i programmi che
riproducono la musica.
Accordi.
Il programma accetta la notazione +...+, ma sembra più intuitivo usare un qualche tipo di
parentesi per raggruppare insieme le note che formano un accordo. Questo programma accetta le
parentesi quadre:
[ace][adf]
al posto della sintassi +...+. La notazione abc permette formalmente note con durate differenti
sullo stesso gambo: [a/bc2] e cosi` via. Questo programma assegna a tutte le note di un accordo la
durata della prima nota nella parentesi. Un accordo con due note identiche realizza un unisono
(una testa con due gambi uno in su e l'altro in giù), per esempio, [AA].
Legature d'espressione e di valore.
Al posto della sintassi SabcSd per una legatura sopra le note abcd, questo programma usa la
notazione
(abcd)
per una legatura sopra le note abcd. Permette casi come (ab(cd)) e ((ab)cd) e (a(bc)d) e
legature sopra legature simili. Per collegare tre o quatto note con le legature (per esempio, per
una nota tenuta su diverse battute) usare (a(b)c) o, con le legature di valore, a-b-c.
La regola è che ogni nota da sola all'interno delle parentesi come (b) termina una precedente
legatura e, allo stesso momento, ne inizia una nuova.
Notare che la sintassi della legatura (...) non interferisce con lo stile (3abc per i gruppi
irregolari. Se una parentesi '(' è seguita da un numero k, è iterpretata come l'inizio di un
gruppo irregolare di k note, altrimenti è l'inizio di una legatura. Per esempio, una legatura è
messa sopra le ultime due terzine in questa riga: (3abc ((3cde) ((3efg).
Una parentesi non bilanciata ')' o '(' indica la continuazione di una legatura su una riga vicina.
Questo è necessario (per esempio) per rendere possibile l'interruzione automatica di righe. Essa
creerà anche strane e inaspettate legature aggiuntive se il file di input contiene la sintassi
scorretta (3abc) invece di (3abc per le terzine.
Stanghette.
I simboli seguenti denotano una doppia stanghetta all'inizio o alla fine di un pezzo (senza punti
di ripetizione): [| produce una barra spessa seguita da una sottile, |] una barra sottile seguita
da una spessa.
Per un miglior risultato quando si usa l'interruzione di riga automatica, il programma dividerà
alcuni tipi di stanghette quando queste sono alla fine di una riga. Per esempio, :: diventa :|
insieme con |: sulla riga successiva, |: diventa | insieme con |: sulla riga successiva, :|2
diventa :| insieme con [2 sulla riga successiva ecc.
Il Campo E.
Questo campo può essere usato per impostare alcuni parametri dall'interno del file:
shrink imposta la modalità "glue" (colla) per comprimere
space imposta la larghezza naturale di glue
stretch modalità glue estesa
fill modalità normale per riempire i pentagrammi
break ignora continuazioni
xref scrive i numeri di xref sull'output
one scrive una melodia per pagina
newpage inizia una nuova pagina per la successiva melodia
lw ppp imposta la larghezza del pentagramma locale a ppp
punti.
Per esempio, per ottenere come output una singola melodia in un formato ristretto, mettere E:lw
400 dentro l'intestazione di questa melodia. Se questo è messo dopo l'intestazione ma dentro il
corpo della melodia, solo la musica è impostata con una differente larghezza e il titolo è scritto
come prima.
Chiave di basso e di contralto.
La chiave di basso è selezionata accodando la parola bass alla specificazione della tonalità. Per
esempio, K:G bass. Le note sono quindi scritte in modo che C sia sotto il pentagramma e c sia nel
terzo spazio dall'alto, il che è uno spostamento in giù di una linea rispetto alla chiave di
violino.
Per cambiamenti di chiave in-linea, usare una specificazione in-linea come [K:G bass] (prima era
K:G bass; questo è ancora supportato). Se la chiave in sè non cambia, è sufficiente scrivere
[K:bass] e similmente [K:treble].
Usare similmente alto per la chiave di contralto (viola o C).
Cantato.
Le parole del testo allineate sotto il rigo sono specificate usando una riga direttamente sotto il
rigo, facendola iniziare con w:. Per esempio:
edc2 edc2 |
w: Tre gatti ciechi, tre gatti ciechi
Ogni parola delimitata da spazi bianchi nella riga w: è associata con una nota, in sequenza. I
seguenti simboli speciali sono disponibili per modificare questo comportamento:
* salta una nota
- divide una parola in due sillabe, associate con
due note, con un trattino, `-', tra di esse
\- aggiunge un trattino senza dividere la parola
| si sposta in avanti sino alla linea di battuta successiva.
~ viene reso come uno spazio, ma comprime le parole da
scrivere sotto un'unica nota. Cioè hey~ho produrrà le due
parole `hey' e `ho' sotto un'unica nota.
_ traccia un piccolo segno di sottolineatura dalla nota
precedente a questa.
Per più di una riga di parole del testo, usare semplicemente diverse righe w:. Per tracciare un -
senza interrompere la parola in quel punto, usare un carattere di escape cosi` \-.
Si noti che \\ nella riga di musica in abc ora definisce una interruzione di pentagramma. Questo è
utile quando si impaginano canzoni, poiché è tedioso dividere la riga esplicitamente quando si
sposta un'interruzione di rigo quando sono presenti righe con il testo.
Se una parola inizia con un numero, questo è interpretato come numerazione di una stanza e viene
rientrato di un po'. In altre parole, usare qualcosa come:
w: 1.~~Tre gatti ciechi
per mettere un numero prima di "Tre".
Musica a pentagrammi multipli.
Abc2ps gestisce musica che consiste di diverse voci. Questo è fatto usando righe V:, come:
V:2 name="Clarinet 2" short="Cl.2" clef=treble stems=down
(Qui il numero 2 in V:2 è una stringa arbitraria, ogni identificatore formato da una singola
parola può essere usato al suo posto.) In seguito, si può commutare la voce usando semplicemente
V:2. Le varie impostazioni, chiave, durata predefinita, ecc., sono mantenute separatamente per
ogni voce.
Accordi di chitarra, prima e seconda terminazione e interruzioni di riga sono presi solo dalla
voce più alta. Ogni voce può avere il suo proprio testo.
Ci sono diversi parametri che controllano la sistemazione dei pentagrammi, delle graffe, parentesi
quadre, lunghe linee di battuta ecc. Fare riferimento a /usr/doc/abc2ps/changelog per maggiori
informazioni.
Le singole voci possono essere selezionate da un manoscritto a più voci usando l'opzione -V. Per
esempio, -V 1-2,4 estrarrà le prime due voci e la quarta voce. Specificatamente, questo rende
possibile generare partiture a voce singola per l'uso di singoli musicisti.
Scrivere testo tra la musica.
Questo può essere fatto usando i pseudocommenti in tre modi. Primo:
%%text Questa è una riga di testo.
scrive una riga di testo nell'output. Secondo,
%%center Questa è un'altra riga di testo.
scrive ancora una riga, ma centrata. Da ultimo,
%%begintext
Prima riga di testo
Seconda riga
E ancora un'altra riga.
%%endtext
che scriverà un blocco di diverse righe. Per evitare conflitti con altri programmi, le righe di
testo stesse possono essere precedute con %%.
Vedere /usr/share/doc/abc2ps/New.Features per ulteriori informazioni.
Numeri di battuta ed etichette.
Usare l'opzione -k per abilitare i numeri di battuta. Per esempio, -k 1 numererà ogni battuta, -k
5 numererà ogni cinque battute, ecc. L'opzione -k 0 numererà la prima battuta in ogni rigo. In
alternativa, usare il pseudo-commento %%barnumbers.
Il programma conta le battute automaticamente, cercando di fare la cosa giusta alla prima e alla
seconda conclusione. Cioè, ricorda il numero di battuta all'inizio della prima conclusione, poi
ritorna a questo valore all'inizio della seconda conclusione. Cosi`, se c'è una melodia con 2x8
battute con la prima e la seconda conclusione dopo le prime 8 battute, si otterrebbero comunque 16
battute totali.
All'interno di una singola melodia, i numeri di battuta sono contati attraversando i limiti delle
parti. Tuttavia, se un titolo T: appare dentro una melodia, il numero di battuta è reimpostato a
1. Si può usare una riga T: vuota per resettare il numero di battuta senza scrivere effettivamente
un titolo.
Le etichette delle battute sono lettere maiuscole A, B, C, ... per marcare punti specifici
all'interno della musica. La loro sintassi è simile a quella degli accordi della chitarra, ma sono
posizionate prima di una linea di battuta al posto di una nota o pausa, per esempio,
| abcd "A"| ABCD |
posiziona la lettera A sopra la seconda linea di battuta. Nel caso in cui qualcuno volesse una
etichetta sulla prima battuta (che usualmente non è preceduta da una linea di battuta), è stato
introdotto un nuovo simbolo, [|], per denotare una linea di battuta `invisibile'.
I tipi di carattere per i numeri e le etichette di battuta possono essere impostati usando i
pseudo-commenti %%barnumberfont e %%barlabelfont.
Riquadri.
Nella musica stampata, i numeri delle battute sono resi spesso più visibili mettendo un riquadro
attorno ad essi. Anche questo è possibile. Infatti, un riquadro può essere messo attorno alla
maggior parte dei pezzi di testo aggiungendo la parola box alla specificazione del tipo di
carattere, per esempio,
%%barnumberfont Times-Italic 11 box
Ciò può essere fatto per il titolo, accordi della chitarra, cantato, ecc. Per abilitare il riquadro senza
cambiare lo stile e/o la dimensione dei caratteri, può essere usato il carattere *, come in
%%titlefont * * box
OPZIONI
Questo è un breve sommario delle opzioni supportate da abc2ps. Per informazioni più dettagliate vedere la
documentazione in /usr/share/doc/abc2ps.
Modi di funzionamento
-o Scrive l'output per le melodie selezionate.
-E Produce output EPSF, una melodia per file.
-Onomefile
Imposta il nome del file di output a nomefile (quello predefinito è Out.ps). Se nomefile è =,
crea un nome per il file di output a partire dal nome del file in input o dal titolo della melodia
(in modalità EPSF).
-i Funzionamento interattivo.
-vn Imposta la verbosità per l'output a schermo a n. 0 fornisce un output molto piccolo, da 1 a 3
mostra successivamente più informazioni. Verbosità più grandi di 10 servono per il debug.
-h Rapido aiuto, equivalente all'esecuzione di `abc2ps' senza alcun argomento. Mostra anche le
impostazioni predefinite per alcuni parametri.
-V Questa opzione era usata per mostrare il numero di versione ma ora è usata per la selezione della
voce (vedi sopra). Per visualizzare il numero della versione, usare l'opzione -h.
Selezione
-e Gli argomenti seguenti sono selettori.
-f Gli argomenti seguenti sono nomi di file.
-T Cerca il campo Titolo di ABC (predefinito).
-C Cerca il campo Compositore di ABC.
-R Cerca il campo Ritmo di ABC.
-S Cerca il campo Sorgente di ABC.
-V str Seleziona voci, per esempio, -fB-V 1,4-5.
Formattazione
Queste opzioni cambiano l'aspetto dell'output:
-H Mostra le impostazioni di tutti i parametri di formattazione.
-p Genera un output `pretty' (bello), con più spazi vuoti tra le melodie, caratteri più grandi per i
titoli e simboli musicali più grandi. In modo predefinito, l'impaginazione stringe le melodie per
ridurre il il numero delle pagine. Questo usa il contenuto di un'impostazione di parametri
chiamata pretty.
-P Simile a -p, ma usa un'impostazione di parametri chiamata pretty2.
-s xxx Scala l'output della musica con un fattore xxx.
-w www Imposta la larghezza del pentagramma a www punti, inch o centimetri.
-m mmm Imposta il margine sinistro a mmm punti, inch o centimetri.
-d xxx Imposta la separazione dei pentagrammi a xxx punti, inch o centimetri.
-x Include numeri di riferimenti incrociati (l'intestazione X di ABC) nell'output.
-k n Numera ogni n battute; se n è 0, numera ogni prima battuta di ogni rigo.
-n Include note storiche e altre cose al di sotto di ogni melodia.
-N Include nell'output i numeri di pagina.
-1 Scrive ogni melodia su di una pagina separata.
-l Opera in modo orizzontale (landscape).
-g shrink|space|stretch|fill
Imposta la modalità `glue'. La modalità predefinita è fill, che riempie il pentagramma.
-F format
Legge il formato dal file format.
-D directory
Cerca i file formato nella directory directory.
-X x Imposta il rigore nella spaziatura tra le note, 0 < x < 1.
Trasposizione
-T n Traspone di n semitoni (usare _n per numeri negativi).
-T note
Traspone il basso fondamentale su/giù alla nota note.
Interruzioni di riga
-a x Imposta il massimo grado di contrazione permesso a x, dovex varia tra 0.0 e 1.0.
-b Forza un'interruzione di pentagramma alla fine di ogni riga, anche se la riga ha il simbolo di
continuazione \ alla fine.
-c Accoda il simbolo di continuazione a tutte le linee di musica, il che porta all'interruzione
automatica di riga.
-B n Formatta con n battute su ogni pentagramma.
Allocazione delle risorse
-maxs n
Imposta il numero massimo di simboli (predefinito 800).
-maxv v
Imposta il numero massimo di voci (predefinito 4).
FILE
/usr/share/abc2ps/*.fmt
Vari file formato d'esempio.
/usr/share/doc/abc2ps/examples/*
Vari esempi di file ABC.
VEDERE ANCHE
/usr/share/doc/abc2ps/ReadMe.abc2ps
Una versione più dettagliata delle informazioni contenute in questa pagina di manuale.
/usr/share/doc/abc2ps/New.Features
Una descrizione delle nuove caratteristiche della versione 1.2.4b di questo programma. Alcune
informazioni da questo file sono state integrate parzialmente in questa pagina di manuale.
/usr/share/doc/abc2ps/changelog
Una descrizione dei cambiamenti recenti nelle versioni recenti di questo programma, includendo
l'impaginazione di voci multiple. Alcune informazioni da questo file sono state integrate in
questa pagina di manuale.
/usr/share/doc/abc2ps/layout.txt
Una descrizione dell'algoritmo di impaginazione usato in abc2ps.
AUTORE
Questa pagina di manuale è stata scritta da Anselm Lingnau <lingnau@debian.org>, per il sistema Debian
GNU/Linux. Traduzione e adattamenti in italiano a cura di Hugh Hartmann <hhartmann@fastwebnet.it>.
Revisione a cura di Beatrice Torracca <beatricet@libero.it>
ABC2PS(1)