home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 256.lha / GhostScript_v1.2 / ReadMe.Amiga < prev    next >
Text File  |  1989-06-14  |  7KB  |  181 lines

  1. Amiga Version of GhostScript 1.2
  2.  
  3. Changes to this version were preformed by Stephen Vermeulen, complete
  4. source code for this version is available by writing
  5.  
  6.          Stephen Vermeulen
  7.          Apt. 6 - 2312 - 22 St. N.W.
  8.          Calgary, Alberta,
  9.          Canada, T2M 3W4.
  10.  
  11. And including either a check for $10.00 or a $5.00 check and 2 disks.
  12. Source code may be further redistributed under the terms of the
  13. GNU License.
  14.  
  15. Memory Requirements:
  16.  
  17. This version of GhostScript requires around 1Meg to run, and may need
  18. even more depending on the complexity of the page and the printer
  19. resolution being used.  If you are using a 24 pin printer you may need
  20. as much as 1.3Megs more to run it in the higher density modes.  It
  21. is recommended that you first try using GhostScript in the screen
  22. preview (-s) mode (this needs the least memory) and then try using
  23. it with Preferences set to the LOWEST density setting (1) in the
  24. Graphics 2 screen of preferences.
  25.  
  26. you might also need to use a 10,000 byte stack.  This is what I
  27. normally use so I don't know if you can get away with less.
  28.  
  29. Use:
  30.  
  31. To use the files in this zoo file, put all the files in the same
  32. directory and then assign T: to a directory where GhostScript
  33. can write a small temporary file.
  34.  
  35. On the Amiga you run GhostScript with a command simliar to
  36.  
  37.      GS
  38.  
  39. which will just print the source code source message, or
  40.  
  41.      GS -s
  42.  
  43. which will start GhostScript and send output to a custom screen
  44. and will await PostScript commands from the user. Or,
  45.  
  46.      GS input.ps -s
  47.  
  48. ****
  49. ****  Note: it is normal to get a cannot find GS.MAP error, ignore it.
  50. ****
  51.  
  52. Where "input.ps" is the name of a file containing a PostScript
  53. language document to be printed or displayed.  You may have a number
  54. of files on the command line separated by spaces.  The "-s" switch
  55. on the end of the line specifies the output device and is mandetory.
  56. The following output devices are supported:
  57.  
  58.     -s   A custom screen that is interlaced and sized to the max
  59.          display dimensions.  To see the actual dimensions employed
  60.          take a look at the t:ghost_init.ps file that is created
  61.          after the program has run.
  62.  
  63.          Since this is a preview mode the quality will be VERY poor.
  64.          Also the output will pause at the end of each page until
  65.          you click the mouse somewhere in the preview screen.
  66.  
  67.          This mode is most useful when learning how to program
  68.          in PostScript since it gives you nearly immediate, paperless,
  69.          feedback.  Remember to issue the "stroke" command to get
  70.          your work actually painted on the display...
  71.  
  72.     -p   Use the Amiga's printer device for printing the result.
  73.          GhostScript will read the current preferences graphics settings
  74.          and determine the correct bitmap size to use.  GhostScript
  75.          will then render to that bitmap and every time a "showpage"
  76.          command is found will dump the bitmap to the printer. You can
  77.          control the page size by changing the "Density"
  78.          (1/2/3/4/5/6/7) settings and the "Limits"
  79.          (Ignore/Bounded/Absolute/Pixels) settings in the "Graphics 2"
  80.          screen of Preferences.
  81.  
  82.          Avoid settings where the pixel aspect ratio is extreme
  83.          (probably over 2), as is the case with EpsonX and Density 3,
  84.          these will cause GhostScript to toss its cookies... (luckily
  85.          it does not seem to GURU in these cases)
  86.  
  87. The following switches apply to anyone who has a LazerXpress printer
  88. from CLtd, or who has a copy of Express Paint 3.0.  For these to
  89. work you need to have the VirtualPage.Library installed in your LIBS:
  90. drawer.  In this case there is an extended syntax, for example:
  91.  
  92.   GS file.ps [-xNNNN] [-yMMMM] -vn
  93.  
  94. The -x and -y switches are optional, they must each be immediately
  95. followed by a number, and if present they must PRECEED the mode
  96. selection switch (-vn, -vp, -wn, or -wp) and follow any file names
  97. or regular GhostScript switches.  Only one mode selection switch
  98. is allowed, and it must be the LAST item on the command line.  If
  99. a mode selection switch does not appear an error message will result.
  100.  
  101.    -xNNNN  specifies the width of the virtual page in pixels.
  102.            If it is not present then a default of 2448 will
  103.            be used (ie. -x2448).  This number should be a
  104.            multiple of 16 (hardware reasons) and GhostScript
  105.            will make it so by masking off the lower 4 bits
  106.            (this rounds down the number).
  107.  
  108.    -yMMMM  specifies the height of the virtual page in pixels
  109.            If it is not present the default value of 3204 will
  110.            be used.
  111.  
  112. The following mode selection switches are used for virtual page printing
  113. control:
  114.  
  115.    -vn  Render the output to a virtual page, but do NOT print it
  116.         or erase the page when a "showpage" command is issued.
  117.         This is useful for using GhostScript as a front end to
  118.         Express Paint (or another virtual page supporting program).
  119.         In this mode you can fire up GhostScript, print a page
  120.         and then edit that page further in Express Paint 3.0 by
  121.         starting Express Paint after GhostScript has started and
  122.         selecting GhostScript's virtual page from Express Paint's
  123.         startup window.  To print the virtual page you can use
  124.         Express Paint's printer tool, and you can save the result
  125.         as an IFF picture file if you wish.
  126.  
  127.    -vp  This renders the output and prints it using the virtual
  128.         page library's printer support function.  When a "showpage"
  129.         command is reached this mode will print the page (this will
  130.         take about 10 seconds for a LazerXpress system) and it
  131.         will then erase the page and start rendering the next page.
  132.         Note: the current LazerXpress will probably print a white on
  133.         BLACK (negative) image with this switch.
  134.  
  135.    -wn  Render the output to a virtual page and then invert it
  136.         (flip all the bits) but do not print it.  This is the companion
  137.         to -vn, except it will flip the bits resulting in a negative
  138.         of what -vn produces, depending on your normal editing
  139.         colours this negative may actually be a positive...
  140.  
  141.    -wp  Render the output, invert it (make a negative) and then
  142.         print it using the virtual page library's printer function.
  143.         This is the companion to -vp but on a LazerXpress system is
  144.         the correct mode to use since it will produce black on white
  145.         pages.
  146.  
  147. Examples:
  148.  
  149. This zoo distribution contains two example files, both of which were
  150. derived from my thesis:
  151.  
  152.     mesh2.ps   is a single page PostScript file containing text
  153.                and graphics.
  154.  
  155.     mesh.ps    is a six page PostScript file containing text and
  156.                graphics, mesh2.ps is the second page of this file
  157.  
  158. both files were created with AmigaTeX on the Amiga and the graphics
  159. were imported from FrameMaker on the SUN.  As such they give
  160. GhostScript a pretty good workout and show some of its flaws.
  161.  
  162. Exiting:
  163.  
  164. When GhostScript is done you will be looking at a "GS>" prompt,
  165. at this point you can issue PostScript commands or can return to
  166. the CLI by typing
  167.  
  168.        quit
  169.  
  170. You might also try typing the following at the prompt:
  171.  
  172.         100 100 moveto
  173.         600 600 lineto
  174.         stroke
  175.         showpage
  176.  
  177. and see what happens...
  178.  
  179. Have fun... Stephen Vermeulen May 1989.
  180.  
  181.