1(c) 1998 - 2000  M. Kroeker     HP2XX release 3.3.2                 00/02/12
2(c) 1992 - 1994  H. Werntges    HP2XX release 3.2.x                 94/02/14
3                                ===================
4
5Files in ./sources:
6-----------------------
7
8README       This file
9
10makefile     This should normally be a copy of (or symbolic link to)
11	     the appropriate Makefile for your platform from ../makes,
12	     or an appropriately edited copy of ../makes/generic.mak
13	     As distributed, it is what i use myself on Linux.
14bresnham.c   Implementation of Bresenham algorithm (for line rasterization)
15murphy.c     Implementation of Alan Murphys (IBM) thick line algorithm
16chardraw.c   Code for drawing ASCII characters
17getopt.c     from GNU getopt, slightly modified -- don't re-distribute!
18getopt1.c    from GNU getopt -- don't re-distribute, use original!
19hp2xx.c      High-level routines for hp2xx
20hpgl.c       HP-GL parser etc.
21no_prev.c    A dummy previewer
22picbuf.c     Code for raster ops (vector-to-internal-bitmap)
23std_main.c   Traditional command line interface including "main()"
24clip.c       Auxiliary routines for clipping (IW command)
25pendef.c     Pen colour / width routines
26to_amiga.c   AMIGA previewer
27to_atari.c   ATARI previewer
28to_dj_gr.c   DOS full-screen (S)VGA previewer, based on DJ Delorie's gr lib
29to_emf.c     Previewer, printout and EMF converter for MS Windows
30to_eps.c     Output converter for EPS (Encapsulated PostScript)
31to_escp2.c   Output converter for Epson ESC/P2 format as used in the Stylus
32to_ilbm.c    AMIGA only: IFF-InterLeave BitMap converter
33to_img.c     Output converter for IMF (DR's Image format)
34to_vec.c     Output converter for several vector formats (Metafont,DXF,SVG...)
35to_os2.c     OS/2 full-screen previewer (only b/w); uses to_vga.c in DOS mode
36to_pac.c     Output converter for ATARI PAC format (unsupported)
37to_pbm.c     Output converter for PBM (Portable BitMap) format
38to_pcl.c     Output converter for HP PCL Level 3 (and some Deskjet extras)
39to_pcx.c     Output converter for Paintbrush PCX format
40to_pdf.c     Output converter for Portable Document format (requires libpdf)
41to_pic.c     Output converter for ATARI PIC format (unsupported)
42to_pm.c      OS/2 PM previewer
43to_rgip.c    Output converter for Uniplex RGIP vector format
44to_sunvw.c   SunView previewer (unsupported -- outdated)
45to_uis.c     VAX-VMS UIS previewer
46to_vga.c     DOS full-screen VGA previewer
47to_x11.c     X11 previewer
48to_png.c     Output converter for PNG format (requires libpng and libz)
49png.c	     Support functions for to_png.c
50to_fig.c     Output converter for FIG (XFig) format
51to_tif.c     Output converter for TIFF format (requires libtiff)
52
53bresnham.h   Contains a basic struct -- needed by almost all C sources
54murphy.h     Function declarations for thick line algorithm
55chardraw.h   Header for character drawing.
56charset0.h   Definition of built-in font 0 , ANSI ASCII
57charset1.h   Definition of built-in font 1 , 9825 character set
58charset2.h   Definition of built-in font 2 , French/German
59charset3.h   Definition of built-in font 3 , Scandinavian
60charset4.h   Definition of built-in font 4 , Spanish/Latin American
61charset5.h   Definition of built-in font 5 , Special Symbols
62charset6.h   Definition of built-in font 6 , JIS ASCII
63charset7.h   Definition of built-in font 7 , HP-Roman Extensions
64font173.h    Definition of built-in PS Math font
65font205.h    Definition of built-in Ventura Math font
66getopt.h     from GNU getopt -- don't re-distribute, use original!
67hp2xx.h      Central to almost all C sources
68pendef.h     Function declarations and typedefs for pen
69iff.h        AMIGA only: for IFF-InterLeave BitMap converter
70ilbm.h       AMIGA only: for IFF-InterLeave BitMap converter
71x11.h        Some X11 extras
72clip.h       Some declarations for clip.c
73
74
75
76NOTE about unsupported formats (HWW - these are even less supported now, MK):
77------------------------------
78
79  o  to_dj_gr.c  works fine on 386 and 486 CPUs, but I'd rather replace it
80                 by code both applicable to DOS and OS/2, and that will be
81                 emx.
82
83  o  to_pic.c    The PIC format was mainly used by ATARI programs like
84                 Signum. I consider it outdated. Try to work with IMG.
85
86  o  to_pac.c    Similar to PIC (compressed version of PIC), used e. g.
87                 by STaD.
88
89
90
91For installation, get a suitable makefile from ../makes and follow
92intructions in ../makes/README.
93
94For details of operation, see ../doc/hp2xxinf.tex (hp2xx.texinfo).
95
96Optionally test hp2xx with HP-GL files provided in ../hp-tests.
97E. g., run
98
99            % hp2xx -h100 -w100 ../hp-tests/ascii.hp
100
101(This should result in a graphical display of the available
102 character set 0.)
103
104
105Enjoy!
106
107