|
Michele Liberi mail: mliberi@gmail.com cell: +393485211456 telegram: @MicheleLiberi |
Tra il 1990 ed il 2002 ho lavorato come sistemista in IBM, e mi occupavo principalmente di sistemi UNIX, in particolare di IBM AIX.
In quel periodo lavoravo principalmente negli uffici tecnici dove si usavano vari CAD.
Il problema tipico nelle aziende era che il CAD non poteva essere dato a tutti i dipendenti dell'azienda per vari motivi:
D'altra parte c'era l'esigenza di distribuire in azienda, a fornitori e clienti, documenti generati dall'ufficio tecnico in un formato non modificabile. Serviva uno strumento semplice ed economico, che potesse essere installato su qualunque PC, con il quale visualizzare e stampare i disegni generati dal CAD.
Fu così che nel 1991 decisi di sviluppare un visualizzatore HPGL/2, un linguaggio universale per la definizione di immagini in formato vettoriale, usato da tutti i CAD per la stampa su plotter.
HPGL sta per Hewlett Packard Graphic Language ed è un marchio registrato della Hewlett Packard. È un linguaggio usato per stampare su plotter o stampanti che è diventato, essendo lo standard adottato dalla IBM per i suoi plotter, uno standard internazionale.
Quando scrivo che è un linguaggio universale intendo che tutti i CAD con i quali avevo a che fare avevano la possibilità di produrre file in formato HPGL/2.
In particolare è stato testato con file generati da:
La prima versione, che funzionava in ambiente DOS, è del febbraio 1991.
L'ultima versione DOS del programma hpgl2 risale al 1995.
Infatti nel frattempo si era diffuso il sistema Windows che stava soppiantando il DOS, e quindi le versioni successive girano su sistemi Windows 16-bit.
Il pacchetto di installazione conteneva questi file:
| - | readme.txt | : | documentazione |
|---|---|---|---|
| - | default.mtf | : | esempio di definizione di un font vettoriale |
| - | hpglsamp.plt | : | esempio disegno HPGL, utile per testare il programma |
| - | dview00.exe | : | eseguibile per scheda grafica VGA, senza coprocessore matematico 8087 |
| - | dview01.exe | : | eseguibile per scheda grafica VGA, con coprocessore matematico 8087 |
| - | dview10.exe | : | eseguibile per scheda grafica TSENG et/4000, senza coprocessore matematico 8087 |
| - | dview11.exe | : | eseguibile per scheda grafica TSENG et/4000, con coprocessore matematico 8087 |
Questa versione del visualizzatore non implementa il set completo di primitive HPGL descritte nel libro The HP-GL/2 Reference Guide. A handbook for program developers, edito dalla Addison Wesley Publishing Company con codice ISBN 0-201-56308-8. Sono state implementate solo le primitive effettivamente contenute nei file generati dai CAD menzionati sopra, cioè:
********************************************************************** ******* Lista delle istruzioni hpgl/2 e relativa sintassi ******* ********************************************************************** CONFIGURATION group DF Default values IN [1] Initialize IP [x1 y1 [x2 y2]] Input Absolute P1 & P2 IR [x1 y1 [x2 y2]] Input Relative P1 & P2 IW [x1 y1 x2 y2] Input Window PG [n] Advance full page RO [0|90|180|270] Rotate Coordinate system RP [n] Replot SC [x1 x2 y1 y2[type[le,bo]]] Scale instruction VECTOR group AA Xc Yc [alfa [chord]] Arc Absolute AR Xc Yc [alfa [chord]] Arc Relative AT Xb Yb Xe Ye [chord] Absolute Arc 3 point CI r [chord] Circle PA [x y]... Plot Absolute PD [x y]... Pen Down PE [flag][value/xy]...; Polyline Encoded PR [x y]... Plot Relative PU [x y]... Pen Up RT Xb Yb Xe Ye [chord] Relative Arc 3 point POLYGON group EA x y Edge Rectangle Absolute ER x y Edge Rectangle Relative EW r alfa sweep [chord] Edge Wedge EP Edge Polygon FP Fill Polygon PM n Polygon Mode RA x y Fill Rectangle Absolute RR x y Fill Rectangle Relative WG r alfa sweep [chord] Fill Wedge LINE & FILL group AC [x y] Anchor Corner FT type [opt1 [opt2]] Fill Type LA [kind value]... Line attributes LT [type [len [mode]]] Line Type PW [width [pen]] Pen Width RF [index [w h pen...] Raster fill Definition SM [string] Symbol mode SP [pen] Select Pen UL [index [gap...]] User defined line type WU [type] Pen Width unit selection CHARACTER group AD [kind value]... Alternate font def. CF [mode [pen]] Character fill mode CP [spaces lines] Character Plot DI [run rise] Absolute Direction DR [run rise] Relative Direction DT [char [mode]]; Label Terminator DV Define Variable Text path ES [w [h]] Extra Spaces LB [ch]... terminator Label LO [position] Label Origin SA Select alternate font SD [kind value]... Standard font def. SI [w h] Absolute char size SL [tg] Char Slant SR [w h] Relative char size SS Select standard font TD [mode] Transparent data TECHNICAL GRAPHICS Ext group BP [kind value]... Begin plot CT [mode] Chor Tolerance mode DL [ch [[up] x y]...] Download char EC [n] Enable cutter FR Frame advance MC [mode] Merge control MG [message] Message MT [type] Media Type NR [timeout] Not Ready OE Output Error OH Output Hard clip limits OI Output Identification OP Output P1 & P2 OS Output Status PS [len w] Plot Size QL [quality] Quality Level ST [switches] Start VS [velocity [pen]] Velocity Select PALETTE group CR [r g b R G B] Set Color Range NP [n] Number of Pens PC [pen [r g b]] Pen Color Assignment SV [type [opt1 [opt2]] Screened Vectors TR [n] Transparency Mode DUAL Context Extensions FI [fontID] Primary font selection FN [fontID] Secondary font selection SB [n] Scalable bitmap fonts DC Digitize Clear DP Digitize Point OD Output Digitized Points
Sintassi del comando
Uso: hpgl2 { Opzione | Nomefile | @Nomefile }...
Nomefile : Nome del file HPGL da processare. Può contenere wildcards
@Nomefile: Nomefile contiene, uno per linea, i nomi dei disegni. No wildcards
OPZIONI: Il valore tra parentesi è il valore di default');
-A4 Disegno in formato A4 (-B430,200 -T10430, 7400)
-A3 Disegno in formato A3 (-B380,430 -T15580,10430)
-Bx,y Setta il punto basso-sinistra al punto x,y (A3)
-Tx,y Setta il punto alto-destra al punto x,y (A3)
-Cc Colore del foglio da disegno = c [0..15] (nero)
-Nc Tutte le penne sono del colore c [0..15]
-Pnc Penna numero n [1..8] del colore c [0..15]
-Enomefile Gli errori vengono riportati su nomefile (HPGL.ERR)
-Fnomefile Vengono lette le opzioni da nomefile: una per riga
-Gnomefile Carica il font grafico presente in nomefile
-Rnomefile Print Screen interno sul file specificato (LPT1)
-D Print Screen a carico di un TSR esterno
-OString Mode string per il PrintScreen
-K Keyboard Selection. Non usa il mouse anche se presente
-I Zoom IsoTropici on/off (ON)
MANUALE
VISUALIZZAZIONE SU PS/2 DI DISEGNI
IN FORMATO HPGL
=========================
Generalità sul programma
=========================
Il lavoro oggetto di questa pubblicazione è un programma, di nome
"HPGL Interpreter", che funziona in ambiente DOS. È essenzialmente
uno strumento di consultazione su PS/2 di disegni generati su CAD in
formato HPGL(*). Permette infatti di visualizzare il disegno, fare
degli zoom, stampare le schermate prodotte.
È uno strumento estremamente versatile in quanto sono
numerosissimi i parametri di configurazione. È in grado di
utilizzare il coprocessore matematico e la modalità grafica
1024x768, ma funziona anche con una normalissima VGA.
Tramite questo programma è possibile distribuire il disegno in
consultazione nell'azienda senza dover produrre i disegni in formato
cartaceo.
HPGL (*) sta per Hewlett Packard Graphic Language ed è un
linguaggio per la descrizione vettoriale di disegni usato per
disegnare su plotter o stampanti che è diventato, essendo lo standard
adottato dalla IBM per i suoi plotter, uno standard internazionale.
In quanto standard moltissimi programmi di disegno hanno la
possibilità di generare un output HPGL, e fra questi trovano
sicuramente posto i CAD (CATIA, CADAM, AUTOCAD, ECOCAD, GBG ecc.).
(*) HPGL è un marchio registrato della Hewlett Packard.
==============================
Requisiti Hardware e Software
==============================
Hardware: una qualunque macchina basata su processore 80x86 con
scheda grafica VGA. In caso di presenza del coprocessore
matematico il programma lavora il 35% più veloce. Per la
modalità 1024x768 è necessaria una SVGA basata su
processore Tseng-Lab ET4000 o Cyrrus (ad esempio i PS/VP
IBM). È anche consigliabile la presenza del mouse.
Software: qualunque versione del DOS. In caso di presenza del Mouse
deve essere presente il corrispondente driver (MOUSE.SYS
oppure MOUSE.COM). Funziona anche nelle shell DOS di
Windows ed OS/2.
================================
Cenni sui sistemi di coordinate
================================
I punti sul foglio da disegno sono referenziati in HGPL usando le
coordinate cartesiane, ovvero con coppie di numeri. Dalle istruzioni
HPGL vengono usati due sistemi di riferimento:
Assoluto: È un sistema di riferimento fisso. L'origine di questo
sistema è fissata prima di iniziare il disegno (cfr.
istruzioni IP e SC; cfr. opzioni -A3 -A4 -B -T).
Relativo: Il sistema di riferimento ha origine nel punto in cui si
trova la penna. Ogni punto espresso con questo sistema di
riferimento è quindi relativo alla posizione attuale della
penna.
===========================
Procedura di installazione
===========================
Il pacchetto è formato dai seguenti file:
H.EXE : Eseguibile per VGA, non usa il coprocessore
H87.EXE : Eseguibile per VGA, coprocessore installato
HH.EXE : Eseguibile per SuperVGA, no coproc
HH87.EXE : Eseguibile per SuperVGA, coprocessore installato
DEFAULT.MTF : File di esempio per personalizzare i fonts
H.DOC : questo file
Per l'installazione è sufficiente copiare in una directory del PATH
l'eseguibile più adatto per la propria configurazione HW nel file
HPGL.EXE.
ESEMPIO: per un normale 286 o 386 senza coprocessore matematico e
scheda grafica VGA digitare:
MD C:\HPGL
COPY a:h.exe c:\HPGL\HPGL.EXE
N.B. tutti i processori 486 sono dotati di coprocessore matematico,
per cui è preferibile installare la versione '87', il
programma girerà il 35% più veloce.
Per richiamare il programma bisognerà in alternativa:
1. Posizionarsi sulla directory in cui è stato copiato
2. Accertarsi che la directory sia nel PATH
3. Richiamare il programma con il nome completo
(ES. C:\hpgl\hpgl.exe [parametri])
========================
Sintassi di attivazione
========================
Da linea comandi del dos digitare il seguente comando:
HPGL {[Opzione] | Nomefile | @Nomefile }...
Il comando, dato senza parametri, visualizza una schermata di
aiuto.
È possibile passare un numero arbitrario di parametri, che vengono
processati per ordine da sinistra a destra, ognuno di essi pu•
essere:
Nomefile : Nome del file HPGL da processare. Può essere dato
usando le wildcards (* e ?) che assumono il significato
classico della linea comandi DOS. Non esiste problema di
formato anche se il file proviene dal mondo UNIX. Non
è neanche necessario che le istruzioni siano su più
linee. Nessun problema di compatibilità con l'output
di qualunque CAD.
Se sulla linea del comando c'è più di un nome di file, i file
vengono elaborati in sequenza ed avrò a video una sovrapposizione
dei disegni, esattamente come se facessi i due plottaggi sullo stesso
foglio.
ATTENZIONE!!! al fatto che all'interno di un disegno HPGL può
essere definito un opportuno sistema di coordinate per cui la
sovrapposizione di più disegni potrebbe dare risultati poco
significativi.
@Nomefile : Il file di testo Nomefile è una lista di nomi di file
da processare, uno per linea. Non sono permesse
wild-cards, tuttavia i nomi specificati all'interno
ne possono contenere.
In questo modo è possibile spezzare il disegno su più file
mettendo su un file "d'assieme" la lista di file che compongono il
disegno. In questo modo posso sfruttare la possibilità che hanno
praticamente tutti i CAD di generare i plottaggi "per livelli". Per
riottenere l'intero disegno basterà mettere su un file la lista dei
nomi di file che compongono il disegno.
Supponiamo ad esempio di avere una mappa stradale. Tramite il CAD
di gestione genero un primo file che contiene le sole autostrade che
chiamerò AUTOSTRADE.PLT, un secondo file che contiene le sole
statali, che chiamerò SS.PLT, ed un terzo file che contiene le strade
secondarie che chiamerò ALTRE.PLT. Se volessi vedere a video le tre
mappe sovrapposte potrei dare il comando:
C:\> HPGL autostrade.plt SS.plt altre.plt
oppure potrei creare un file d'assieme, di nome MAPPA.ASS, che
contiene, uno per riga, i nomi dei tre file creati precedentemente e
successivamente dare il comando:
C:\> HPGL @mappa.ass
Opzioni:
-A4 Disegno in formato A4 (-B430,200 -T10430, 7400)
-A3 Disegno in formato A3 (default)(-B380,430 -T15580,10430)
-Bx,y Setta il punto basso-sinistra al punto x,y
-Tx,y Setta il punto alto-destra al punto x,y
Le quattro opzioni su descritte fanno riferimento a due punti
particolari del disegno che vengono posti in corrispondenza degli
angoli del video (vedi anche istruzioni IP e SC). Dopo queste
impostazioni risulterà visibile a video solo il rettangolo
selezionato del disegno. La stessa operazione può essere fatta
successivamente con le operazioni di ZOOM o, da programma HPGL, con
le istruzioni IP ed SC. Per default il video viene posto in formato
A3 ovvero con il punto in basso a sinistra alle coordinate (380,430)
ed il punto in alto a destra alle coordinate (15580,10430).
La posizione relativa schermo-foglio da disegno può essere variata
anche interrativamente con le operazioni di ZOOM (cfr).
-Cc Colore del foglio da disegno = c [0..7]
-Nc Tutte le penne sono del colore c [0..15]
-Pnc Penna numero n [1..8] del colore c [0..15]
Le tre opzioni controllano i colori utilizzati durante la
visualizzazione. Rispettivamente il colore di fondo dello schermo, ed
il colore delle 8 penne che l'HPGL mette a disposizione. È possibile
impostare tutte le penne in una volta sola con l'opzione -N.
Il parametro c (colore) è un numero nell'intervallo da 0 a 15 sia
per il colore di fondo, che per il colore delle penne. La
corrispondenza numeri-colori viene fatta secondo la seguente
tabellina:
0 Nero 8 Grigio
1 Blue 9 Blue Chiaro
2 Verde 10 Verde Chiaro
3 Ciano 11 Ciano Chiaro
4 Rosso 12 Rosso Chiaro
5 Magenta 13 Magenta Chiaro
6 Marrone 14 Giallo
7 Grigio Chiaro 15 Bianco
Per default le penne sono otto e vengono assegnate progressivamente
ai colori che vanno dall'otto al quindici, la penna zero è sempre del
colore di fondo. Il colore di fondo dello schermo è per default
Grigio chiaro.
Tutti i settaggi dei colori delle penne possono anche essere
variati interattivamente con la funzione F4:Colors (Cfr).
-Enomefile Gli errori vengono riportati su nomefile.
Ogni volta che il programma riscontra un errore durante il suo
funzionamento questo viene scritto sul file indicato da questa
opzione. Per default il file è HPGL.ERR. Al termine delle operazioni
di visualizzazione grafica, il file degli errori viene anche stampato
a video e quindi, se vuoto, cancellato. Non volendo memorizzare su
nessun file questo output si può usare la sintassi -Enul
-Fnomefile Vengono lette le opzioni da nomefile: una per riga.
Il file nomefile contiene una sequenza di opzioni già memorizzate.
Le opzioni vanno poste una per riga con lo stesso identico formato di
quando vengono messe su linea di comando. L'unica eccezione riguarda
l'opzione -F stessa che non può essere presente nel file, ma deve
essere necessariamente data da linea comandi.
-Gnomefile Carica il font grafico presente in nomefile.
Il font grafico è un file in cui sono descritti i movimenti della
penna per tracciare un determinato carattere. Viene usato dalle
istruzioni LB e PB (cfr). Ogni riga di nomefile è un comando del tipo:
1) X=integer Viene definita l'ampiezza del rettangolo che
contiene il carattere. Default 100.
2) c: xxx yyy ... Vengono definiti i movimenti della penna
all'interno della plot cell per disegnare il
carattere. Le coordinate xxx yyy vanno date a
coppie e sono le coordinate cartesiane di
punti da raggiungere con la penna. Se la prima
coordinata è superiore a 128 viene diminuita
di 128 ed il movimento viene fatto a penna
alzata. Il punto di partenza della penna è
sempre 0,0.
3) qualunque altra cosa contenga la linea viene ignorata
N.B. Esiste un font già precaricato. Tale font è completamente
descritto nel file di esempio DEFAULT.MTF che può essere quindi
usato come base per personalizzare, aggiungere, o cancellare
caratteri.
-H Comando [Parametri] Attivato da F8. DEVE essere l'ultima opz.
Dall'interno del programma è possibile richiamare comandi DOS con
il tasto funzionale F8 (cfr). Se il comando da mettere in esecuzione,
e gli eventuali parametri, sono specificati, verrà eseguito senza
attendere INPUT da parte dell'utente; in caso contrario verrà
richiamato l'interprete di comandi del DOS. Battere exit per ritornare
al HPGL Interpreter. Tutti i parametri che seguono l'opzione -H
verranno passati al comando chiamato e non interpretati come comandi.
-D Print Screen a carico di un TSR esterno
Il programma ha infatti una sua routine per la stampa dello schermo
che usa la modalità EPSON ESC*5, ovvero 72 dpi sia in orizzontale che
in verticale. Questa modalità permette di vedere l'immagine non
deformata quando viene stampata. La procedura inoltre filtra i colori
in modo che il colore di fondo non venga stampato, e qualunque altro
colore generi su stampante un pixel nero; permette inoltre di
stampare una zona del video invece dell'intero schermo e di
interrompere la stampa prima che sia terminata. Il tasto PrtScr del
DOS viene normalmente disabilitato. Tutto questo può essere evitato
specificando l'opzione -D. Il controllo ritorna in questo modo al TSR
che controlla l'interrupt $05, ad esempio GRAPHICS.COM.
-OString Mode string per il PrintScreen. (#27*#5 ->72x72 dpi)
Con questa opzione è possibile modificare la modalità di stampa
usata dal PrtScr del programma. Di default per ogni riga in grafica
da stampare viene utilizzato il modo grafico ESC * 5, che
corrisponde, secondo lo standard EPSON, al modo 72 dpi x 72 dpi. Nel
caso in cui si disponesse di una stampante che non supporta questo
modo o volendo utilizzarne un'altro è possibile specificare qui una
diversa stringa di setup. Ad esempio per utilizzare il modo standard
singola densità IBM si può specificare -O#27K che imposta la
stampante a 60 dpi x 72 dpi con una leggera deformazione
dell'immagine. Per inciso questa è la modalità usata dal comando
GRAPHICS.COM del DOS5 se non specificano particolari parametri. Va
da sè che questa opzione è del tutto inutile se è stata
specificata l'opzione -D.
-K Keyboard Selection. Non usa il mouse anche se presente
Normalmente il mouse viene utilizzato per selezionare il rettangolo
corrispondente alla parte di disegno da zoomare o da stampare. Se il
mouse non è presente il programma permette di utilizzare i tasti
cursore. Volendo eliminare il test di presenza del mouse o volendo
forzare l'uso della tastiera si può specificare l'opzione -K.
-I Isotropic Scaling on/off. (default ON)
È un indicatore che cambia il suo stato da ON a OFF e viceversa
ogni volta che viene specificato.
Riguarda i fattori di scala sugli assi X ed Y da usare. Quando
l'opzione è ON il rapporto di scala tra X ed Y viene mantenuto
costantemente uguale a quello del video, per cui non si hanno
fenomeni di "deformazione" degli oggetti geometrici. Rimane attivo,
ed è soprattutto utile, per i successivi ZOOM del disegno. In seguito
al ricalcolo della finestra per mantenere costante il rapporto X/Y è
possibile che la zona visualizzata non sia esattamente uguale a
quella selezionata.
============================
Funzioni di HPGL Interpreter
============================
All'attivazione il programma HPGL Interpreter inizia il plottaggio
su video dei disegni specificati da linea di comandi.
Durante la fase di plottaggio iniziale sull'ultima riga dello
schermo appare l'indicazione di copyright del programma. In qualunque
istante tuttavia è possibile interrompere l'operazione di plottaggio
e far comparire il menu principale premendo il tasto ESC.
Durante la fase di plottaggio è anche possibile che non ci sia
nessuna attività avvertibile a video; non è una anomalia del
programma, ma semplicemente una indicazione che l'operazione di
plottaggio sta avvenendo in una zona del foglio non visibile a video
(vedi opzioni -B e -T).
Terminata la fase di plottaggio iniziale sull'ultima riga dello
schermo appare il menu principale ed, al centro dello schermo, il
cursore di selezione che può essere controllato dal mouse (se
presente) o dalla tastiera. Per effettuare la selezione di un
rettangolo procedere come segue:
Con il mouse:
1) Muovere il cursore in corrispondenza di uno dei vertici del
rettangolo che si vuole selezionare.
2) Premere il bottone sinistro e, mantenendo premuto, muovere il
mouse in corrispondenza del secondo vertice del rettangolo.
3) Rilasciare il bottone sinistro.
4) Per rieffettuare la selezione premere il bottone 2 del mouse.
Con la tastiera:
1) Il movimento del cursore si ottiene con il tastierino
numerico. Ad ogni numero corrisponde una direzione in maniera
analogica rispetto la posizione dei tasti. Con il NUM-LOCK
inserito il movimento è rapido, senza è possibile effettuare
una regolazione fine. Portato il cursore sul primo vertice del
rettangolo premere il tasto '+' oppure il tasto ENTER.
2) Muovere il cursore sul secondo vertice per completare la
selezione.
3) Per rieffettuare la selezione premere il tasto '-' oppure il
tasto ESC.
Il menu principale è invece composto delle seguenti voci:
F1:AutoScale
F2:Restart
F3:Zoom
F4:Colors
F5:Limits
F6:Time
F7:Print
F910:Exit
La selezione della voce desiderata avviene con la semplice
pressione del corrispondente tasto funzionale.
Questo, in dettaglio il significato di ognuna delle voci del menu:
Autoscale: Durante la fase di plottaggio iniziale il programma
memorizza i limiti del disegno, ovvero la zona del
foglio in cui è avvenuto il plottaggio. Questa funzione
permette di fare uno ZOOM automatico in modo tale che
l'intero disegno compaia sullo schermo. È possibile, se
attiva l'opzione -I (cfr), che parte dello schermo
rimanga inutilizzato.
Restart : Il programma inizia l'esecuzione come se fosse stato
appena lanciato, rileggendo le opzioni che erano state
date da linea di comandi. In questo modo si annulla
qualsiasi operazione di zoom o di modifica dei colori
fatta sul disegno e ci si riporta alla situazione
iniziale.
Zoom : Con questa funzione è possibile ingrandire la parte del
disegno selezionata con il mouse o la tastiera ed
evidenziata da un rettangolo giallo a video. Se non è
stata fatta l'operazione di selezione della zona da
zoomare il programma chiede se si vuole fare un refresh
della finestra corrente. Utile se il plottaggio è
stato interrotto prima della fine e si vuole rieseguire
il plottaggio della zona correntemente a video.
ATTENZIONE: L'operazione di ZOOM può modificare il
rapporto di scala tra gli assi X ed Y per
cui gli elementi geometrici del disegno
potrebbero venir deformati. Per evitare ciò
ci sono due metodi: il primo consiste nel
selezionare un rettangolo che sia
matematicamente simile a quello dello
schermo; il secondo è quello di attivare
alla partenza del programma l'opzione -I
(ZOOM Isometrici) che modifica il rettangolo
selezionato in uno simile allo schermo. Il
secondo fa automaticamente ciò che viene
fatto manualmente nel primo.
Colors : È possibile con questa funzione modificare i colori
delle otto penne e del foglio da disegno. Comparirà un
secondo menu ed un pannello di controllo. Ad ogni tasto
funzionale corrisponde una penna. Per variarne il colore
premere il tasto funzione insieme al tasto SHIFT per
aumentare di uno il codice colore, o con il tasto CTRL
per diminuirlo di uno. Il colore di fondo è associato
al tasto funzione F9. La variazione è immediatamente
riportata a video.
Limits : Con questa funzione posso avere informazioni sulle
dimensioni correnti del disegno e della zona visibile
sullo schermo. In output, sull'ultima riga dello
schermo, ci sono le seguenti informazioni:
screen:(x,y)(X,Y) Paper:(x,y)(X,Y) zz.zzzz%
che hanno il seguente significato: i punti (x,y) e (X,Y)
sono rispettivamente i punti in basso a sinistra ed in
alto a destra che delimitano la zona visibile sullo
schermo (screen) e la dimensione totale del disegno
(Paper). La percentuale che segue è la parte di disegno
visibile rispetto all'intero disegno. Per tornare al
menu principale basta premere un qualunque tasto.
Premendo un tasto funzionale è possibile attivare
direttamente una delle funzioni del menu principale.
Time : Con questa funzione è possibile visualizzare i tempi di
plottaggio del disegno. Compare sull'ultima riga dello
schermo una linea del tipo:
Elapsed Time: xx.x sec. Max Plotting Time: xx.x sec.
Il primo tempo si riferisce all'ultima operazione di
plottaggio effettuata, il secondo è il più lungo fra
tutti i tempi di plottaggio. I due tempi possono
differire in quanto il plottaggio può essere interrotto
prima che venga completato.
Se almeno una volta il plottaggio è stato completato il
Max Plotting Time è il tempo necessario per l'intera
operazione.
Print : Richiama la funzione di stampa dello schermo del
programma. Se è stato selezionato un rettangolo viene
stampato solo questo, altrimenti viene stampato l'intero
schermo. Se è stata specificata l'opzione -D (cfr) non
si avrà una operazione di stampa, ma verrà
semplicemente cancellata la riga del menu: a questo
punto premere il tasto PrtScr ed attendere che
l'operazione di stampa sia completa, indi premere un
qualunque tasto per far ricomparire il menu.
Se non si dovesse ottenere un risultato intellegibile
attivare il programma con una diversa stringa di setup
(cfr opzione di attivazione -O). La stringa di setup
più opportuna la si può trovare sul manuale della
stampante.
Dos : È possibile lanciare con questo tasto funzionale un
qualunque comando DOS. Se specificato verrà messo in
esecuzione il comando specificato con l'opzione -H (cfr),
altrimenti verrà eseguita una shell DOS: si potranno
immettere tutti i comandi validi per il DOS e ritornare
all'HPGL Interpreter con il comando EXIT.
Exit : Con questa funzione si esce dal programma e si ritorna
al DOS. Se durante la fase di plottaggio ci sono stati
degli errori (ad esempio istruzioni non riconosciute)
verranno visualizzati in questa fase. In ogni caso
resteranno memorizzati sul file HPGL.ERR o quello
specificato con l'opzione -Enomefile. L'uscita dal
programma può avvenire sia con il tasto F9 che con il
tasto F10: nel primo caso verrà settato l'ERRORLEVEL=1,
nel secondo caso ERRORLEVEL=0. Si avrà invece
ERRORLEVEL=3 nel caso in cui il programma abbia rilevato
un errore di sintassi sulla linea di comando, ed
ERRORLEVEL=4 nel caso la data di fine utilizzo del
programma sia stata superata (solo versione demo).
==============================
Formato delle istruzioni HPGL
==============================
Per una descrizione dettagliata del funzionamento delle istruzioni
HPGL si rimanda ad un manuale o pubblicazione specifica. Di seguito
è riportata la sintassi utilizzata da questo programma con una
descrizione sommaria della semantica delle istruzioni.
Ogni istruzione HPGL inizia con un codice mnemonico di due lettere,
indifferentemente maiuscole o minuscole. Eventualmente delle
istruzioni possono richiedere dei parametri, questi vengono separati
da almeno una virgola od uno spazio.
Le istruzioni HPGL sono sempre terminate da un punto e virgola
oppure da un carattere di fine riga (LF). Solo il terminatore ed i
separatori tra i parametri sono obbligatori. Altri separatori possono
essere aggiunti secondo il seguente schema sintattico che definisce
il formato di una singola istruzione HPGL:
[sep]C[sep]C[sep][parametro[sep parametro]sep][term]
ove i valore tra parentesi quadre possono essere omessi e:
CC : mnemonico per un comando HPGL (cfr)
sep : caratteri di separazione (spazio, virgola, CR)
term : carattere fine comando (punto e virgola, LF, chr(0))
parametro: può essere di vari tipi. Istruzione per istruzione il
formato può variare. Confrontare con la sintassi
specifica di ognuna di esse.
Fa eccezione l'istruzione LB che viene terminata da un ETX o da
qualunque altro carattere specificato con l'istruzione DT (cfr).
Fanno anche eccezione le istruzioni PU,PD,PA,PR che possono essere
aggregate in una unica istruzione. Ovvero, ricorsivamente, una
istruzione può comparire come parametro di un'altra.
==============================
Sommario delle istruzioni HPGL
==============================
Le istruzioni marcate a lato con il simbolo "*" vengono
riconosciute, ma non danno luogo a nessun disegno. Sono a tutti gli
effetti equivalenti ad un commento. Per maggiori dettagli
relativamente alla sintassi ed alla semantica far riferimento al
capitolo successivo.
Comando Descrizione breve Esempio di utilizzo
======== ======================== ========================
ESC...LF Stringa di setup. <ESC>[2J:m4:1f1<CR><LF>
**stringa Commento. ** Qualsiasi cosa
AA x y alfa Arc Absolute. AA 25.1 40.4 18
AR x y alfa Arc Relative. AR 1.4 -7.1 80
BLstringETX Buffer Label. BL la stampo dopo<ETX>
CI raggio Circle Instruction. CI 80
CP [sp ln] Char Position. CP 4.2 1.6
CT x Chord Tolerance. CT 1
DI [ x y ] Label Direction Absolute. DI 1.4 2.4
DF Default Instruction. DF
DR [x y] Label Direction Relative. DR 2.0 1.0
DT<char> Data Terminator. DT<chr(xx)>
EA x y Edge Absolute. EA 100 99.99
ER x y Edge Relative. ER 20 -16.4
ES [sp[ln]] Extra Space. ES 1.5 0.84
IN Initialize Instruction. IN
IP[[x y [xy]] Input P1 & P2. IP 0,0 100,100
LBstringETX Label Instruction. LP la stampo adesso<ETX>
LT Line Type. ** NON OPERATIVO **
LO [n] Label Origin. LO 1
MP[n] Memory PUT. MP 4
MG[n] Memory GET. MG 4
NR Not Ready. NR
PA[x,y]... Plot Absolute. PA 80,-100 PR
PB Print Buffer. PB
PD[x,y]... Pen Down. PD 100,40 PU
PR[x,y]... Plot Relative. PR -20 -15.15 PA
PU[x,y]... Pen UP. PU 100,-80 PD
SC[[x,X,y,Y[typ]] Scaling Instruction. SC 0,100,0,100,0
SI [x y] Absolute Character Size. SI 0.0020 0.0040
SL [teta] Character Slant. SL 0.14
SP[n] Select Pen. SP 1
SR [x y] Relative Character Size. SR 0.0018 0.0036
======== ======================== ========================
=================================
Descrizione delle istruzioni HPGL
=================================
Comando Descrizione
======== ========================================================
ESC...LF Stringa di setup.
Spesso e volentieri nei file HPGL generati da CAD si
trovano delle stringhe di setup per il plotter. Queste
stringhe iniziano sempre con il carattere <ESC>(CHR 27)
e terminano con <LF>(CHR 10) fine riga. Le stringhe di
setup sono considerate alla stregua di commenti.
**stringa Commento.
La stringa è assolutamente arbitraria
AA x y alfa Arc Absolute.
x y : coordinate assolute del centro della circonferenza
alfa: angolo in gradi sessagesimali
Traccia un arco di circonferenza di ampiezza alfa a
partire dalla posizione corrente della penna. Se
l'angolo alfa è positivo l'arco viene tracciato in
senso anti-orario, viceversa viene tracciato in senso
orario.
AR x y alfa Arc Relative.
Come AA, ma le coordinate X ed Y sono relative alla
posizione corrente.
BLstringETX Buffer Label.
Questa è una delle pochissime istruzioni non terminate
dai normali terminatori, ma dal carattere specificato
dalla istruzione DT (cfr) che di default è <ETX>(CHR 3);
La stringa passata come parametro viene messa nel
buffer per poter essere successivamente stampata, una o
più volte, con l'istruzione PB (cfr). Nel buffer
verranno memorizzati al massimo 255 caratteri.
CI raggio Circle Instruction.
Traccia una circonferenza di raggio dato con centro
nella posizione corrente. La circonferenza viene
tracciata anche se la penna è alzata. Al termine la
penna viene posizionata al centro della circonferenza.
CP [sp ln] Char Position.
sp: numero di spazi
ln: numero di linee
Sposta la penna di sp caratteri orizzontalmente e ln
verticalmente. Può essere usata, ad esempio, per
indentare delle labels. Dato senza parametri riporta la
penna al punto di arresto.
CT x Chord Tolerance.
Questa istruzione non produce alcun effetto in quanto, a
video, gli archi di circonferenza sono sempre tracciati
con la precisione del singolo pixel.
DI [ x y ] Label Direction Absolute.
Imposta la direzione di tracciamento delle labels. I
parametri numerici x ed y, se forniti, sono
rispettivamente il coseno ed il seno dell'angolo formato
dalla linea di riferimento per il tracciamento delle
labels e l'orizzontale. Se omessi la direzione impostata
è quella orizzontale. L'angolo specificato è
indipendente dai punti P1 e P2 impostati con l'istruzione
IP (cfr).
DF Default Instruction.
Ristabilisce i parametri di default del plotter. Per
maggiori dettagli confrontare con il significato delle
istruzioni equivalenti riportate a lato:
- azzera il buffer delle labels LB
- Imposta la direzione di disegno labels a 0 e
la rende ralativa a P1 e P2 DR1,0
- Imposta il terminatore di labels a <ETX> DT
- Imposta i valori di default per extra-space ES0,0
- Imposta il label-origin a 1 LO1
- Imposta il plottaggio in coordinate assolute PA
- Alza la penna dal foglio PU
- Imposta l'angolo di slant a 0 SL0
- Imposta l'ampiezza della plot cell in modo
relativo SR
- Penna attiva del colore del foglio SP0
DR [x y] Label Direction Relative.
Imposta la direzione di tracciamento delle stringhe
relativamente alla posizione dei punti P1 e P2 (cfr
istruzione IP). X ed Y sono le percentuali, lungo i
rispettivi assi, dei limiti del foglio da considerarsi
come seno e coseno dell'angolo di tracciamento. Se i
valori x ed y non vengono forniti viene l'angolo di
tracciamento viene considerato di zero gradi.
DT<char> Data Terminator.
Imposta il carattere di terminazione delle stringhe per
le istruzioni LB e BL (cfr). Per queste istruzioni
infatti non valgono i normali terminatori, ma quello
definito con questa istruzione. Il default è ETX=chr(3).
Il terminatore NON può essere uno dei seguenti
caratteri: ';' LF(#10) NULL(#0) #5 ESC(#27).
EA x y Edge Absolute.
Disegna un rettangolo che ha come vertici il punto (x,y)
e la posizione corrente della penna. Il punto (x y) viene
dato in coordinate assolute.
ER x y Edge Relative.
Come EA, ma le coordinate x,y sono relative alla
posizione corrente della penna.
ES [sp[ln]] Extra Space.
Definisce la distanza che deve essere posta tra due plot
cell consecutive. Sp ed Ln rappresentano la distanza,
rispettivamente orizzontale e verticale, da lasciare tra
due plot cell espressa in percentuale della dimensione
della plot cell stessa. Il default è zero per entrambi
i parametri.
IN Initialize Instruction.
Equivalente all'istruzione DF (cfr).
IP[[x y [xy]] Input P1 & P2.
Con questa istruzione è possibile delimitare la regione
che conterrà il disegno. Permette di operare dei cambi di
scala da programma. La prima coppia (x,y) viene mappata
sul punto in basso a sinistra dello schermo; la seconda
sul punto in alto a destra dello schermo. Se i punti non
vengono passati viene ristabilito il default (vedi
opzioni di avviamento), se presente solo il primo, il
secondo viene calcolato per 'traslazione' mantenendo
costante la dimensione del rettangolo del disegno. A meno
che non siano state usate le istruzioni DI e SI (cfr),
cambiare i punti P1 e P2 comporta la variazione della
direzione di tracciamento delle stringhe e della
dimensione della plot cell.
LBstringETX Label Instruction.
Consente di disegnare in successione i caratteri della
stringa passata come parametro e terminata con il
carattere di terminazione delle stringhe (cfr DT) a
partire dalla posizione corrente della penna e con tutti
i settaggi correnti. Ogni carattere si intende disegnato
all'interno di una "plot cell" le cui dimensioni sono
variabili. I parametri che governano il disegno della
stringa sono i seguenti:
- direzione (cfr DR DI)
- dimensione della plot cell (cfr SR SI)
- spaziatura X ed Y fra plot cells (cfr ES )
- inclinazione dei caratteri (cfr SL )
- spostamento dalla posizione corrente (cfr LO )
La stringa disegnata viene memorizzata in un buffer e
può essere successivamente ridisegnata con l'istruzione
PB (cfr). Il buffer utilizzato è lo stesso di quello
usato dall'istruzione BL (cfr).
LT Line Type.
Specifica il tipo di linea. L'istruzione viene
interpretata, ma non genera nessun effetto. A video tutte
le linee avranno sempre ampiezza di un singolo pixel.
LO [n] Label Origin.
Specifica la posizione della prima "plot cell" di una
stringa che deve essere disegnata rispetto quella della
penna. Il parametro n può assumere i seguenti valori:
1 (default) Penna nel punto Basso-Sinistra della "plot cell"
2 Penna nel punto medio-Sinistra della "plot cell"
3 Penna nel punto Alto-Sinistra della "plot cell"
MP[n] Memory PUT.
Memorizza nella memoria "n" la posizione corrente della
penna. Tale posizione può essere successivamente
ristabilita con il comando MG. Il parametro "n" è un
numero intero tra zero e nove. Se non specificato verrà
usata la cella zero. ATTENZIONE! Questa istruzione NON è
standard HPGL.
MG[n] Memory GET.
Ristabilisce la posizione della penna a quella registrata
nella memoria "n". Questa memoria viene scritta con
l'istruzione MP (cfr). Ripristinare il contenuto di una
cella di memoria, che precedentemente non era stata
scritta con la MP, sposta la penna in una posizione
impredicibile del foglio. ATTENZIONE! Questa istruzione
NON Š standard HPGL.
NR Not Ready.
Mette OFF LINE il plotter. Il programma include
l'istruzione solo per compatibilità sintattica.
L'istruzione non genera alcun effetto.
PA[x,y]... Plot Absolute.
Questa istruzione fa parte di un gruppo di quattro
istruzioni (PA PR PU PD) che ha una sintassi un po'
particolare. Ognuna di esse infatti accetta una lista di
parametri di lunghezza illimitata; ogni parametro può
essere una coppia di coordinate oppure un'altra
istruzione dell'insieme. Se si tratta di una coppia di
coordinate le penna si muove nel punto specificato.
"PA" specifica che le coordinate che seguono devono
intendersi espresse in coordinate assolute.
PB Print Buffer.
Disegna a partire dalla posizione corrente della penna e
con le impostazioni correnti la stringa memorizzata nel
buffer con l'istruzione BL (cfr) o LB (cfr). Le
impostazioni per il disegno sono le stesse usate
dall'istruzione LB.
PD[x,y]... Pen Down.
Questa istruzione fa parte di un gruppo di quattro
istruzioni (PA PR PU PD) che ha una sintassi un po'
particolare. Ognuna di esse infatti accetta una lista di
parametri di lunghezza illimitata; ogni parametro può
essere una coppia di coordinate oppure un'altra
istruzione dell'insieme. Se si tratta di una coppia di
coordinate le penna si muove nel punto specificato.
"PD" indica che la penna deve essere portata a contatto
con il foglio per cui i successivi movimenti della penna
lasceranno una traccia del colore della penna selezionata
(cfr SP).
PR[x,y]... Plot Relative.
Questa istruzione fa parte di un gruppo di quattro
istruzioni (PA PR PU PD) che ha una sintassi un po'
particolare. Ognuna di esse infatti accetta una lista di
parametri di lunghezza illimitata; ogni parametro può
essere una coppia di coordinate oppure un'altra
istruzione dell'insieme. Se si tratta di una coppia di
coordinate le penna si muove nel punto specificato.
"PR" specifica che le coordinate che seguono devono
intendersi espresse in coordinate relative.
PU[x,y]... Pen UP.
Questa istruzione fa parte di un gruppo di quattro
istruzioni (PA PR PU PD) che ha una sintassi un po'
particolare. Ognuna di esse infatti accetta una lista di
parametri di lunghezza illimitata; ogni parametro può
essere una coppia di coordinate oppure un'altra
istruzione dell'insieme. Se si tratta di una coppia di
coordinate le penna si muove nel punto specificato.
"PU" indica che la penna deve essere sollevata dal foglio
per cui i successivi movimenti della penna non lasceranno
alcuna traccia.
SC[[x,X,y,Y[typ]] Scaling Instruction.
Stabilisce i valori di scala per il disegno. Il parametro
typ stabilisce il significato degli altri quattro
parametri, è opzionale, se assente viene assunto per
difetto uguale a zero. Può assumere i seguenti valori:
0: Scalatura non isotropica. Il fattore di scala può
essere diverso sui due assi (un cerchio può essere
visualizzato come ellisse). Gli altri quattro para-
metri assumono il seguente significato.
x= Xmin= Valore Minimo per l'asse X
X= Xmax= Valore Massimo per l'asse X
y= Ymin= Valore Minimo per l'asse Y
Y= Ymax= Valore Massimo per l'asse Y
In questa forma l'istruzione è equivalente a
IP Xmin,Ymin Xmax,Ymax.
È questo il tipo di default.
1: Scalatura isotropica. Il rettangolo definito dagli
altri quattro parametri, che assumono lo stesso
significato del caso typ=0, viene aggiustato in
maniera che rapporto tra i fattori di scala sui due
assi rimanga immutato.
2: La scalatura avviene fornendo direttamente come
parametri i fattori di scala sui due assi. Gli
altri quattro parametri assumono il seguente
significato:
x= Xmin = Valore Minimo per l'asse X
X= Xfactor = Fattore di scala per l'asse X
y= Ymin = Valore minimo per l'asse Y
Y= Yfactor = Fattore di scala per l'asse Y
Se Xfactor=Yfactor si otterrà una scalatura
isotropica.
Nel caso in cui siano assenti anche i primi quattro
parametri viene ristabilita la situazione di default
(vedi opzioni di avviamento). Come nel caso
dell'istruzione IP (cfr) l'istruzione SC modifica la
posizione dei punti P1 e P2, pertanto la dimensione e
la direzione di tracciamento dei caratteri verrà
ricalcolata.
SI [x y] Absolute Character Size.
Specifica la dimensione della "plot cell" in modo
assoluto, ovvero svincolato dalla posizione dei punti P1
e P2. I parametri x ed y rappresentano la dimensione in cm
di ogni "plot cell". Se non specificati viene
ripristinata la dimensione di default (X=7.5 mm; Y=15 mm).
SL [teta] Character Slant.
Specifica con quale inclinazione viene disegnato ogni
carattere di una stringa. La plot cell viene così ad
essere un parallelogramma invece che un rettangolo. Il
parametro teta è la tangente trigonometrica dell'angolo
formato da un lato del parallelogramma con la
perpendicolare all'altro lato. Se teta non viene fornito
verrà utilizzato il valore di default (=0 Angolo tra i
lati di 90 gradi).
SP[n] Select Pen.
Seleziona una delle penne dal carosello. Le
penne sono numerate da 0 a 8, ad ognuna può essere
associato un colore diverso. La penna 0 è comunque
sempre del colore di fondo. Se il parametro n non è
specificato si intende che venga presa la penna 0.
SR [x y] Relative Character Size.
Specifica che la dimensione dei caratteri disegnati con
l'istruzione LB o PB (cfr) è da intendersi relativa alla
posizione dei punti P1 e P2 (cfr IP). I parametri
rappresentano valori percentuali rispetto la dimensione
delle grandezze omologhe del rettangolo che delimita il
disegni, i cui vertici sono appunto P1 e P2. Se non
specificati vengono usati i valori di default (X=0.0075%;
Y=0.0150%).
======== ========================================================
INDICE: Pag.
Generalità sul programma.......................................... 1
Requisiti Hardware e Software...................................... 2
Cenni sui sistemi di coordinate.................................... 2
Procedura di installazione......................................... 3
Sintassi di attivazione............................................ 4
Funzioni di HPGL Interpreter....................................... 8
Formato delle istruzioni HPGL...................................... 12
Sommario delle istruzioni HPGL..................................... 13
Descrizione delle istruzioni HPGL.................................. 14
Indice............................................................. 20
(c) M. Liberi, last updated: 2026-06-28