home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / disks / disk408.lzh / Post / README < prev    next >
Text File  |  1990-11-21  |  10KB  |  208 lines
  1. Postscript interpreter - README
  2. ===============================
  3.  
  4. Post V1.3 Copyright Adrian Aylward 1989, 1990
  5.  
  6. This distribution was released as the archive file "post13.lzh", 27-Oct-90
  7.  
  8. Files in this distribution:
  9.  
  10. README            This file
  11. Post.info         Icon file
  12. post              User interface
  13. post.doc          Documentation file
  14. postband          Band printing driver
  15. postband.doc      Documentation file
  16. postlj            LaserJet printing driver
  17. postlj.doc        Documentation file
  18. post.library      Shared library for Amiga 500/1000/2000
  19. post.library.2620 Shared library for Amiga 2500 etc. (68020/030, 68881/2)
  20. init.ps           Standard postscript startup file
  21. icon.ps           The postscript program that built the icon
  22.  
  23. Source files (user interface only), for programmers:
  24.  
  25. post.c            User interface, C main program
  26. postband.c        Band printing driver, C main program
  27. postlj.c          LaserJet printing driver, C main program
  28. postasm.a         User interface, assembler support
  29. postlib.h         Library interface header
  30. postlib.doc       Documentation file
  31. makefile          Make file
  32.  
  33. You will also need:
  34.  
  35. arp.library       Arp library, V39+
  36. conman            ConMan, V1.3+
  37.  
  38. You should find these on "All Good BBS's/disk libraries"
  39.  
  40. I have tested Post under WorkBench V1.3 only.  If you have 2.0 it should
  41. work, but you may need a more recent version of ConMan.
  42.  
  43. You will need at least a megabyte of memory.  Even with a megabyte you
  44. will have not be able to generate a full page in colour on the screen.
  45. For high density printer output (A4 at 300 dpi.) you will need 2 megabytes!  If memory is very tight, try running from the CLI, before workbench has
  46. been loaded.  N.B. the default memory size has increased from earlier
  47. versions, so if you have a small machine you will have to do a little
  48. more shoehorning.
  49.  
  50. Before using Post you will need to copy the library (post.library or
  51. post.library.2620) into your libs: directory.  If you have a 32 bit cpu
  52. (68020/030/040) and a floating point unit (68881/68882 or 68040) you can
  53. use the 2620 version of the library, which is compiled to use hardware
  54. floating point instructions and runs about twice as fast.  Otherwise you
  55. must use the standard library - if you try the 2620 version it will
  56. refuse to open.
  57.  
  58. Examples
  59. ========
  60.  
  61. The examples and demo programs are now being distributed separately.  Look
  62. out for the file "psdemos1.lzh".  (If you have the prerelease "post02.lzh"
  63. or one of the earlier releases there is no need to download them, as they
  64. have not changed significantly).
  65.  
  66. The PostScript Language
  67. =======================
  68.  
  69. If you don't know any PostScript I recomend obtaining a suitable tutorial
  70. book.  Try the "blue book" from Adobe:
  71.  
  72.     "PostScript Language Tutorial and Cookbook"
  73.     Adobe Systems Incorporated,
  74.     Addison-Wesley 1985, ISBN 0-201-10179-3
  75.  
  76. If you want to learn PostScript, Post is a valuable learning tool, as you
  77. run it interactively and view the output one the screen.  Without some basic
  78. knowledge you may find it difficult to understand what is happening if you
  79. have problems getting started.
  80.  
  81. The startup file
  82. ================
  83.  
  84. The standard startup file "init.ps" should be run before most programs.  You
  85. should read it and the comments within it, as you may wish to customise it.
  86. It defines useful operators to mimic a standard PostScript printer.  It also
  87. handles automatic font downloading (see below).
  88.  
  89. Getting started
  90. ===============
  91.  
  92. Make sure that you have ConMan (V1.3+) and the ARP library installed.
  93.  
  94. Copy the file post.library into your libs: directory.  If you have a
  95. 68020 or 68030 cpu and a 68881 or 6882 floating unit you can use the 2620
  96. version of the library instead - copy it to libs:post.library.
  97.  
  98. From the CLI you can just type "post init.ps screen", assuming that all the
  99. files are in the current directory.  You should see a new screen with a big
  100. requestor window appear.  Click on "OK" and wait while Post executes the
  101. startup file, then you are ready to go.
  102.  
  103. If it says that it can't get enough memory (if you have only 1 megabyte)
  104. try selecting "Black and White" on the requestor window, and reducing the
  105. amount of VM from 600000 to 200000-300000.
  106.  
  107. For a quick check of the graphics, pick File/Interactive on the menu.  Then
  108. type into the narrow window at the top:
  109.  
  110.     200 200 150 0 360 arc stroke
  111.  
  112. The result should be a circle appearing in the lower window.  When you
  113. have finished playing, type "quit" or CTRL/backslash.  Then "Project/Quit"
  114. will return you to the CLI.
  115.  
  116. If you don't have any fonts yet all text output will just print as big dots.
  117. (Read the section below on fonts).  Make a "PSFonts:" directory and copy all
  118. your PostScript fonts into it.  (Don't confuse these with Amiga bitmapped
  119. fonts - these will NOT work, nor will .AFM font metric files)  Their names
  120. should be the same as their PostScript names - e.g. "PSFonts:Times-Roman",
  121. "PSFonts:Times-Bold".  The files can either be ASCII text or in IBM
  122. PostScript font format.  If you have copied them from an IBM disk you will
  123. have to change the names; since MSDOS can only handle 8 character names its
  124. stores Times-Roman as "TI______.AFB" and Times-Bold as "TIB_____.AFB".  Then
  125. Post will load the fonts automatically as they are needed.
  126.  
  127. To use the workbench startup click on the icon.  You will probably want to
  128. set up the tooltypes to execute the startup file "init.ps"; for now you can
  129. enter it in the requestor.
  130.  
  131. Fonts
  132. =====
  133.  
  134. As there are no fonts built in to the interpreter, all fonts must be loaded
  135. from the disk, as PostScript source.  The standard startup file redefines
  136. the findfont operator to automatically load fonts from the disk the first
  137. time they are referenced.  To use this, build a directory "PSFonts:" 
  138. containing your PostScript fonts.  The file names should be the same as the
  139. PostScript names, without the '/'.  You can add an extension if you wish,
  140. by editing the startup file.  You can also make it search more than one
  141. directory.
  142.  
  143. The startup file also defines a default font, which will be substituted if
  144. the font your program requests cannot be found.  The initial default font
  145. as set up by the standard startup file is a dummy font that prints big dots,
  146. but at least allows most text operations to proceed without producing errors.
  147. This means that if you don't have the font loading set up properly the only
  148. text output you will get is big dots.  So if that is what you see when you
  149. run Post it probably means that you don't have any fonts, rather than a
  150. problem with Post itself.
  151.  
  152. Since a font is loaded into the vm just like any other PostScript code, it
  153. will be discarded when the vm is restored.  This means that in a multiple
  154. page document the fonts will likely be reloaded on every page.  To save time,
  155. it is usually much better to preload the fonts you are going to need.  You
  156. can do this using the "load font" menu command, or you can write yourself
  157. a little PostScript program to load your favourite fonts.  (Exercise for
  158. the user: write a driver to extract the font names from a conforming
  159. PostScript program and preload them.)  If you are using a large number of
  160. different fonts at once you may need to increase the default vm size to
  161. contain them.
  162.  
  163. There are a number of commercial sources for fonts.  Both the Adobe type 1
  164. (encrypted) fonts and type 3 (standard downloadable) fonts are supported.
  165. Since type 1 fonts can contain special "hints" to improve the quality at
  166. small point sizes on low or medium resolution devices they usually give
  167. much higher quality results.  You can get type 1 fonts from Adobe, or a
  168. number of other vendors.  A good source of the standard set of 35 fonts
  169. as come on most PostScript printers is the Adobe Type Manager (13 fonts)
  170. and its associated Plus Pack (22 fonts).  The Mac version contains the
  171. fonts, which can be converted to standard ASCII format by a utility
  172. program.  The IBM version will presumably contain the fonts too.  Post can
  173. read IBM format fonts directly, without converting the files.
  174.  
  175. If you have any of the additional CompuGraphic outline fonts supplied by
  176. Gold Disk for use with their DTP programs you can generate type 3 fonts
  177. from them using their conversion program.  The quality is not as good as
  178. the original Compugraphic fonts but is acceptable for proofing purposes.
  179.  
  180. There are some freely copyable fonts tht were originally distributed with
  181. the GhostScript project (another freeware PostScript interpreter available
  182. on Unix).  The quality of these is not high, as they appear to have been
  183. generated by tracing bitmap outlines, but they will serve to get you
  184. started, and they are free.
  185.  
  186. There are also various shareware and PD fonts available.  Many of these were
  187. derived from the Mac or IBM.  They may still be in a foreign file format.
  188. The file should be converted to readable ASCII, with no strange control
  189. characters. Some of the fonts have Mac encoding vectors.  You won't notice
  190. the difference for the standard ASCII characters, as they are the
  191. same, but you may have to convert to the standard encoding to get
  192. more unusual characters like the trademark sign to work.  (Programs
  193. like Adobe illustrator do their own font encoding anyway.)  You
  194. will need to know some PostScript to make this change.  If you
  195. see the sequence "/Helvetica findfont /Encoding get" or
  196. "<dictionary> /MacVec get" try replacing it with "StandardEncoding".
  197.  
  198. You are recommended to ensure all your fonts have UniqueID's.  This makes
  199. the font caching code more efficient.  Often all you have to do is uncomment
  200. them in the source.  Any number will do for the ID (up to 2**24 - 1), as long
  201. as it is different for each of your fonts.  Make it a multiple of 4, as Adobe
  202. recommend adding 1 or 2 to the ID when modifying the font.
  203.  
  204. Each font should have a FontName entry.  This isn't actually required by
  205. Adobe, but certain programs such as Adobe Illustrator copy the font directory
  206. when recoding the font.  If the name is missing, you get a dictionary full
  207. error after the name has been added.
  208.