home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / BGFAX160.ZIP / DOCS / VIEW.DOC < prev    next >
Encoding:
Text File  |  1996-06-22  |  11.5 KB  |  258 lines
  1.  
  2. Documentation for VIEW.EXE, version 1.60
  3. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4. VIEW.EXE is Copyright (C) 1993-1996 B.J. Guillot.  All Rights Reserved.
  5.  
  6. VIEW is designed for use with the BGFAX shareware fax receiving/sending
  7. program for DOS and OS/2.                 http://www.blkbox.com/~bgfax/
  8.  
  9. VIEW [filename|filespec] [options]
  10.  
  11. VIEW has been designed to read faxes stored in the following formats
  12.         (a)  ZFAX version 2  (1D-MH coding only)
  13.         (b)  Smith Micro Software's QuickLink II QFX
  14.         (c)  TIFF-Class-F  (used by Faxworks, Word Perfect 5.1+, etc.)
  15.         (d)  Unknown formats (such as Binkley RAW, etc.)
  16.              (Results will vary when trying to read an unknown format)
  17.  
  18. It can VIEW, PRINT, and CONVERT the above fax types to PCX and DCX files.
  19.  
  20. The default filespec is "*.??X" which nicely handles *.FAX, *.QFX, *.PCX,
  21. and *.DCX.  If you specify a filename rather than a filespec, VIEW works
  22. in batch mode rather than menu mode.  (See notes on BATCH mode at the end
  23. of this document.)
  24.  
  25. To use VIEW, change into the directory where all your faxes are located,
  26. and then start it, by typing "VIEW".  If if finds any faxes, it will bring
  27. up a list of them on the screen, and you can use the up and down arrows to
  28. select which fax you wish to view or print.
  29.  
  30. The available commands are listed on the bottom of the screen...
  31. <Enter>=view, <Ctrl-Enter>=print, <F2>=convert to PCX, <F3>=convert to DCX,
  32. and <Delete>=delete the fax
  33.  
  34. If you are converting the fax to PCX or DCX format, see the special
  35. notes about this near the end of this file.
  36.  
  37. If you start VIEW without any command line parameters, it will automatically
  38. detect either a CGA, EGA, or VGA display.  However, IT WILL NOT DETECT THE
  39. PRINTER TYPE, SO YOU WILL HAVE TO SPECIFY THAT MANUALLY.  If a printer type
  40. is not specified, the "print" option on the menu will be greyed out.
  41.  
  42. To force a specific video mode when starting VIEW...
  43. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  44.                              Mode  Resolution   Addr
  45.                              ----  ----------   -----
  46. VIEW /CGA                    $6    640x200      $b800
  47. VIEW /EGA                    $10   640x350      $a000
  48. VIEW /VGA                    $11   640x480      $a000
  49. VIEW /800 (or VIEW /SVGA)    $102  800x600      $a000   (VESA mode)
  50. VIEW /1024                   $104  1024x768     $a000   (VESA mode)
  51. VIEW /1280                   $106  1280x1024    $a000   (VESA mode)
  52.  
  53. Your video card and/or monitor may not be able to support all of the modes
  54. available.  If your monitor starts to make funny noises when going into
  55. some of the higher modes (/1024 or /1280), then TURN IT OFF!  B.J. Guillot
  56. will not be liable for any damage caused by leaving the monitor in a state
  57. in which it was not designed to be used in.
  58.  
  59. ============================================================================
  60. Commands available while viewing the fax itself
  61. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  62. When the fax image is on the screen, you have a few choices...
  63.  
  64.      F1     HELP screen showing list of commands
  65.  
  66.      Alt-I  INVERT the fax colors, white <--> black, easier to read for some
  67.  
  68.      Alt-F  FLIP the fax for thoese people that send you upside down faxes
  69.  
  70.      Alt-S  SHRINK/SQUEEZE the fax so that the image appears smaller
  71.             (You can press Alt-S *multiple times* to change between many
  72.             different magnification factors.)
  73.  
  74.      Alt-J  JUMP to page number entered by user when prompted
  75.             (If using Alt-J on a ZFAX stored file, VIEW must first analyze
  76.             the fax finding all page boundries.  On slow machines that may
  77.             take several seconds.)
  78.      Alt-G  GOTO page number (same as Alt-J)
  79.  
  80. Ctrl-Enter  PRINT CURRENT PAGE
  81.  
  82.       PgDn  Goto NEXT Page
  83.       PgUp  Goto PREVIOUS Page
  84.  
  85. You can pan around by using the up, down, left, and right arrow keys.
  86.  
  87.        F2   Debug Info--Nothing useful to you
  88.        F3   If you get really bored, hold down F3 for several seconds
  89. ============================================================================
  90.  
  91.  
  92. To use a specific printer driver when starting VIEW...
  93. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  94.      Switch   DPI    Printer
  95.      ------ -------  -------------
  96. VIEW /P9   240x67.5  Epson compatible 9-pin dot matrix
  97.                      (9-pin mode will print faxes TWICE as high as normal
  98.                      in order for more resolution to be printed.)
  99.  
  100. VIEW /P24   180x180  Epson compatible 24-pin dot matrix, Canon BJ-600/4000
  101. VIEW /P25   360x180  Epson compatible 24-pin dot matrix, Canon BJ-600/4000
  102. VIEW /P26   180x180  Canon BJ-200 compatible bubble-jet printer
  103. VIEW /P27   360x360  Canon BJ-200 compatible bubble-jet printer
  104.  
  105. VIEW /P37   150x150  PCL level 3 compatible laser printer
  106. VIEW /P38   150x150  PCL level 4 compatible laser printer (faster than PCL3)
  107. VIEW /P39   150x150  PCL level 5 compatible laser printer (faster than PCL4)
  108.  
  109. VIEW /P40   300x300  PCL level 3 compatible laser printer
  110. VIEW /P41   300x300  PCL level 4 compatible laser printer (faster than PCL3)
  111. VIEW /P42   300x300  PCL level 5 compatible laser printer (faster than PCL4)
  112.  
  113. VIEW /P24 is recommened for most dot matrix printers, and /P40 is recommened
  114. for most lasers if you do not know what PCL level it supports.
  115.  
  116. Most Canon 600 and 4000 printers are set for "color" mode.  The Canon will
  117. be in Epson mode, that's why /P24 and /P25 are better choices for the color
  118. Canon printers.  Black and white Canon printers will probably need the
  119. /P26 or /P27 switch.  It depends on the DIP switch settings on the printer.
  120.  
  121. *********** What about printing to ports other than LPT1 ??? *************
  122.  
  123. VIEW /P40:LPT2
  124. Will print to a laser printer on LPT2 as a software interrupt 17 device.
  125. (Should use this.)
  126.  
  127. VIEW /P40:+LPT2
  128. Will print to a laser printer on LPT2 as a "file" rather than a device.
  129. (Sometimes this prints a little faster, but usually it prints much slower.)
  130.  
  131. VIEW /P40:+TEST.PRN
  132. then from a DOS prompt, "copy test.prn lpt2" as an alternate way of printing
  133.  
  134. *** What about A4 or US-Legal paper sizes?
  135.  
  136. VIEW /P40 /A4       for metric-A4 (rather than US-letter)
  137. VIEW /P40 /LP       for US-legal (rather than US-letter)
  138. VIEW /P40 /PL:nnnn  define your own number of scanlines (non-standard paper)
  139.  
  140.  
  141. Multiple command lines parameters
  142. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  143. VIEW /p40 /1024 /a4
  144.  
  145. For example would make VIEW use 1024x768 resolution when viewing faxes and
  146. print faxes (when the user hits Ctrl-Enter) to a laser printer.  It is
  147. suggested that you make a batch file to call VIEW with these parameters so
  148. that you don't have to always type them in.
  149.  
  150. You do not want to type that in all the time, so I would suggest creating
  151. a batch file, V.BAT, to startup "menu" mode easily...
  152.  
  153. @c:\bgfax\view /p40 %1 %2 %3 %4 %5
  154.  
  155.  
  156. BATCH MODE  (Printing or Converting without user intervention)
  157. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  158. You can also start VIEW in a "batch" mode, which requires no user
  159. intervention.
  160.  
  161. "VIEW FAX0001.FAX /P40" would print the fax0001.fax file to a laser printer.
  162. "VIEW fax0001.fax /dcx" would convert that fax to a DCX file
  163. "VIEW fax0001.fax /pcx" would convert that fax to PCX files
  164.  
  165. (Note that a DCX file is basically a multipage PCX file, and many fax
  166. applications support the DCX format.  PCX format gets messy because each
  167. fax page has to be saved into a seperate file, but PCX format is nearly
  168. universal and just about every graphics program on the planet will let
  169. you load a PCX image.)
  170.  
  171. THE FILENAME MUST BE THE FIRST COMMAND LINE PARAMETER IN ORDER FOR
  172. BATCH MODE TO FUNCTION!
  173.  
  174.  
  175. Notes about FAX->PCX and FAX->DCX conversions
  176. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  177. PCX files are both great and bad.  They are great because almost every
  178. graphics program on the face of the planet can use PCX files.  They are
  179. bad because only one page can be stored in a single file!  Ugh!
  180.  
  181. Intel solved that problem by "inventing" the DCX file format, which is
  182. essentially a "collection" of PCX files, with a small header at the top
  183. of the file.  Intel used DCX exclusively with their CAS fax software for
  184. the Intel Satisfaxtion modem, but the DCX format became very popular,
  185. and it is finally starting to catch on (even though Intel no longer
  186. supports the Satisfaxtion modem.)
  187.  
  188. But, most software still cannot handle DCX files, so we are limited to
  189. using PCX files.  You need to learn how VIEW.EXE names the multiple PCX
  190. files that will when you do a convert.
  191.  
  192. For example, take a 3 page file, HELLO.FAX and convert it to PCX:
  193.   VIEW will create PAGE0001.PCX, PAGE0002.PCX, and PAGE0003.PCX
  194.  
  195. VIEW will also create a BATCH file called DOPCX.BAT that has three lines:
  196.   CALL EXEPCX PAGE0001.PCX PAGE0001
  197.   CALL EXEPCX PAGE0002.PCX PAGE0002
  198.   CALL EXEPCX PAGE0003.PCX PAGE0003
  199.  
  200. You can make your own "EXEPCX.BAT" file that utilities some OCR utility,
  201. for example, and have it scan the three output files.  The "%1" variable
  202. will pass the full name (PAGEnnnn.PCX) and the "%2" variable will pass
  203. the filename only (PAGEnnnn) since some software will barf if you send
  204. it the PCX extension.
  205.  
  206. DCX files will retain the filename during conversion.  For example, to
  207. convert HELLO.FAX to DCX, the output file will be called HELLO.DCX.
  208.  
  209. Note that low resolution faxes will have the number of scan lines
  210. doubled so that the effective resolution on any PCX or DCX file will
  211. be 200 dpi.
  212.  
  213. Miscellaneous switches
  214. ~~~~~~~~~~~~~~~~~~~~~~
  215. VIEW /DB    Try to display bad scan lines (normally, VIEW just puts a dotted
  216.             line across the screen if it detects a bad scan line.)
  217.  
  218. VIEW /BO    Display fax using a backwards bit order.  This may be necessary
  219.             if you have received a fax on a USR modem with Binkley's internal
  220.             fax routines, or if you have started BGFAX with the incorrect
  221.             command line switch.
  222.  
  223. /RH         "Retain original Height" during PCX and DCX conversions.  This
  224.             keeps low res faxes at 100 dpi during conversion instead of
  225.             doubling the height.
  226.  
  227. /RF         "Retain original Filename" during PCX and DCX conversions.
  228.             Instead of calling PCX files, PAGE0001.PCX, PAGE0002.PCX,
  229.             PAGE0003.PCX, etc., a file called HELLO.FAX would have the
  230.             following output files:
  231.                 HELLO.PCX, HELLO.P01, and HELLO.P02
  232.             Most graphics editing software requires a "PCX" extension on
  233.             the filename, so this mode is not recommened.  It is provided
  234.             to maintain compatibility with the old VIEW 1.55 and below.
  235.  
  236. /PL:nnnn    This lets you refine the "page length" of a piece of laser
  237.             paper, in the number of laser-scan lines.  Normally, VIEW uses
  238.             3380 scan lines for a piece of A4 paper, but I was told some A4
  239.             printers very, i.e.:
  240.                Deskjet 500C A4                    /A4 /PL:3170
  241.                Deskjet 500C A4/performation skip  /A4 /PL:3320
  242.                Deskjet 500 A4                     /A4 /PL:3234
  243.                Oki Laserline 6 A4                 /A4 /PL:3411
  244.             If you are using US paper size, this is not necessary!
  245.  
  246.  
  247. Note about 2D-MR compressed faxes
  248. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  249. VIEW does not currently support 2D-MR faxes properly.  A 2D-MR fax is
  250. basically a 1D-MH normal fax with every other line having only "difference"
  251. information rather than the whole scan line encoded.  VIEW will correctly
  252. view the 1D-MH lines, but will show the 2D-MR lines as improperly decoded
  253. scan lines.
  254.  
  255. Regards,
  256. B.J. Guillot
  257.  
  258.