--------------------- EpsLab - Guida utente --------------------- ____________________________________________________________________________ EpsLab versione 1.02 23-Ott-1994 Copyright © 1994 By Alessandro Sala Richiede AmigaOS v2.04 ( Kickstart v37 ) or successivo ____________________________________________________________________________ Contents ·  Informazioni legali       ·  Ringraziamenti                 ·  L'archivio di distribuzione   ·  Cos'è EpsLab ?               ·  Installazione               ·  Localizzazione                   ·  Uso                          ·  Contattare l'autore          ·  Elenco delle revisioni       _____________________________________________________________________________ ------------------- Informazioni legali ------------------- ---------------- Responsabilità ---------------- Questo programma è fornito SENZA alcuna garanzia, né esplicita né implicita, di adeguatezza ad un particolare utilizzo. Sebbene sia stata posta la massima cura nel rendere questo programma 'system-friendly' e privo di bug, l' intero rischio per quello che riguarda i risultati, l' affidabilità e le prestazioni di questo programma è assunto dall' utente: NESSUNA responsabilità potrà essere imputata all' Autore per qualsivoglia danno prodotto dal programma stesso. ------------------- Nota di Copyright ------------------- Questo programma è 'FreeWare': può essere liberamente copiato e distribuito per fini non commerciali e comunque non di lucro, purché non venga aggiunto né eliminato alcun file dall' archivio di distribuzione, e non venga richiesto alcun pagamento, a parte un eventuale contributo ai costi di copia. Fred Fish è, naturalmente, esplicitamente autorizzato a distribuire questo programma mediante la sua 'disk library' e/o i suoi CD-ROM. Acnhe gli amministratori di Aminet sono esplicitamente autorizzati a distribuire questo programma mediante gli 'Aminet CD-ROM'. Tuttavia il programma rimane Copyright dell' Autore: sono vietate operazioni di 'reverse engineering', adattamenti e qualunque altra modifica al programma, alla documentazione e ad ogni altro file presente nell' archivio, tranne dove ciò sia esplicitamente premesso. E' permesso comprimere il programma in una forma eseguibile per uso personale, non per la distribuzione. Le uniche due forme permesse di distribu- zione sono l'archivio lha originale o una sua forma decompressa. Inoltre è vietato incorporare il programma in un altro software senza il permesso scritto dell' Autore. -------------- Ringraziamenti -------------- Un grosso ringraziamento va a Manuel Lemos: quasi tutte le nuove caratteristiche di EpsLab derivano dai suoi suggerimenti dopo che avevo rilasciato BinEps. In particolare, Manuel mi ha suggerito l'utilizzo della 'post.library' per creare le immagini di preview; mi ha suggerito dove trovare la documentazione sul formato TIFF, e mi ha suggerito l'aggiunta del supporto per i formati EPSI. Inoltre ha fatto un gran lavoro di beta-testing, e mi ha aiutato a rendere l'interfaccia più aderente all regole di stile fissate dalla Commmodore (o adesso dovrei dire dalla Amiga International ?) Grazie Manuel! ----- E adesso i riconoscimenti legali: PostScript® è un marchio registrato della Adobe Systems Incorporated. TIFF (tm) è un marchio della Aldus Corporation. Post e la post.library sono Copyright di Adrian Aylward. --------------------------- L'archivio di distribuzione --------------------------- ---------------------------------------- Contenuto dell'archivio di distribuzione ---------------------------------------- EpsLab : L'eseguibile principale (solo da CLI) Italiano Leggimi : Informazioni generali (lingua italiana) Installa : Programma di installazione (lingua italiana) Documentazione EpsLab.doc : Documentazione italiana in formato ASCII EpsLab.guide : Documentazione italiana in formato AmigaGuide English ReadMe : Informazioni generali (lingua inglese) Install : Programma di installazione (lingua inglese) Documentation EpsLab.doc : Documentazione inglese in formato ASCII EpsLab.guide : Documentazione inglese in formato AmigaGuide Catalogs EpsLab.ct : File di traduzione vuoto. Italiano EpsLab.catalog : Catalogo per la lingua italiana Libs post.library : Libreria PostScript (di Adrian Aylward). PS init.ps : Preambolo PostScript (sempre di Adrian Aylward). FunkyFont : Font PostScript di default (della Radical Eye Software) afms FunkyFont.afm : Metrica per il font PostScript di default Vari file '.info' ------------ Cos'è EpsLab ------------ EpsLab è il successore di BinEps: il suo scopo principale è quello di aggiungere un'immagine di preview ai file Encapsulated PostScript ('.epsf'); può anche convertire alcuni file PostScript di una sola pagina in file EPS (con un'immagine di preview). L'immagine di preview può essere creata da EpsLab in tre formati: - immagine TIFF (formato EPS binario MS-DOS) - immagine TIFF compressa (sempre formato EPS binario MS-DOS) - immagine ASCII (formato EPSI) In alternativa, l'utente può fornire un file contenente l'immagine di preview in formato TIFF o Windows MetaFile. La sua risoluzione non è importante: può essere di qualsiasi dimensione e proporzioni; l'applicazione che mostrerà la preview dovrà scalare l'immagine alle dimensioni indicate nel commento %%BoundingBox presente nel file EPS. ------------- Installazione ------------- È sufficiente eseguite lo script di installazione, presente nel cassetto 'Italiano'. È necessario il programma 'installer' della Commodore: guarda il file Leggimi per sapere come ottenere 'installer' se non ne sei già in possesso. Se vuoi installare EpsLab a mano: - crea un cassetto dove mettere EpsLab - copia EpsLab, il cassetto 'catalogs' e il file PS/init.ps in quel cassetto Se vuoi che EpsLab crei delle immagini di preview complete e non hai la 'post.library' già installata: - copia Libs/post.library in LIBS: - scegli un cassetto in cui mettere i font PostScript, e aggiungi la seguente linea alla tua user-startup: assign PSFONTS: '' - copia PS/FunkyFont in PSFONTS: - crea un cassetto col nome 'afms' dentro PSFONTS: - copia PS/afms/FunkyFont.afm in PSFONTS:afms - riavvia il computer ! NOTA IMPORTANTE ! Nota che per mantenere la piccola dimensione dell'archivio, ho incluso solo un font liberamente distribuibile (FunkyFont della Radical Eye Software). È piuttosto semplice, ma funziona. Se vuoi altri font PostScript, procurati 'Post', un interprete PostScript liberamente distribuibile di Adrian Aylward, basato sulla post.library (sempre di Adrian Aylward). Se hai il coprocessore matematico (FPU), con 'Post' troverai una versione ottimizzata della post.library che è quasi due volte più veloce. -------------- Localizzazione -------------- EpsLab è pienamente localizzato, se hai AmigaOS v2.1 o successivo. Al momento le uniche lingue supportate sono l'italiano e l'inglese. Se vuoi localizzare EpsLab per la tua lingua, puoi trovare un file di traduzione vuoto nel cassetto 'Catalogs'. Completalo e mandamelo, così che io possa creare il catalogo e distribuire la tua traduzione. Se vuoi tradurre anche la documentazione, lavora solo sulla versione Amigaguide. Io estrarrò la versione ASCII pura. --- Uso --- EpsLab può essere eseguito sia da CLI sia da Workbench. Lo schema dei parametri da CLI è: EpsLab SOURCE,DEST,TIFF/K,WMF/K,POST/S,OUTFMT/N/K, INIT/K,XDPI/N/K,YDPI/N/K,GUI/S,RECBB/S, PSIZE/N/K,CUSTW/K,CUSTH/K,UNIT/N/K Tutti gli argomenti da CLI possono essere usati come tooltype quando EpsLab viene eseguito da Workbench: in questo case essi stabiliscono i valori di default. Ecco il significato dei vari argomenti/tooltype (inserendo 'EpsLab ?' al prompt della CLI si ottiene un piccolo aiuto in linea): SOURCE Il nome del file PostScript o EPS da elaborare. È obbligatorio quando si esegue EpsLab da CLI. DEST Il nome del file EPS risultante. In sua mancanza, il nome verrà creato da nome del file sorgente: - se il file risultante è in formato binario (preview TIFF o WMF) verrà aggiunto un 'b_' all'inizio del nome del file sorgente. - se il file risultante è in formato EPSI, l'estensione del file sorgente verrà cambiata in '.epsi'. I prossimi tre argomenti sono mutuamente esclusivi; se non ne fornite nessuno, l'immagine di preview sarà un crossbox: TIFF= Il nome del file TIFF da usare come immagine di preview. WMF= Il nome del file WMF da usare come immagine di preview. POST Usa la post.library per creare l'immagine di preview. Gli argomenti restanti sono: OUTFMT= Questo stabilisce il formato di uscita quando si usa l'opzione POST: I valori possibili sono: 0 = EPSF binario con preview TIFF 1 = EPSF binario con preview TIFF compressa 2 = Formato EPSI (preview ASCII) Il default è 0 (EPSF binario con preview TIFF non compressa). INIT= Quando si usa l'opzione POST, questo è il nome del preambolo PostScript da leggere prima di interpretare il file sorgente. Il default è 'init.ps'. XDPI= YDPI= Quando si usa l'opzione POST, questi stabiliscono la densità orizzontale e verticale dell'immagine di preview in punti per pollice. Il default per XDPI è 80. Il default per YDPI è XDPI. GUI Forza EpsLab ad aprire l'interfaccia grafica anche se è stato eseguito da CLI. RECBB Forza EpsLab a (ri)calcolare i limiti dell'immagine. Questo è utile quando si converte un file PostScript monopagina in un EPS. Usa l'opzione RECBB se il file convertito, quando viene importato in un documento, mostra un bordo vuoto intorno all'immagine. PSIZE= Quando si converte un PostScript in EPS, questa è la dimensione della pagina se non viene indicata all'interno del file PostScript. I valori possibili sono: 0 = DIN A5 1 = DIN A4 2 = DIN A3 3 = Legale US 4 = Lettera US 5 = Personalizzata (vedi CUSTW e CUSTH). Il default è 1 (DIN A4). CUSTW= CUSTH= Quando PSIZE=5, questi indicano la larghezza e l'altezza della pagina da usare per visualizzare il documento PostScript. Vedi UNIT per sapere come esprimere le dimensioni della pagina. UNIT= Questa è l'unità di misura usata per specificare le dimensioni della pagina. I valori possibili sono: 0 = Centimetri 1 = Pollici 2 = Punti (1/72") Il default è 0 (centimetri). Quando EpsLab viene eseguito da Workbench, o da CLI con l'argomento GUI, aprirà la sua interfaccia grafica. I gadget e i menu sono auto-esplicativi. La voce 'Impostazioni/Salva impostazioni' aggiorna i tooltype per riflettere le impostazioni correnti. ------------------- Contattare l'autore ------------------- Critiche e suggerimenti Spero che troviate EpsLab utile, e se avete delle critiche, dei suggerimenti, segnalazioni di bug, idee per miglioramenti in eventuali nuove versioni, oppure se avete problemi con EpsLab e avete bisogno di aiuto, potete scrivermi ( in Italiano o in Inglese ) al seguente indirizzo: Alessandro Sala Via A. Grandi, 16 20014 Nerviano (MI) Italy Se potete usare la posta elettronica (E-Mail), potete anche contattarmi ai seguenti indirizzi Internet (fino alla fine di Ottobre 1994): tser1500@cdc8g5.cdc.polimi.it Se questo non funziona, potete provare: sala@aix1.cdc.polimi.it       Come ultima possibiltà, tentate di trovare una nuova versione di EpsLab o di qualche altro mio programma, per vedere se sono disponibili nuovi indirizzi. ---------------------- Elenco delle revisioni ---------------------- ------------- Versione 1.02 ------------- Prima versione. Poichè EpsLab è il successore di BinEps, quì sono elencate le differenze da BinEps. - Interfaccia grafica adattabile al font in uso. - Piena localizzazione. - Possibilità di creare un crossbox di preview. - Possibilità di creare una preview completa usando la 'post.library'. - Possibilità di creare una preview TIFF compressa o no. - Possibilità di creare una preview ASCII (formato EPSI). - Conversione automatica di alcuni documenti PostScript monopagina in EPSF, con ricalcolo dei limiti dell'immagine. - Densità selezionabile per l'immagine di preview. - Dimensioni della pagina selezionabili per la conversione da PostScript a EPSF.