home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_2.iso / files / 666b.lha / PSDownload / PSDownload.doc < prev    next >
Text File  |  1992-08-17  |  4KB  |  115 lines
  1. PSDownload
  2. ----------
  3.  
  4. A PostScript font download utility, which also has the ability to
  5. disassemble the contents of a Type-1 font.
  6.  
  7. (c) Mike Todd, 1992
  8.  
  9.    compuserve: 70117,634 
  10.           CIX: miketodd 
  11.  
  12. May be freely distributed only on a private or club basis, except where
  13. explicit permission is granted. No charge may be made for this software,
  14. except for normal online charges in the case of online systems, and the cost
  15. of the disk in the case of floppy distribution. This software may not be
  16. included on CDs, (including PD compilations), commercial disks or other
  17. media without explicit permission, which will not normally be withheld.
  18.  
  19. USAGE:
  20.         PSDownload [>device|file] [-d|f] FontFile
  21.              -f  do not make font resident (used for file output)
  22.              -d  disasssemble the font
  23.  
  24.     eg:
  25.         PSDownload >par: FontName.PFB      download FontName to PAR printer
  26.         PSDownload >file -d FontName.PFB   disassemble font to file
  27.  
  28.  
  29.  
  30. Font downloading
  31. ----------------
  32.  
  33. PostScript fonts come in two flavours, Type-1 and Type-3 and, in
  34. most cases will be included in a PostScript document for sending to
  35. a printer.  However, there are times when it would be useful to have
  36. the font resident in the printer.
  37.  
  38. To do this, you need to get out of the PostScript interpreter's 
  39. main server, store the font and then get back to normal operations.
  40. In addition, PostScript Type-1 fonts are sometimes subject to a
  41. simple compression technique which converts the middle section of
  42. hex codes into binary (thus reducing the number of bytes by 50%)
  43. and this section must be expanded.
  44.  
  45. PSdownload will do this for you, by simply executing the command:
  46.  
  47.   PSDownload >PAR: medici.pfb
  48.  
  49. the medici.pfb file will be downloaded to the PostScript printer
  50. on the parallel port. The output doesn't have to go to the parallel
  51. port, it can be redirected to a file or to the serial port if required.
  52.  
  53.  
  54. Disassembling
  55. -------------
  56.  
  57. Type-1 fonts have a complicated middle section which consists of
  58. code written in a subset of the PostScript language which has been
  59. pre-compiled. Part of it is then encrypted, and then the whole lot
  60. is encrypted.
  61.  
  62. This makes life very difficult if you're trying to work out why a font
  63. doesn't work under particular circumstances.
  64.  
  65. Therefore, I wrote this font disassembler program to allow me to look
  66. at this code.
  67.  
  68. It produces readable ASCII output, but purely for private study ... the
  69. code cannot be read by a PostScript interpreter, nor is it possible to
  70. recompile the output (but I'm working on it!)
  71.  
  72. Disassembly is invoked by using the -D command line switch:
  73.  
  74.   PSDownload >medici.txt -D medici.pfb
  75.  
  76. Note that PSDownload will disassemble most variety of Type-1 code,
  77. including decompressed code (as produced by itself). However, it will
  78. not handle Type-1 code in anything other than Amiga or PC file formats,
  79. and will not disassemble some fonts which are actually encrypted Type-3
  80. code (since the encryption is often unique to the font).
  81.  
  82.  
  83. Switches
  84. --------
  85.  
  86. There are only two command line switches:
  87.  
  88.   -F will decompress the file but will not include the start and end
  89.      sequences required for the download to `stick' in the printer.
  90.      This can be used to create decompressed Type-1 fonts for other
  91.      applications, or where a different downloading method is required.
  92.  
  93.   -D will create a disassembly of the font (and takes precedence over
  94.      the -F switch)
  95.  
  96.  
  97.  
  98. Disclaimer
  99. ----------
  100.  
  101. This utility was written for my own investigations into PostScript Type-1
  102. font failures.  It has served its purpose admirably.
  103.  
  104. However, it has not been thoroughly tested and is provided on an as-is basis.
  105.  
  106. Having said that, I would be pleased to hear of any problems with the
  107. program.
  108.  
  109.  
  110. Version History
  111. ---------------
  112.  
  113. v1.0    01aug92 First public release
  114.  
  115.