home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine 1996 / ARCHIVE_96.iso / discs / mag_discs / volume_4 / issue_04 / printers / !PrinterDM / !Help < prev    next >
Text File  |  1990-08-02  |  16KB  |  324 lines
  1. This is PrinterDM, version 2.44 (23-Jul-90)
  2.  
  3. Introduction
  4. ============
  5.  
  6. Documentation on how to use PrinterDM can be found in Edition 2 of the
  7. Archimedes User Guide, but this version has significant enhancements, so
  8. please read the notes below.
  9.  
  10. The way in which a file is printed depends upon its type:
  11.  
  12.     File type:         Printed as:
  13.  ---------------------------------
  14.  Command  (&FFE)     "plain" text - as under original printer drivers
  15.  Obey     (&FEB)     "plain" text - as under original printer drivers
  16.  Text     (&FFF)     "fancy" text - line numbering, titling, highlights etc.
  17.  Printout (&FF4)     all bytes sent straight to the printer
  18.  
  19. For anything else, the application checks if other applications know how to
  20. print the file. If this fails it checks with the user whether to print the
  21. file, giving him the choice of printing it as "plain" text, "fancy" text, or
  22. not at all. This is so that 1st Word Plus files can be printed as "fancy"
  23. text. The "fancy" text file format is mainly the same as the 1st Word Plus
  24. file format, and so most of the highlighting is printed correctly by release
  25. 2 of the printer drivers. This means you don't have to load 1st Word Plus to
  26. print out your 1st Word Plus files (although there are some restrictions,
  27. described below, including headers, footers and graphics). Note that if you
  28. have already 'seen' 1st Word Plus then it will automatically be loaded when
  29. you try to print.
  30.  
  31. You can override the application's treatment of a particular type file by
  32. setting system variables of the form Alias$@PrintType_xxx, where xxx is the
  33. appropriate type. If the variable exists, then the application performs
  34. *@PrintType_xxx <filename> before doing anything else. It then checks for
  35. the existence of <Printer$Temp>. If this exists then it is printed (using
  36. plain, fancy or literal printing, depending upon the type of this file). You
  37. can therefore print via a print utility program by using:
  38.  
  39.     *Set Alias$@PrintType_xxx *PrintUtil %0 -to <Printer$Temp>
  40.  
  41. Try looking at the !Boot files of !Draw and !Paint for some examples of
  42. this.
  43.  
  44. Using the printer drivers
  45. =========================
  46.  
  47. Select
  48. ======
  49.  
  50. Clicking SELECT on the icon produces a window with data about the current
  51. printer driver settings.
  52.  
  53. Printer:
  54. -------
  55. Clicking on the name field steps through the printers and dump modes
  56. enumerated in the file "PrData" (see below).
  57.  
  58. Monochrome graphics:
  59. -------------------
  60. Graphics printing can be speeded up by using the monochrome option; this
  61. does, however, stop sprites and fonts being halftoned, and reduces the range
  62. of halftone options available on other plotted items.
  63.  
  64. Paper feed:
  65. ----------
  66. The "manual feed" option causes a window to pop-up at the end of each page,
  67. of "fancy" text printing, and between files of any type when multiple files
  68. are printed.  This allows the user to manually insert another sheet of paper
  69. into the printer before proceeding.  Clicking on the close box of this
  70. window leaves the printer "paused" - it can be re-started by clicking SELECT
  71. or ADJUST over its icon.
  72.  
  73. Title:
  74. -----
  75. Puts file name, time and page number at top of each "fancy" text page.
  76.  
  77. Number lines:
  78. ------------
  79. Prints the number of each line in "fancy" text files.
  80.  
  81. Print line feeds:
  82. ----------------
  83. When printing either "fancy" or "plain" text, a carriage-return character is
  84. sent to the printer at the end of each line.  If this button is "on", then a
  85. line-feed character is sent as well.  Select "off" if your printer generates
  86. its own line-feeds, otherwise choose "on".  If you find that your printer is
  87. producing a blank line after each line of text, or is printing everything on
  88. one line, you probably need to change this setting.
  89.  
  90. Print quality:
  91. -------------
  92. For printers which have both draft and near-letter-quality printing modes,
  93. it is possible to select the print quality for "fancy" text printing. For
  94. draft-only printers (e.g Epson FX), only draft may be selected.
  95.  
  96. Control codes:
  97. -------------
  98. This alters the way in which control characters in "fancy" text files are
  99. handled.  For most purposes, it should be set to "standard".  The "display"
  100. option causes all control characters (other than end-of-line characters) and
  101. top-bit-set characters to be expanded to a printable hex representation,
  102. e.g. "[7f]" for the DELETE character.  If "ignore" is chosen, all control
  103. characters (except end-of-line characters) and top-bit-set characters are
  104. ignored, and only the normal printable characters are sent to the printer.
  105.  
  106. Menu
  107. ====
  108.  
  109. Clicking MENU on the icon produces a menu which allows the print destination
  110. to be set, and the paper size to be altered.
  111.  
  112. Graphics page size information:
  113. ------------------------------
  114. Page size and margins supplied here must reflect the actual printable area
  115. of the page, and cannot be used to alter the format of text printed as a
  116. result of dragging text files onto the printer icon.  The paper limits are
  117. used to ensure correct positioning of graphics on the page, and are also
  118. reported back to applications such as Draw for information purposes. The
  119. values given refer to portrait-orientation paper - the corresponding values
  120. for landscape printing are deduced from these.
  121.  
  122. Text page size information:
  123. --------------------------
  124. These values apply to "fancy" text printing only.  Note that printing is
  125. right-ragged, and there is no right-margin control:  lines that are too long
  126. for the printer will wrap round without the printer driver being made aware
  127. of this.   A 1stWord+ page-layout format line at the start of a document can
  128. override the menu margin and page-length settings, provided the page length
  129. specified in the file is not greater than the menu value.
  130.  
  131. NFS printing:
  132. ------------
  133. There is a new option on the printer drivers in additions to Serial,
  134. Parallel, Econet and File. This is for NFS printing, for use with the TCP/IP
  135. suite available from Acorn. For more details about the options read your
  136. TCP/IP manual.
  137.  
  138. Additional notes
  139. ================
  140.  
  141. Multiple file printing:
  142. ----------------------
  143. If a file is dragged from a directory viewer on to the printer icon while
  144. the printer is printing or paused, then the file is added to the end of a
  145. queue of files.  When the current print finishes, the printer driver always
  146. looks in its queue, and if it isn't empty starts printing the first entry.
  147. If a selection of files are dragged together on to the printer, then they
  148. are all placed in the queue.
  149.  
  150. The queue stores names only, and if the queue is full when a file is dropped
  151. on to the printer then this file is rejected with a "Printer queue full"
  152. error message.  When a file name is retrieved from the queue for printing,
  153. the printer driver checks it for readability.  If the file cannot be found,
  154. or cannot be read, then it is discarded from the queue with an error
  155. message.
  156.  
  157. Files cannot be dragged out of application windows on to the printer while
  158. it is printing.  Any attempt to do so will produce an "Already printing"
  159. error message.  This is because such files would have to be physically
  160. copied rather than remembered by name.
  161.  
  162. To print all or some of the files in a directory, the directory must be
  163. opened, and a selection of files chosen and dragged on to the printer. It is
  164. not possible to print the contents of a directory by dragging the directory
  165. icon to the printer.
  166.  
  167. After a fancy text file is printed, then if the print queue is not empty and
  168. "manual" paper-feed is selected, the usual page-prompt is produced, so that
  169. the user can change paper.  If the print queue is not empty when printing a
  170. plain text file finishes, an additional single blank line is output.  At the
  171. end of the day, it is up to the user to think about the implications of
  172. printing together a particular group of files.
  173.  
  174. Clicking on the "Stop printing" main menu item while printing aborts
  175. printing completely, i.e. it gives-up printing the current file and flushes
  176. the file queue.  Clicking "No" on the page-prompt window has the same
  177. effect.  Slightly more subtle control is available from the "Stop printing"
  178. sub-menu:
  179.  
  180.      Stop printing => Abandon all
  181.                       Cancel current
  182.                       Cancel others
  183.  
  184. Clicking "Abandon all" is the same as clicking "Stop printing".  Clicking
  185. "Cancel current" skips to the end of the current document, tidies-up, and
  186. starts printing of the next queued file (or stops printing if the queue is
  187. empty).  Clicking "Cancel others" allows printing of the current document to
  188. continue, but flushes the rest of the file queue (this option is greyed-out
  189. if the queue is empty).
  190.  
  191. "Stop printing" and "Abandon all" should be used if your printer gets jammed
  192. up, if, say, the ribbon breaks or the paper gets scrunged. This can leave
  193. the printer in an odd state, so beware! The other two options are for more
  194. delicate handling controls, and they can only leave the printer in a
  195. sensible state.
  196.  
  197. Fancy text:
  198. ----------
  199. The standard control sequences recognised in "fancy" text files are a subset
  200. of those used by 1stWord+.  For instance, Pica/Elite/condensed/expanded,
  201. italics, underline, formfeed, etc.  It is not intended that this feature be
  202. used to print faithfully all possible features that may be included in a
  203. file produced by 1stWord+ (use 1stWord+ to print these!), but rather that
  204. simple features may be included in text files and printed without having to
  205. load a word-processing application.  All printable characters (including
  206. top-bit-set ones) may be translated into arbitrary strings on a
  207. printer-by-printer basis, as specified in the "PrData" file (see the example
  208. for the pound character in the file "PrDataSrc").
  209.  
  210. Plain text:
  211. ----------
  212. Control characters (other than end-of-line) in files printed as "plain" text
  213. are sent literally to the printer. This allows printer-dependent codes to be
  214. sent from a normal file.
  215.  
  216. Getting the best out of graphics printing
  217. =========================================
  218.  
  219. Graphics printing can be slow. It is important that the user knows how to
  220. get the best and fastest printouts from the computer without losing quality.
  221.  
  222. To perform a printout the printer driver grabs all the available memory in
  223. the 'Next' and 'Free' slots shown on the Task Window (menu on the task
  224. manager icon and select 'Task display'). The more memory available here, the
  225. faster things go. An average A4 page printed at a resolution of 200 by 100
  226. dpi requires about 1600 by 1100 dots (A4 is 11 inches up by 8 inches wide).
  227. This requires 1600*1100 bytes (1.76 MB) for a grey-scale dump, 1600*1100
  228. bits (220 kB) for a monochrome dump. If there is not enough memory available
  229. then the printer driver will do the job in sections. If you have 140 kB free
  230. and are doing a monochrome dump, then it will do two half pages of 110 kB
  231. each. If you are printing a !Draw document which only covers the bottom 1/4
  232. of the page, then the printer driver will not require a full page-worth of
  233. memory, and so it goes faster still.
  234.  
  235. So, to get the maximum speed out of your printouts do the following:
  236.  a) Decide if you can print in monochrome instead of grey-scaled. This can
  237. give a speed improvement of up to 8, so it is worth doing. You only need
  238. grey-scaled output if you are using fonts or sprites in anything other than
  239. black and white. Most of the time monochrome dumps will do.
  240.  b) Make sure you have plenty of available memory in the 'Next' and 'Free'
  241. slots. Shrink your RMA as much as possible, dispose of any sprites you might
  242. have in the sprite pool, get rid of an empty RAM disc. Remember - the more
  243. memory available, the faster it works.
  244.  
  245. 'Fancy text' file format:
  246. -------------------------
  247. The 'fancy' text file format is fairly simple. It consists of plain text,
  248. with added special sequences:
  249.  
  250. Character sequence     Meaning                     Action
  251.       <8>           Backspace character      Backspace if possible
  252.       <9>           Tab character            Tabulate to next 8th column
  253.      <10>           Linefeed character       Possible end-of-line
  254.                                               (depends on options)
  255.      <11><x>        Conditional pagebreak    Page break if less than x-16
  256.                                               lines left on page, else a new
  257.                                               line.
  258.      <12>           Unconditional pagebreak  Go to a new page (i.e. a page
  259.                                               break)
  260.      <13>           Return character         Possible end-of-line
  261.                                               (depends on options)
  262.  <24><x><y>,<n>     Footnote reference       Reference to footnote <n>, so
  263.                                               print <n>.
  264.      <25>           Soft hyphen              Print a hyphen
  265.      <27>           Escape character         Start escape sequence
  266.  <28>,<29> or <30>  Soft space               Discard if precedes a <10>,
  267.                                               <11>, <12> or <13>, else print
  268.                                               a space
  269.      <31>           Format character         Start format sequence
  270.                                               (reserved for Acorn use)
  271.      <127>          Delete character         Ignored
  272.  
  273. Escape sequence       Meaning
  274.  <27><%11000000>  Start literal escape sequence
  275.  <27><%10fedcba>  If 'a' is 1 then toggle bold style (on=>off, off=>on)
  276.                   If 'b' is 1 then toggle light style (on=>off, off=>on)
  277.                   If 'c' is 1 then toggle italic style (on=>off, off=>on)
  278.                   If 'd' is 1 then toggle underline (on=>off, off=>on)
  279.                   If 'e' is 1 then toggle superscript (on=>off,off=>on)
  280.                   If 'f' is 1 then toggle subscript (on=>off, off=>on)
  281.   <27><other>     Ignored
  282.  
  283. A literal escape sequence is a sequence of characters which are sent
  284. directly to the printer - and hence are printer specific. The sequence is
  285. ended by a <27><0>. A "||" pair sends a "|" character, a "|?" pair sends a
  286. <127>, and any other "|<x>" sequence sends <x AND 31>. Thus to send an
  287. escape character use "|[".
  288.  
  289. The file format is almost a subset of the 1st Word Plus file format, the
  290. basic omissions being headers and footers, and an incomplete implementation
  291. of footnotes.
  292.  
  293. The "PrData" file:
  294. -----------------
  295. This file contains printer configuration information.  It is read when the
  296. application starts, and updated by the "Save choices" menu item. Included in
  297. the file are the printer-specific control sequences used to print "fancy"
  298. text features.  "PrData" is a compressed file containing no comments.  A
  299. commented version is provided as "PrDataSrc", and there is a compression
  300. utility, "PrSquasher".  The printer driver can read uncompressed commented
  301. PrData files, but they cause it to start-up more slowly.  To produce your
  302. own PrData files for different printers, edit a copy of "PrDataSrc", check
  303. it for mistakes (!!), then use "PrSquasher" from the command-line to make a
  304. new "PrData" from it.  If you increase the number of entries in "PrData",
  305. you may also need to increase the "Wimpslot" size in "!Run". To run
  306. PrSquasher you should open the printer application directory (using
  307. shift-SELECT), and double-click on the BASIC program PrSquasher. You must
  308. then type in the absolute path-names of the input (unsquashed PrDataSrc) and
  309. output (squashed PrData) files.
  310.  
  311. Which dump types work on which printers:
  312. ----------------------------------------
  313. All LQ dumps work on the EPSON LQ-850. Note that some LQ-compatibles do not
  314. support 360 dpi dumps.
  315.  
  316. All FX dumps work on the EPSON FX-80 and FX-850.
  317.  
  318. All LQ dumps except 360 by 360 dpi work on an EPSON LQ-800.
  319.  
  320. The NEC PinWriter P6plus is as the LQ-850, except that the 360 by 360 dump
  321. is slightly different; a P6plus-specific alternative is provided.
  322.  
  323. The FX dumps also work on a Brother M-1409.
  324.