home *** CD-ROM | disk | FTP | other *** search
/ DTP Toolbox / DTPToolbox.iso / utilities / postscript / ghostscript / readme.amiga < prev    next >
Encoding:
Text File  |  1996-01-23  |  5.6 KB  |  120 lines
  1. Short:    Ghostscript3.53 port with Amiga driver & no ixemul.library
  2. Author:   GS(Aladdin)/Amiga(Olaf Barthel)/Port(me)
  3. Uploader: Joop.vandeWege@Medew.ENTO.WAU.NL
  4. Type:     gfx/show
  5.  
  6. This is the Amiga port of Ghostscript3.53. Ghostscript is a Postscript
  7. interpreter with support for Level 2 PS and PDF. This release includes
  8. *only* the Amiga display driver and the fileformat PNG. This is only a
  9. *small* part of the available device drivers and is a trade off between
  10. size and usability. The source is available from the same place you got
  11. the binary (is it?) so you can recompile to fit it to your needs.
  12.  
  13. This port requires:
  14. - An  Amiga  equipped  with  an mc68000 CPU or any successor CPU model and
  15.   Kickstart 2.04 or higher.
  16. - Approx. 4.7 MBytes of hard disk space available.
  17. - A  minimum  of 1 MByte of chip memory, depending on what you will want to
  18.   do  with  the  interpreter.  Printer output requires at least 2 MBytes of
  19.   contiguous memory (any memory, not necessarily chip memory).
  20. - A bunch of Postscript/Ghostscript fonts.
  21.  
  22. Comments/Suggestions/Bugs to:
  23. Joop.vandeWege@medew.ento.wau.nl
  24. Please use a Subject field with the name 'GS353' in it.
  25. Please direct all mail to me except when you're 100% sure it is a GS
  26. problem then you can use the Aladdin email address.
  27.  
  28. Joop van de Wege
  29.  
  30.  
  31. Getting Ghostscript.
  32. Download the binary archive, gs353bin.lha
  33. It contains all needed data in one directory with two versions of 
  34. Ghostscript353 (GS), a mc68000 version and a version which should work
  35. on machines with an mc68020 and higher. It doesn't use the FPU
  36. (68881/2/68040) instructions.
  37. This one should run on plain A1200, A3000, A4000-030, A4000 and any
  38. A500/A600/A1000/A2000 machine with a mc68020/30/40/60 installed and enough
  39. RAM. On my machine (A3000 + Merlin) it uses 150Kb Chip and 1.5Mb Fast.
  40. Expect it to use more if the psfile is big/complex or when displaying PDF
  41. files and when using 256color modes for the Workbench.
  42.  
  43. How to use Ghostscript.
  44. Unpack the archive gs353bin.lha to a suitable HD with enough room (~3.5M).
  45. A directory 'Ghostscript' will be created and all files needed are found
  46. within this directory.
  47. There are two ways to proceed from here.
  48. - Assign Ghostscript: to the directory where you unpacked the archive.
  49.   Example: unpack on 'Work:', creates Work:Ghostscript
  50.   Assign Ghostscript: Work:Ghostscript
  51.   path Ghostscript: add
  52.   (Optionally, remove one of the files gs000 or gs020-40sf and rename the
  53.   remaining to 'gs')
  54.   Now you can call 'gs' from anywhere with or without arguments. If you add
  55.   the above fragment (Assign ... add) to your s:user-startup then it will
  56.   available everytime you start your computer
  57. - Set the following environment variables:
  58.     - GS_LIB,     example: setenv GS_LIB=work:ghostscript/data
  59.     - GS_DEVICE   example: setenv GS_DEVICE=amiga (default)
  60.     - GS_FONTPATH example: setenv GS_FONTPATH=work:ghostscript/fonts
  61.     - GS_OPTIONS  example: setenv GS_OPTIONS="-sDEVICE=png16m -r120"
  62.   The only required variable is GS_LIB. Now you can copy 'GS' to a place
  63.   which is in the AmigaDOS search path.
  64.  
  65. See the 'Ghostscript/docs' directory for more information, like commandline
  66. options. Some notes:
  67. Watch out for case sensitivity when using commandline options, -sOutputFile
  68. is not equal to -soutputfile !!!!!
  69. Some very useful commandlines with comments in ():
  70. gs -h (outputs small help on most important arguments)
  71. gs (gs opens window on WB and use its palette, use 256color WB if possible)
  72. gs -sDEVICE=png16m (uses the built-in PNG support instead of window on WB)
  73. gs -sOutputFile=ram:output%02d.png -sDEVICE=png256
  74.    (output to files numbered ram:output01.png/ram:output02.png/etc using
  75.     the PNG format (8bit))
  76. gs -r120 (use 120dpi as resolution instead of built-in 72, uses heaps of
  77.           memory at high values)
  78. Arguments useful for PDF files (and ps documents conforming to DSC ?)
  79. gs -dFirstPage=pagenumber (starts on the given page of the document)
  80. gs -dLastPage=pagenumber (Stops after the given page of the document)
  81. See use.doc/Switches for a complete overview of what is available.
  82.  
  83. Recompiling GS:
  84. Steps needed to be done to recompile GS from scratch using GCC2.63/2.70:
  85. Get gs353src.lha
  86. Get gs353amiga.lha
  87. Get gs353jpeg6.lha
  88. Get gs353zlib.lha
  89. Get gs353png.lha
  90.  
  91. Unpack gs353src to HD, a directory 'gs3.53' will be created.
  92. Unpack *in* this directory:
  93. - gs353amiga.lha, overwriting some files. This is OK
  94.   gs353amiga.lha contains:
  95.   - gdevamiga.c, the amiga device driver from Olaf Barthel
  96.   - gdevpipe.c, patched for use with Libnix
  97.   - gdevpng.c, bugfixed PNG device driver
  98.   - geninit.c, bugfixed geninit
  99.   - gp_amiga.c, platform dependant stuff for the Amiga
  100.   - gsmisc.c, fixed wrong external declaration
  101.   - makefile, how to recreate GS (this distribution rebuilds in the
  102.     source directory, the upcoming ADE (Fred Fish) one will have a
  103.     configure script)
  104.  
  105. - gs353jpeg6 which creates the 'jpeg-6' directory
  106. - gs353zlib which creates the 'zlib' directory
  107. - gs353png which creates the 'pnglib' directory
  108. The last two archives are not needed when you don't intend to rebuild GS
  109. with PNG support.
  110. Edit the makefile and activate/deactivate the devices you want or adjust
  111. the paths. Read the comments in the makefile for directions.
  112. cd to drive:gs3.53 and type 'make' followed by 'make install'
  113. If you haven't forgotten to set the stack to a reasonable amount (~50K),
  114. you can sit back and have a cup of coffee. On my A3000 it takes about 2.5h
  115. to compile with the current device driver set and the file 'gdevamiga.c'
  116. needs about 7-8Mb when -O2 is on. It needs less if you don't optimize :)
  117. Make itself takes another 2Mb so in case of problems just compile
  118. gdevamiga.c on its own and let make resume after that. GCC2.7.0 (Aminet)
  119. works with VMM3.3 (on Aminet too).
  120.