home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 4 / AUCD4.iso / acorn / riscos / releases / ro2extra / !PrinterPS / ReadMe < prev    next >
Text File  |  1989-09-22  |  8KB  |  159 lines
  1. This is PrinterPS, version 1.12 (11-Jul-89)
  2.  
  3. Documentation on how to use PrinterPS and its associated printer driver
  4. module can be found in Edition 2 of the Archimedes User Guide and in the
  5. RISC OS User Guide.
  6.  
  7.  
  8. PrinterPS
  9. =========
  10.  
  11. The following remarks should be noted about this version of PrinterPS and
  12. its documentation.
  13.  
  14. When a file is dropped on the printer driver application, a message is
  15. broadcast to all existing applications, asking them if they are able to
  16. print it. If no application responds to this, the printer driver then looks
  17. for a system variable of the form Alias$@PrintType_xxx, where xxx is the
  18. hexadecimal type of the file concerned. If it is found, it is used to load
  19. and run an application or other program which will do the printing.
  20.  
  21. If the variable is not found, files of type PoScript (&FF5) are sent
  22. directly to the printer. Simple text printing is applied to files of types
  23. Text (&FFF), Command (&FFE) and Obey (&FEB). For all other file types, the
  24. printer driver checks with the user whether to print the file; if the reply
  25. is yes, simple text printing is used.
  26.  
  27. If an application is found to print the file, either via the broadcast
  28. message or via the Alias$@PrintType variable, the printer driver checks for
  29. the existence of a file <Printer$Temp> afterwards. If it is found, it is
  30. sent directly to the printer if it is of type PoScript and printed as simple
  31. text otherwise.
  32.  
  33. This usually results in the following behaviour:
  34.    (1) PoScript files are sent directly to the printer.
  35.    (2) Text, Command and Exec files are printed as simple text.
  36.    (3) Most graphics applications' files will be printed by the application
  37.        concerned, provided the application's !Boot file has been executed.
  38.    (4) All other files are printed as simple text, provided the user
  39.        confirms this.
  40.  
  41. You can override this treatment of a particular type file by setting the
  42. system variables of the form Alias$@PrintType_xxx, provided no currently
  43. loaded application thinks it can print the file. If the variable exists,
  44. then the printer driver performs *@PrintType_xxx <filename> before doing
  45. anything else. This command can either output directly to the printer or put
  46. its output in the file <Printer$Temp>. If it does the latter, the printer
  47. driver will then transmit this file to the printer.
  48.  
  49. For instance, if you have a print utility program "PrintUtil" whose output
  50. you prefer to the printer driver's for Text files, set Alias$@PrintType_FFF
  51. to the macro *PrintUtil <%0> -to <Printer$Temp>. If the result of the
  52. PrintUtil program is PostScript then you should set the type of
  53. <Printer$Temp> to PoScript in the macro or in PrintUtil; if it is straight
  54. text, you should set the type of <Printer$Temp> to Text.
  55.  
  56. Clicking SELECT on the PrinterPS icon produces a window with data about the
  57. current printer driver settings. Clicking on the name field steps through
  58. the printers enumerated in the file PrData. Manual feed can also be
  59. selected, and options set that apply to simple text printing.
  60.  
  61. The PrData file supplied with the printer driver provides settings for an
  62. Apple LaserWriter and for a generic colour PostScript printer. The former is
  63. totally accurate for an Apple LaserWriter, but can also be used as a generic
  64. monochrome PostScript printer. The PrData file can be edited to add to the
  65. set of printers if desired.
  66.  
  67. Clicking MENU on the PrinterPS icon allows you to (a) see the version of the
  68. printer driver you've got; (b) choose between output to a file or to a
  69. serial, parallel or network printer; (c) choose the paper size you wish to
  70. use; (d) save your current choices in this menu and in the window brought up
  71. by clicking SELECT, so that they will be used by default when the
  72. application is started up again.
  73.  
  74. If the output is to the serial line and XON/XOFF protocols are being used
  75. then a small module, SerialRxIgnore, is loaded and used to discard incoming
  76. characters (except XON/XOFF control characters).
  77.  
  78. Simple text printing
  79. --------------------
  80.  
  81. This prints the file using the printer's fixed pitch Courier font, in one or
  82. more columns per page. It handles various characters as follows:
  83.  
  84. Printable characters (ASCII 32-126 and 128-255): the appropriate character
  85. from Acorn's standard character encoding is printed. If the character isn't
  86. defined (this is currently true for character codes 128-142) or if your
  87. PostScript printer's Courier font doesn't contain the required character, an
  88. ellipsis character (a triple dot) is printed in its place.
  89.  
  90. Line feed (LF = ASCII 10) and form feed (FF = ASCII 12) characters: these
  91. terminate lines. In addition, FF terminates the current column of output and
  92. starts a new one, starting a new page if there are no more columns on the
  93. current page. An LF/FF combination is treated as though it were a single FF.
  94.  
  95. Other control characters (ASCII 0-9,11,13-31) and the DELETE character
  96. (ASCII 127): these are printed in the form "[<two hex digits>]" - e.g. the
  97. DELETE character is printed "[7F]". To distinguish them from ordinary
  98. characters, they are printed in bold.
  99.  
  100. If a line overflows a column, it is wrapped round onto the next output line.
  101. A bold "|" is printed at the end of each incomplete output line to indicate
  102. that this has happened.
  103.  
  104. Two output formats can be selected from the window brought up by clicking
  105. SELECT on the PrinterPS icon:
  106.    (a) "Portrait": this prints the text in one column, using 10 point type
  107. and with the paper in portrait orientation.
  108.    (b) "Landscape": this prints the text in two columns, using 7 point type
  109. and with the paper in landscape orientation.
  110.  
  111. In addition, you can select whether you want a title printed at the top of
  112. each page of output. This title is printed using 10 point bold text, and
  113. contains the page number, the name of the file and the time of printing.
  114.  
  115. Various additional options can be selected and/or changed by editing the
  116. PrData file.
  117.  
  118.  
  119. The printer driver module
  120. =========================
  121.  
  122. The following remarks should be noted about this version of the printer
  123. driver module and its documentation.
  124.  
  125. For each RISC OS font used, the printer driver needs to be told which
  126. PostScript font to use in its place and the character encoding to be used
  127. for it. Near the end of the file !PrinterPS.PSprolog is a list of the font
  128. translations used. This can be added to or modified by the user as desired -
  129. usually, you should add a suitable translation for each new font you
  130. acquire. It is a good idea to ensure that the PostScript font you use has
  131. similar metrics to the RISC OS font: the PostScript code used for text
  132. printing will compensate automatically for differences between the metrics
  133. of the two fonts, but the results are likely to be ugly if these differences
  134. are too large.
  135.  
  136. The file !PrinterPS.PSprolog also contains two PostScript encoding vectors
  137. (which say what actual character corresponds to each character code). One
  138. has been chosen to conform with the ISO 8859-1 Latin 1 alphabet as far as
  139. possible, though there are some ambiguities (e.g. character code &2D is
  140. defined in the ISO standard to be hyphen or minus, which are usually two
  141. different characters in PostScript fonts). The other is a special character
  142. encoding for the Selwyn font. Both encoding vectors can be edited if
  143. necessary - but make sure you know what you are doing.
  144.  
  145. Not all PostScript fonts contain all the characters in the encoding vectors.
  146. The PostScript code in !PrinterPS.PSprolog is set up to ignore any character
  147. that you try to print if it doesn't appear in the PostScript font being
  148. used. If you would prefer a PostScript error to be generated instead, there
  149. is a commented single line change you can make to !PrinterPS.PSprolog to
  150. achieve this effect.
  151.  
  152. Printing RISC OS sprites to PostScript is a rather complicated business and
  153. always generates quite a lot of PostScript output. It may also take quite a
  154. long time to print. Under some circumstances (particularly if there are a
  155. lot of colours in the sprite and/or if the sprite is to occupy a large
  156. amount of space on the printed page), the time taken by the printer and/or
  157. the application to print the sprite may become quite large (of the order of
  158. several minutes or even more). Do not worry unduly about this.
  159.