home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / p.lbr / PRTRLE.HZP / PRTRLE.HLP
Encoding:
Text File  |  1991-11-18  |  5.3 KB  |  115 lines
  1. ;
  2.                                  PRTRLE.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                4k (26)   477C  2.0        Gene Pizzetta 12/90      Z3COM15
  6.  
  7.   1- Syntax/Options  2- Errors  3- Configuration  4- RLE Files  5- Notes      
  8.  
  9.  
  10.    PRTRLE is  a ZCPR3  utility  that prints high resolution Run Length Encoded
  11. (RLE) graphics files on Epson graphic printers.
  12.  
  13.    Version 1.0 (9/17/87) by Gene Pizzetta.
  14. :1
  15.  Syntax   PRTASM {dir:}fn{.ft} {...} {/options}
  16.  
  17.    A file list may be given, but at least one  filename  is  required.   If no
  18. filetype is given, "RLE" is assumed.   Names in the file list may be separated
  19. by any number of spaces and commas.  Ambiguous filenames are not accepted, but
  20. will not abort the program.   If no  DU  or  DIR  specification  is given, the
  21. current drive/user is assumed.
  22.  Options 
  23.  
  24.   A leading slash is required.   If a  filename is  used  that  begins  with a
  25. slash, it must be preceded by a DU specification.
  26.  
  27.      F    Send a form feed to the printer after each picture is 
  28.           printed.  Normally, a form feed is sent after every 
  29.           third picture so three pictures are printer per page.  
  30.           This option actually toggles the default condition, 
  31.           which can be changed with ZCNFG.
  32.  
  33.      H    Do not print filename header before printing each 
  34.           picture.  This is useful for including pictures in 
  35.           documents.  This option actually toggles the default 
  36.           condition, which can be changed with ZCNFG.
  37.  
  38.    Once printing has begun,  pressing  any  key  will  cancel  printing of the
  39. current picture file.   If the pressed key is ^C,  PRTRLE  will  return to the
  40. operating system; otherwise,  it  will  skip  to the next file in the list and
  41. continue printing.
  42.  Options - 2/2 
  43.  
  44.    If a file cannot be found,  or if an  ambiguous  file  spec  is encountered,
  45. PRTRLE will display an error message  and  then  continue with the next file in
  46. the file list.  It will, however, set the program error flag on exit.
  47.  
  48.    PRTRLE, with header suppressed, can be used to insert a picture into a text
  49. file, if the paper has  been  properly  aligned.   Or,  using  the F option, a
  50. single picture can be printed on each page.
  51. :2
  52.  
  53.  Errors 
  54.  
  55.    Most error messages are  self-explanatory.   However, if you print many RLE
  56. files, you will probably see  "Non-standard RLE file"  or  "Unexpected end-of-
  57. file".  The first message means that PRTRLE has  encountered an escape code in
  58. the file that it does not recognize.  The latter message indicates that a CP/M
  59. end-of-file character was  encountered  before  the  proper terminating escape
  60. sequence was found.   I have run into  several  RLE  files that are terminated
  61. with an incorrect escape code or no code at all.   Usually the picture will be
  62. complete and the message can be  considered informational only.   There may be
  63. times, however, that these messages mean something is wrong.
  64.  
  65.    If an escape sequence  indicates  the  RLE  file contains medium-resolution
  66. graphics, PRTRLE will abort  printing  that  file with a message.   Only high-
  67. resolution graphics can be printed.   Medium resolution graphics files are not
  68. supported, mainly  because  I  haven't  found  any  medium resolution files to
  69. experiment with.
  70. :3
  71.  
  72.  Configuration 
  73.  
  74.    PRTRLE  configuration  options  can  be  easily  set  using  ZCNFG  and the
  75. accompanying  PRTRLEnn.CFG  file.   The  name  of  the  CFG file should not be
  76. changed, so that ZCNFG can always find it, even if you rename PRTRLE.
  77.  
  78.    No provisions have been made for  changing  the  printer  strings because I
  79. have no idea how  printers  that  are  not  Epson-compatible handle bit-mapped
  80. graphics.
  81.  
  82.    For full details of the configuration options see the ZCNFG help screens.
  83. :4
  84.  
  85.  RLE Graphics Files 
  86.  
  87.    Run  Length  Encoding is  a  machine  independent  graphics  standard  that
  88. originated on CompuServe.   It pre-dates CIS's current GIF standard, but it is
  89. widely used because it is supported  by more graphics programs running on more
  90. machines.   RLE files are  readily  available  on  both  CompuServe and GEnie,
  91. especially in the  Macintosh  and Commodore file areas.   Although the size of
  92. the data files vary with the  complexity of  the  picture, the number of bytes
  93. generated is always the same.  The files were designed for screen display, but
  94. a printer will do in a pinch, as PRTRLE shows.
  95. :5 
  96.  
  97.  PRTRLE Notes 
  98.  
  99.    a. Version 2.0 updates (12/26/90, Gene Pizzetta):
  100.       - Eliminated several CP/M 3-specific BDOS calls.
  101.       - Added DU support
  102.       - Eliminated warm boot on exit.
  103.       - Incorporated library routines.
  104.       - Translated to Zilog opcodes.
  105.       - Added LST-status check.  Now accepts a file list.  
  106.       - Aborts on ^C, but any other key skips to next file.  
  107.       - Sets error flag.
  108.       - Added configuration bytes and command line options.  
  109.       - ZCNFG configuration.
  110.       - Epson-specific  because  I don't  know  how  any other printers handle
  111.         graphics.
  112.  
  113.    b. Version 1.1 updates (9/20/87, Gene Pizzetta):
  114.       - Added page numbering and boldfacing in header.
  115.