home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / extra.zip / FAX.DOC < prev    next >
Text File  |  1994-06-09  |  5KB  |  114 lines
  1. FAX Sample Application
  2.  
  3. Caveat: Although the FAX sample included with this beta illustrates a number
  4. of typical facsimile functions, it does not contain the error recovery or
  5. feature set required of a robust application.
  6.  
  7. Here's a brief overview of how to run the sample fax application.
  8.  
  9. Starting the sample application
  10.  
  11. 1.  Copy fax.exe to a \fax subdirectory (or other convenient subdirectory)
  12. on your system.
  13.  
  14. 2.  If you wish to add a fax icon to the desktop:
  15.  
  16.   a.  Open the Templates folder and drag a copy of the Program icon to the
  17.   desktop.
  18.  
  19.   b.  Enter the following information in Program Settings: path and filename
  20.   of the executable (fax.exe); working directory; title for the icon
  21.   (e.g. FAXAPP).
  22.  
  23. 3.  To start FAXAPP, simply double-click on the FAX Applet icon (or enter
  24. fax from an OS/2 command line).
  25.  
  26. FAXAPP automatically opens and initializes the Mwave FAX device driver when
  27. it is started.  Message boxes allow you to begin the driver initialization,
  28. and report the status of the initialization operation.
  29.  
  30. Sending a fax
  31.  
  32. FAXAPP can send a BMP file (a type of DIB file) or a TIFF Class F format FAX
  33. Document File (which can be composed of single or multiple pages) to any
  34. remote fax machine.  BMP files are converted to TIFF format before being
  35. sent with FAXAPP.  The Mwave FAX driver supports conversion of BMP files to
  36. TIFF (and vice-versa), and FAXAPP uses this conversion support..
  37.  
  38. Note: BMP files are limited to black and white (monochrome) files only.
  39. Color BMP files are not supported by the Mwave FAX device driver.
  40.  
  41. Monochrome BMP files can be easily created using the Microsoft Windows
  42. application, Paintbrush, located in the Accessories program group.  After
  43. starting Paintbrush, select the "Image Attributes..." command from the
  44. "Options" menu, then click on "Black and White" for the image color.  Any
  45. image you create results in a monochrome BMP file when saved.
  46.  
  47. To send a file:
  48.  
  49. 1.  Select the Send command from the Options menu.
  50.  
  51. 2.  Select the file (either a BMP or TIFF file) to be sent.  If the selected
  52. file is a BMP file, the file must be converted from BMP format to TIFF
  53. format before being sent.  FAXAPP prompts you to enter the destination
  54. filename where the converted TIFF file is to be stored.  Be sure and specify
  55. a .TIF filename extension for the destination file.  Also, make sure the BMP
  56. file is monochrome.  Color BMP files will not be sent correctly.
  57.  
  58. 3.  Enter the phone number of the remote fax machine when prompted.  See the
  59. MCI_DIAL command in the FAX API Reference chapter for valid dial string
  60. characters.
  61.  
  62. The specified file is then sent, in the background, to the remote fax
  63. machine, allowing you to continue to use other applications.  A message box
  64. is displayed after successful completion or call termination due to an
  65. error.
  66.  
  67. Receiving a fax
  68.  
  69. FAXAPP automatically receives fax data from incoming fax calls.
  70.  
  71. The receive operation proceeds in the background, allowing you to continue
  72. working with other applications.  Message boxes are used to notify the user
  73. that a fax call has been received, and to display the receive operation's
  74. completion status (either success or failure).
  75.  
  76. Viewing a fax
  77.  
  78. FAXAPP enables you to view fax data from a BMP file or a single page from a
  79. TIFF FAX Document File.  To view a fax:
  80.  
  81. 1.  Select the View command from the Options menu.  Two types of view are
  82. available:
  83.  
  84.     Actual size - The upper left portion of the fax image is displayed in
  85.     the FAXAPP window.  No resizing of the original fax data is performed,
  86.     resulting in fast redraw performance.
  87.  
  88.     Fit to window - Stretches the fax image data to fit the FAXAPP window,
  89.     while maintaining the original image aspect ratio.  Viewing a fax in
  90.     this mode is much slower than viewing using the Actual size mode.
  91.  
  92. 2.  Select the file (either a BMP or TIFF file) to be viewed.  TIFF files
  93. must be converted to BMP format before being viewed.  For TIFF files, FAXAPP
  94. prompts you to enter the destination filename where the converted BMP file
  95. will be stored.  Be sure and specify a .BMP filename extension for the
  96. destination file.  If there are multiple pages of fax data within the
  97. specified TIFF file, you are prompted to select the number of the page you
  98. wish to view.
  99.  
  100.  
  101. Other commands
  102.  
  103. Two additional commands are available from the FAXAPP Options menu.  They
  104. are:
  105.  
  106. Hang up
  107. This command hangs up the phone (places the phone device on hook).  You can
  108. hang up the phone any time.
  109.  
  110. Clear screen
  111. This command clears the fax image currently displayed (if any) in the FAXAPP
  112. window.  Select the View command if you want to view another fax.
  113.  
  114.