home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / gnu / hp2xx312 / sources / readme < prev    next >
Encoding:
Text File  |  1993-04-18  |  3.3 KB  |  86 lines
  1. (c) 1992, 1993 H. Werntges      HP2XX release 3.1.2                 93/04/17
  2.                                 ===================
  3.  
  4. Files in ./sources:
  5. -----------------------
  6.  
  7. README       This file
  8.  
  9. makefile     A symbolic link to ../makes/generic.mak
  10.  
  11. bresnham.c   Implementation of Bresenham algorithm (for line rasterization)
  12. chardraw.c   Code for drawing ASCII characters
  13. getopt.c     from GNU getopt, slightly modified -- don't re-distribute!
  14. getopt1.c    from GNU getopt -- don't re-distribute, use original!
  15. hp2xx.c      High-level routines for hp2xx
  16. hpgl.c       HP-GL parser etc.
  17. no_prev.c    A dummy previewer
  18. picbuf.c     Code for raster ops (vector-to-internal-bitmap)
  19. to_amiga.c   AMIGA previewer
  20. to_atari.c   ATARI previewer
  21. to_dj_gr.c   DOS full-screen (S)VGA previewer, based on DJ Delorie's gr lib
  22. to_eps.c     Output converter for EPS (Encapsulated PostScript)
  23. to_ilbm.c    AMIGA only: IFF-InterLeave BitMap converter
  24. to_img.c     Output converter for IMF (DR's Image format)
  25. to_mf.c      Output converter for Metafont sources
  26. to_pac.c     Output converter for ATARI PAC format (unsupported)
  27. to_pbm.c     Output converter for PBM (Portable BitMap) format
  28. to_pcl.c     Output converter for HP PLC Level 3 (and some Deskjet extras)
  29. to_pcx.c     Output converter for Paintbrush PCX format
  30. to_pic.c     Output converter for ATARI PIC format (unsupported)
  31. to_pm.c      OS/2 PM previewer (unsupported -- stderr output is lost yet)
  32. to_sunvw.c   SunView previewer (unsupported -- outdated)
  33. to_uis.c     VAX-VMS UIS previewer
  34. to_vga.c     DOS full-screen VGA previewer
  35. to_x11.c     X11 previewer
  36.  
  37. bresnham.h   Contains a basic struct -- needed by almost all C sources
  38. chardraw.h   Header for character drawing.
  39. charset0.h   Definition of built-in font / character set 0
  40. getopt.h     from GNU getopt -- don't re-distribute, use original!
  41. hp2xx.h      Central to almost all C sources
  42. iff.h        AMIGA only: for IFF-InterLeave BitMap converter
  43. ilbm.h       AMIGA only: for IFF-InterLeave BitMap converter
  44. x11.h        Some X11 extras
  45.  
  46.  
  47. NOTE about unsupported formats:
  48. ------------------------------
  49.  
  50.   o  to_dj_gr.c  works fine on 386 and 486 CPUs, but I'd rather replace it
  51.                  by code both applicable to DOS and OS/2, and that will be
  52.                  emx.
  53.  
  54.   o  to_pm.c     is my first OS/2 PM project. It seems to work nicely, with
  55.                  the exception that I don't know how to re-direct hp2xx's
  56.                  diag output (to stderr or log file) into a second window
  57.                  WITHOUT significant changes in the sources.
  58.  
  59.                  If you know a simple way -- please tell me
  60.                  (I'm aware of pmprtf -- this come close but won't do it).
  61.  
  62.   o  to_pic.c    The PIC format was mainly used by ATARI programs like
  63.                  Signum. I consider it outdated. Try to work with IMG.
  64.  
  65.   o  to_pac.c    Similar to PIC (compressed version of PIC), used e. g.
  66.                  by STaD.
  67.  
  68.  
  69.  
  70. For installation, get a suitable makefile from ../makes and follow
  71. intructions in ../makes/README.
  72.  
  73. For details of operation, see ../doc/hp2xxinf.tex (hp2xx.texinfo).
  74.  
  75. Optionally test hp2xx with HP-GL files provided in ../hp-tests.
  76. E. g., run
  77.  
  78.             % hp2xx -h100 -w100 ../hp-tests/ascii.hp
  79.  
  80. (This should result in a graphical display of the available
  81.  character set 0.)
  82.  
  83.  
  84. Enjoy!
  85.  
  86.