home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / gnu / gs-2.6.1.4-src.lha / src / amiga / gs-2.6.1.4 / amiga.doc < prev    next >
Text File  |  1994-02-02  |  14KB  |  319 lines
  1. GNU Ghostscript 2.6.1 Amiga port, revised 29 January 1994
  2. =========================================================
  3. This port requires:
  4.  
  5. - An  Amiga  equipped  with  an '020 CPU or any successor CPU model and and
  6.   Kickstart 2.04 or higher.
  7.  
  8. - Approx. 4.7 MBytes of hard disk space available.
  9.  
  10. - A  minimum  of 1 MByte of chip memory, depending on what you will want to
  11.   do  with  the  interpreter.  Printer output requires at least 2 MBytes of
  12.   contiguous memory (any memory, not necessarily chip memory).
  13.  
  14. - ixemul.library and a bunch of Postscript/Ghostscript fonts.
  15.  
  16.  
  17. New features in the revised v2.6.1 release
  18. ------------------------------------------
  19. By  public  request  I have recompiled the program to use the built-in math
  20. library,  so  you  no  longer need an FPU to run the program. I also took a
  21. closer  look  at  the  code  which  tries  to  determine  the  printer page
  22. resolution:  you  will  no  longer  have  trouble  with  printers featuring
  23. built-in  paper  tractors.  I  tried all printer drivers to be found on the
  24. Workbench  disk  to  make  sure the printer support code really works. Good
  25. luck!  Some  small  bugs  were  ironed  out and I also took the time to add
  26. support  for  another  two  display  drivers  (the  Picasso II driver which
  27. requires  the  Picasso  monitor  driver  v2.14  to  work  correctly and the
  28. `custom' driver which requires asl.library v38 to be installed). The entire
  29. program was recompiled using GCC 2.4.5.
  30.  
  31.  
  32. New Amiga features in release v2.6.1
  33. ------------------------------------
  34. The  v2.6.0 port used to implement only monochrome drivers, the v2.6.1 port
  35. supports  colour  output on most devices, exceptions where noted. You don't
  36. need  a  special  brand  of graphics hardware expansion, colour output will
  37. work  on  any  Amiga  model, provided there is enough memory available. All
  38. devices capable of doing colour output will reduce the number of colours to
  39. be displayed if in dire need of memory. As for the display oriented devices
  40. this will go mostly unnoticed as the Ghostscript halftoning algorithms will
  41. compensate  for  any  colour reductions. However, printer output quality is
  42. very likely to suffer from colour reduction. So, watch out!
  43.    As  the display oriented devices start up in colour output mode, black &
  44. white  rendering  may  be slightly slowed. The printer device is configured
  45. according  to  the  Preferences  settings;  `Black  & white' will result in
  46. monochrome  output,  `Grayscale  1'  and  `Grayscale  2'  will also produce
  47. monochrome  output  but will internally use a true colour representation of
  48. the  page,  so  does  `Color'. Please note that `true colour' refers to the
  49. Amiga  12  bit colour model, at this time of writing 24 bit colour printing
  50. is not yet implemented.
  51.    The  default  output  device  (a  super-bitmap  window  to opened on the
  52. default  public  screen,  such  as  Workbench)  will  take advantage of the
  53. Kickstart  3.0  pen  sharing  feature  if  enough  colours  (eight or more)
  54. are available.
  55.  
  56. The v2.6.0 port used to rely on printer drivers to initialize their maximum
  57. page  size  information  upon startup. Several users reported problems with
  58. certain  drivers  which  would  make  this information available only after
  59. having  been  asked  to do so. The v2.6.1 port now follows the programmers'
  60. guidelines  how  to determine the maximum page size closely. The driver may
  61. still  complain  if  configured for `Grayscale 1', `Grayscale 2' or `Color'
  62. output  and  there  is  not  enough  memory  available  for  the page to be
  63. displayed.
  64.  
  65.  
  66. Installation
  67. ------------
  68. Enter  the  command  line interpreter, Create a directory on your hard disk
  69. drive,  label  it "ghostscript". Let's assume that the fully qualified name
  70. of  this  directory  will  be  "Work:ghostscript". Enter this directory and
  71. unpack  the  archive  "gs-2.6.1-amiga.lha".  This will create the directory
  72. "doc" which contains the Ghostscript documentation files, and the directory
  73. "examples" which is to hold some Postscript example files. To add the fonts
  74. from  the  Ghostscript distribution (not included in this release) create a
  75. directory  called  "Fonts" in the directory "Work:ghostscript" and copy all
  76. the  font files into it. You also need the `ixemul.library' included in the
  77. Amiga GCC distribution which should be copied to the `Libs:' directory. Now
  78. edit your `S:User-Startup' file, adding the following lines:
  79.  
  80.    Assign ghostscript: "Work:ghostscript"
  81.    Path ghostscript: add
  82.  
  83. Save the file back to disk and reboot your machine.
  84.  
  85.  
  86. Running the interpreter
  87. -----------------------
  88. Enter  the  command  line  interpreter,  type  "gs"  and  press return. The
  89. interpreter   will  be  loaded  and  will  try  to  initialize  itself.  If
  90. successfully initialized, a window should have been opened on the Workbench
  91. screen. The Shell window now should display the following text:
  92.  
  93.    Initializing... done.
  94.    Ghostscript 2.6.1 (5/28/93)
  95.    Copyright (C) 1990-1993 Aladdin Enterprises, Menlo Park, CA.
  96.      All rights reserved.
  97.    Ghostscript comes with NO WARRANTY: see the file COPYING for details.
  98.    GS>
  99.  
  100. At  the  command  prompt,  enter "(ghostscript:examples/golfer.ps) run" and
  101. press  return.  Click  on  the `Zoom' button in the top right corner of the
  102. window  to  bring it to full screen size, move the scrollers and watch what
  103. will  happen. When rendering is finished, the Shell window will display the
  104. following text:
  105.  
  106.    >>showpage, press <return> to continue<<
  107.  
  108. Press  return  to  erase  the  contents  of the window and to continue. The
  109. interpreter  will  be  in  interactive  mode  again, enter "quit" and press
  110. return to end this session.
  111.  
  112. For  more  information  refer to the documentation in the "ghostscript:doc"
  113. drawer.
  114.  
  115.  
  116. How to print a document
  117. -----------------------
  118. As the corresponding Ghostscript device will always keep the entire page in
  119. memory  the  printer need not be capable of strip-printing. The bad news is
  120. that  the  entire page will consume *a lot* of memory. This Amiga port will
  121. keep  the page in any public memory area, so it will not necessarily eat up
  122. precious chip memory. This should make it possible to print pages on Amigas
  123. with  only  1  MByte of chip memory or less, provided enough fast memory is
  124. available.
  125.  
  126. Enter  the  command  line interpreter, type "gs -sDEVICE=amiga_printer" and
  127. press  return.  This  will  invoke  the  Ghostscript  interpreter  with the
  128. "amiga_printer"  device  driver  selected  as  the startup device. When the
  129. command prompt appears, enter "(ghostscript:examples/butterfly.ps) run" and
  130. press return. The rendered image will be sent to the printer. When printing
  131. is finished, press return and enter "quit" to end this session.
  132.  
  133. Note:  unless you want Ghostscript to prompt you to press return after each
  134. page  is  printed and ejected you should include "-dNOPAUSE" on the command
  135. line.
  136.  
  137.  
  138. Available device drivers
  139. ------------------------
  140. This port implements the following nine device drivers:
  141.  
  142.    amiga
  143.  
  144.       (This is the default output device)
  145.  
  146.       Rendering  takes  place  in a super-bitmap window to be opened on the
  147.       Workbench  screen.  This  window  contains  scroller  handles to move
  148.       around in the bitmap. Usually, the bitmap will be four times as large
  149.       as the screen the window opens upon.
  150.  
  151.    amiga_low
  152.  
  153.       Renders into a low-resolution custom screen.
  154.  
  155.    amiga_high
  156.  
  157.       Renders into a high-resolution custom screen.
  158.  
  159.    amiga_super
  160.  
  161.       Renders into a super-high-resolution custom screen.
  162.  
  163.    amiga_a2024¹
  164.  
  165.       Renders into an A2024 resolution custom screen.
  166.  
  167.    amiga_picassoii
  168.  
  169.       Renders  into  a Picasso  II custom  screen (note: a plain  Intuition
  170.       custom screen  will be opened, this  driver will not directly  access
  171.       the  Picasso II  hardware).  The  Picasso  monitor  driver  v2.14  is
  172.       required for this driver to work.
  173.  
  174.    amiga_custom
  175.  
  176.       Unlike   the  other  display  drivers  which  will  open  screens  in
  177.       predefined  resolutions  and modes the `amiga_custom' driver will let
  178.       you select the display mode to use. On first invocation of the driver
  179.       a  screen mode requester will be opened for you to select the display
  180.       mode  to use. The name