home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / c / capsl / !CaPSL / !Help < prev    next >
Encoding:
Text File  |  1990-11-19  |  7.2 KB  |  141 lines
  1. > <CaPSL$Dir>.!Help
  2.  
  3. This application was written as a stop-gap measure whilst waiting for
  4. Computer Concepts to send me a LaserDirect HiRes expansion card to drive
  5. my Canon LBP-4 laser printer.
  6.  
  7. The LBP-4 is not Hewlett Packard LaserJet compatible.  Instead it has its
  8. own command language, known as CaPSL (Canon Printing System Language)
  9. which is actually much more powerful and versatile than Hewlett Packard's
  10. PCL.  The vector graphics and text scaling and rotation capabilities of
  11. CaPSL are every bit as powerful as PostScript, though sadly, nothing like
  12. as well supported when it comes to printer driver software.
  13.  
  14. This program is not a RISC OS printer driver for the LBP-4 (that would have
  15. taken me far too long to write) but it will print files containing text if
  16. you drag their icons onto the iconbar icon.  Rather, it is a translator
  17. which will convert the output of the LaserJet printer driver, PrinterLJ,
  18. into CaPSL which is suitable for driving the LBP-4 (or the LBP-8).
  19.  
  20. Launch the !CaPSL application in the usual way by double clicking on its
  21. icon in the desktop filer window.  This installs the icon on the iconbar.
  22. Clicking MENU on the iconbar icon pops up a menu with the following entries.
  23.  
  24. Info          - This leads to the usual 'About this program' dialogue box.
  25.  
  26. To printer    - This item is ticked by default and indicates that the output
  27.                 will be sent to the printer.  This is achieved by the
  28.                 program opening a pseudo-file with the filename Printer:
  29.                 this enables the user to decide whether the printer is
  30.                 connected to the serial port, the parallel port, or the
  31.                 network.
  32.  
  33. To file       - Output can be sent to the printer, to a file or to both
  34.                 but not to neither.  If you click on 'To printer' to cancel
  35.                 the tick, then 'To file' will be ticked automatically.  You
  36.                 will be given the opportunity to specify a filename later.
  37.  
  38. Stop printing - This option is greyed out until printing is actually in
  39.                 progress.  When chosen, the input file is closed and no more
  40.                 data is sent to the printer.  Printing will not stop
  41.                 immediately because of buffering inside the printer, but
  42.                 when this buffer is empty the page will be ejected and the
  43.                 printer reset.
  44.  
  45. Fast print    - As a considerate multi-tasking application this program
  46.                 prints in background, taking only short bursts of CPU time
  47.                 by responding to null reason codes in its wimp polling loop.
  48.                 This means that the file being printed is processed only a
  49.                 few bytes at a time, therefore taking several minutes to
  50.                 print.  The fast print option selects the CPU hogging mode
  51.                 and the file is processed in chunks of 10k bytes with the
  52.                 wimp only being polled between these chunks and the hour-
  53.                 glass being displayed most of the time.  The advantage is
  54.                 that the file is printed much more quickly.
  55.  
  56. Small text    - This mode only operates in the text printing mode, ie. when
  57.                 a file containing text (a Text file, an Obey file or a
  58.                 Command file) has been dragged on to the iconbar icon.  It
  59.                 is useful for printing program source listings as it gets
  60.                 much more on a page.
  61.  
  62. Quit          - If printing is not in progress the application exits cleanly
  63.                 and removes its icon for the iconbar.  If printing is in
  64.                 progress a dialogue box is displayed asking if you really
  65.                 want to quit.  If you answer YES the 'Stop Printing' routine
  66.                 is called and the current page ejected (when the printer
  67.                 buffer is empty).  The application then exits.
  68.  
  69. Clicking SELECT or ADJUST on the iconbar icon has no effect at present.
  70.  
  71. To print a text file drag its icon from the filer window to the iconbar
  72. icon.  The filetype of the file is checked and valid types are Text, Obey
  73. and Command.  Suitable error messages are produced if you drag a directory
  74. or an application directory, or a file of any other type.  Unstamped files
  75. give you the option to print them assuming that they contain text.  It is
  76. up to you to ensure that they do contain text if you answer YES.  When you
  77. drag a file icon it must originate inside a filer window as direct memory
  78. transfer is not supported and produces an error message if attempted.
  79.  
  80. Only two other types of file can be printed.  These are type &FF4 PrintOut
  81. as produced when PrinterLJ is used with the 'To File' menu option ticked
  82. (type &FF3 is also accepted as it is the type that ought to be used for
  83. LaserJet dumps) and type &483 CaPSLDat which is the filetype generated
  84. by this application when the 'To File' menu option is ticked.
  85.  
  86. So, to print, say a Draw file, you must first print it to a file using
  87. PrinterLJ, then (having re-selected 'To printer' in PrinterLJ's menu)
  88. drag the PrintOut file to the CaPSL iconbar icon.
  89.  
  90. When a suitable file icon has been dragged to the iconbar icon if the
  91. 'To file' menu item is currently ticked a 'Save as' dialogue box is opened
  92. allowing the user to type in a filename and drag the icon to a filer window.
  93. Processing of the input file now takes place with output data being send
  94. to the printer and/or the output file.
  95.  
  96. If another file icon is dragged to the iconbar icon while printing is in
  97. progress an error box is displayed as only one file can be processed at a
  98. time.
  99.  
  100. As I mentioned earlier, I wrote this application as a temporary measure to
  101. enable me to use my printer until the expansion card arrives from Computer
  102. Concepts.  If it proves to be useful to others then so much the better.
  103.  
  104. The program does not translate the full set of PCL (LaserJet) control
  105. codes - just those produced by the PrinterLJ driver.  I might well add
  106. others in the future.
  107.  
  108. -----------------------------------------------------------------------------
  109.  
  110. Additional notes.
  111.  
  112. The Canon LBP-4 is supplied with only 512k of memory.  This is sufficient
  113. for printing text files, but the LaserJet translation mode puts the printer
  114. in 'Full Paint Mode' for which approximately 1M of memory is needed inside
  115. the printer.  The only way to achieve this is to fit a Canon Memory
  116. Expansion Board B 1MB (part number S63-2230-000) inside the printer as
  117. detailed in the Operator's Manual.
  118.  
  119. The program was written using Acorn ANSI C (release 3) and it needs access
  120. to the Shared C Library version 3.50 or higher which it expects to find in
  121. the System:Modules directory.  A copy is provided on this disc in case yours
  122. is an earlier version.  Please note that Acorn's copyright exists on the
  123. Shared C Library and that users are bound by Acorn's End User Licence.
  124.  
  125. The rest of the program was written by me for my own use but if anyone else
  126. wants a copy they may copy it freely and give it away, provided they make no
  127. commercial gain and that the copy is complete and unaltered and contains
  128. this message.
  129.  
  130. If you have any comments I would welcome them.  You can contact me in the
  131. following ways:
  132.  
  133. Mail:        8 Grafton House
  134.              The Farmlands
  135.              Northolt
  136.              Middlesex
  137.              UB5 5ER
  138.  
  139. Electronic:  Archive BBS (0603) 745932, account no. 247
  140.              Arcade BBS 081-654 2212, account no. 247
  141.