Michele Liberi software

Michele Liberi
mail: mliberi@gmail.com
cell: +393485211456
telegram: @MicheleLiberi

liberix Indice analitico

hpgl2, visualizzatore HPGL

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