home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / demos / program / afaxdemo.lzh / AfaxDemo / docs / UserGuide < prev    next >
Text File  |  1992-11-07  |  50KB  |  1,826 lines
  1. [Note: This is a translation by dvi2tty of the TeX documentation.
  2.        As such, it is not as pretty as is could be.
  3.        Sorry.  -David]
  4. ====================================================================
  5.  
  6.  
  7.  
  8.  
  9.                                AmigaFax
  10.  
  11.  
  12.                          The Amiga Fax System
  13.  
  14.  
  15.  
  16.                         C-Born Software Systems
  17.  
  18.  
  19.  
  20.                            November 7, 1992
  21.  
  22.  
  23.  
  24.  
  25. ====================================================================
  26.  
  27.  
  28.  
  29.  
  30. Copyright (C) 1992 by C-Born Software Systems
  31.  
  32. All right reserved.  No part of this document may be reproduced,
  33. stored in a retrieval system, or transmitted, in any form or by any
  34. means, electronic, mechanical, photocopying, recording, or otherwise,
  35. without the prior written permission of the publisher.
  36. Printed in Australia.
  37.  
  38.  
  39.  
  40. PRODUCTION NOTE
  41.  
  42. This document was produced using the LaTEX document preparation
  43. system macro package for AmigaTEX , Tomas Rokicki's implementa-
  44. tion of Donald Knuth's TEX typesetting system, running entirely on
  45. Commodore Amiga computers. It was printed on a Hewlett Packard
  46. LaserJet III printer, using an Adobe PostScript cartridge.
  47.  
  48.  
  49.  
  50. About...
  51.  
  52. All the software described herein was developed in Australia by C-
  53. Born Software Systems, on Commodore Amiga computers.
  54.  
  55.  
  56.  
  57. PRINTED IN AUSTRALIA
  58.  
  59.  
  60.  
  61.                          ii
  62. ^L
  63.  
  64.  
  65.  
  66.  
  67. Contents
  68.  
  69.  
  70.  
  71. 1  Introduction                                             1
  72.    1.1 What is AmigaFax?   : : : : : : : : : : : : : : : : : : : : : :   1
  73.    1.2 Summary of Features : : : : : : : : : : : : : : : : : : : : : :   1
  74.    1.3 System Requirements   : : : : : : : : : : : : : : : : : : : : :   3
  75.  
  76.  
  77. 2  Installation                                              5
  78.    2.1 Installing the Software  : : : : : : : : : : : : : : : : : : : : :   5
  79.    2.2 Basic Configuration   : : : : : : : : : : : : : : : : : : : : : :   6
  80.    2.3 Hardware  : : : : : : : : : : : : : : : : : : : : : : : : : : : :   6
  81.    2.4 ARP  : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : :   7
  82.    2.5 Extra FONTS : : : : : : : : : : : : : : : : : : : : : : : : : :   7
  83.    2.6 Printer Setup  : : : : : : : : : : : : : : : : : : : : : : : : : :   7
  84.    2.7 Configuring for Hardware and User Preferences  : : : : : : :   7
  85.  
  86.  
  87. 3  Configuring the System                                  9
  88.    3.1 General Configuration  : : : : : : : : : : : : : : : : : : : : :   9
  89.    3.2 AmigaFax User Interface : : : : : : : : : : : : : : : : : : : :  10
  90.    3.3 Fax Page Layout Options  : : : : : : : : : : : : : : : : : : :  10
  91.    3.4 Fax Viewer Configuration  : : : : : : : : : : : : : : : : : : :  11
  92.    3.5 Fax Printer Configuration  : : : : : : : : : : : : : : : : : : :  11
  93.    3.6 Fax Spooler Configuration  : : : : : : : : : : : : : : : : : : :  11
  94.    3.7 Fax Receiver Configuration  : : : : : : : : : : : : : : : : : :  12
  95.    3.8 Fax Transmitter Configuration  : : : : : : : : : : : : : : : :  12
  96.    3.9 Modem Command and Status Strings  : : : : : : : : : : : :  13
  97.  
  98.  
  99. 4  The Workbench Interface                                15
  100.    4.1 AmigaFax  : : : : : : : : : : : : : : : : : : : : : : : : : : : :  15
  101.    4.2 FaxAutoAnswer : : : : : : : : : : : : : : : : : : : : : : : : :  17
  102.    4.3 FaxSpool   : : : : : : : : : : : : : : : : : : : : : : : : : : : :  17
  103.  
  104.  
  105.                              iii
  106. ^L
  107.  
  108.  
  109.  
  110.  
  111. 5  Operating from the Shell                                19
  112.    5.1 AFAX  : : : : : : : : : : : : : : : : : : : : : : : : : : : : : :  20
  113.    5.2 NEWFAX  : : : : : : : : : : : : : : : : : : : : : : : : : : : :  20
  114.    5.3 AFAXSPL : : : : : : : : : : : : : : : : : : : : : : : : : : : :  20
  115.    5.4 MKAFAX  : : : : : : : : : : : : : : : : : : : : : : : : : : : :  21
  116.    5.5 AmigaFax Command File Format : : : : : : : : : : : : : : :  21
  117.        5.5.1 Fill Mode  : : : : : : : : : : : : : : : : : : : : : : : :  23
  118.        5.5.2 Stackable fonts and Style support : : : : : : : : : : :  23
  119.    5.6 AFAXSEND   : : : : : : : : : : : : : : : : : : : : : : : : : :  25
  120.    5.7 AFAXPRT   : : : : : : : : : : : : : : : : : : : : : : : : : : :  25
  121.    5.8 FAA  : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : :  25
  122.    5.9 AFAXILBM : : : : : : : : : : : : : : : : : : : : : : : : : : :  26
  123.    5.10VIEWAFAX : : : : : : : : : : : : : : : : : : : : : : : : : : :  27
  124.    5.11FXFX  : : : : : : : : : : : : : : : : : : : : : : : : : : : : : :  28
  125.    5.12DVIFAX : : : : : : : : : : : : : : : : : : : : : : : : : : : : :  29
  126.  
  127.  
  128. A  Configuration Specifics                                  31
  129.    A.1 FAXLIB:Aliases : : : : : : : : : : : : : : : : : : : : : : : : :  31
  130.    A.2 FONTS  : : : : : : : : : : : : : : : : : : : : : : : : : : : : :  32
  131.  
  132.  
  133. B  Integration with other software                          33
  134.    B.1 UUCP  : : : : : : : : : : : : : : : : : : : : : : : : : : : : : :  33
  135.    B.2 TEX  : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : :  33
  136.    B.3 PostScript  : : : : : : : : : : : : : : : : : : : : : : : : : : : :  33
  137.    B.4 Printer Driver : : : : : : : : : : : : : : : : : : : : : : : : : :  34
  138.    B.5 BBS Systems  : : : : : : : : : : : : : : : : : : : : : : : : : :  34
  139.  
  140.  
  141. C  FaxModem Specifics                                    35
  142.    C.1 ZyXEL U-1496  : : : : : : : : : : : : : : : : : : : : : : : : :  35
  143.    C.2 Maestro 9600XR  : : : : : : : : : : : : : : : : : : : : : : : :  36
  144.  
  145.  
  146.  
  147.                               iv
  148. ^L
  149.  
  150.  
  151.  
  152.  
  153. Chapter  1
  154.  
  155.  
  156.  
  157. Introduction
  158.  
  159.  
  160.  
  161. 1.1    What is AmigaFax?
  162.  
  163.  
  164. AmigaFax is a software package that, in combination with a FaxModem,
  165. allows you to send and receive facsimile information from your Amiga com-
  166. puter. Received faxes can be viewed, printed, forwarded to other fax ma-
  167. chines, and saved as ILBM files which can then be accessed using many
  168. standard Amiga programs.  You can transmit text, ILBM graphics, and
  169. combinations of these as faxes.  Using the AmigaFax command language
  170. you can add text from any Amiga font, along with logos and ILBM graphics,
  171. to create high quality multi-page fax documents.
  172.    AmigaFax can be set up to automatically send documents to multiple
  173. recipients, to send faxes at or after set times, and to answer incoming fax
  174. calls automatically.
  175.    Faxes can be printed on plain paper, using your normal Amiga printer.
  176.    AmigaFax is highly configurable, allowing you to set up a custom envi-
  177. ronment that best suits your hardware and way of working.
  178.  
  179.  
  180.  
  181. 1.2    Summary of Features
  182.  
  183.  
  184.    o Automatic Reception
  185.      AmigaFax may be configured to receive faxes in the background, or to
  186.      answer an already ringing line in Fax mode. Autoanswer may also be
  187.      integrated with a UUCP or BBS environment, where incoming calls
  188.      may be Fax or data, by using a specially modified version of the getty
  189.      program that recognises Fax calls.
  190.  
  191.  
  192.                              1
  193. ^L
  194.  
  195.  
  196.  
  197.  
  198. o Automatic Transmission
  199.   Faxes may be queued for transmission after a particular time, to take
  200.   advantage of lower off-peak telecom rates, for example.  You may
  201.   specify the number of times to try before giving up on transmission,
  202.   and the period at which retry attempts should be made.  All call
  203.   progress is logged, and progress may be monitored from the main
  204.   program. Call logging displays when attempts were made, the success
  205.   or failure of the call, and the Called Number ID of the remote Fax
  206.   machine reached.
  207.  
  208.  
  209. o Multiple Recipients
  210.   Fax numbers may be entered either directly, or using defineable aliases.
  211.   Therefore instead of sending to `99123456', you could send it to `Fred'.
  212.   In the same way, an alias can refer to a list of other aliases, or num-
  213.   bers, so that one fax could be sent to `Customers', representing a list
  214.   of customers.
  215.  
  216.  
  217. o Flexible Fax Viewer
  218.   The Fax viewer allows you to view a fax document at scales of from
  219.   1:1 to 1:8. A 1:3 scale igenerally gives a quite readable image while
  220.   still fitting the entire Fax width across a standard Amiga screen. You
  221.   can easily zoom in on areas of particular interest if required.
  222.  
  223.  
  224. o Powerful Document Builder
  225.   This allows you to mix any Amiga font or ILBM graphic on a page,
  226.   include text, ILBM, Fax, or AmigaFax command files anywhere on
  227.   a page or in a document, perform alignment at character or pixel
  228.   level, justify text regardless of font size, automatically add standard
  229.   information such as address, signature, logo, and current time/date.
  230.  
  231.  
  232. o Highly User Configurable
  233.   The configuration file allows you to set the system up to suit your
  234.   requirements.  You can define your prefered editor for text and for
  235.   graphics, set a standard file to use as a template when creating new
  236.   Fax documents, customize your dial type (pulse/tone, special prefix
  237.   to get outside line, etc), set the Caller ID string to identify yourself
  238.   to remote Fax machines, define the modem type you are using, and
  239.   set many system default values.
  240.  
  241.  
  242. o Multiple Serial Port Support
  243.   Using the A2232 multi-serial port card, AmigaFax can support mul-
  244.   tiple FaxModems simultaneously, each modem being able to transmit
  245.   and receive facimiles and data.
  246.  
  247.  
  248.                            2
  249. ^L
  250.  
  251.  
  252.  
  253.  
  254.    o Uses Preferences Printer
  255.      Because the Amiga Preferences printer is used to print out the docu-
  256.      ments, you can tradeoff speed for resolution as you require.
  257.  
  258.    o Workbench or CLI interface
  259.      AmigaFax can be run either from the workbench, or from a shell or
  260.      CLI interface. In either case, an easy to use graphical presentation
  261.      makes operation straightforward.
  262.  
  263.  
  264.  
  265. 1.3    System Requirements
  266.  
  267.  
  268. AmigaFax requires AmigaDOS version 1.3 or greater.  It operates with
  269. AmigaDOS 2.0, and will run on Amigas from the original A1000 through
  270. to the A3000.  It is possible to run on an unexpanded A1000 with 512K
  271. RAM and 1 disk drive, but in this case memory and disk restraints will
  272. limit the number and size of faxes that may be generated or received. In
  273. general the more memory and disk available the better.  For unattended
  274. Auto-receive operation a hard disk system is highly desirable.
  275.  
  276.  
  277.  
  278.                              3
  279. ^L
  280.  
  281.  
  282.  
  283.  
  284. 4
  285. ^L
  286.  
  287.  
  288.  
  289.  
  290. Chapter  2
  291.  
  292.  
  293.  
  294. Installation
  295.  
  296.  
  297.  
  298. Warning: Be sure to back up your original disks, and use working copies
  299. of the disks for normal operation.
  300.  
  301.  
  302.  
  303. 2.1    Installing the Software
  304.  
  305.  
  306. Information on installing the AmigaFax software on your system is given
  307. in the ReadMe file on the distribution disk. Insert the distribution disk, and
  308. from the WorkBench double-click on the ReadMe icon for instructions.
  309.    The installation script should automatically handle most installations.
  310. To use it, from the WorkBench double-click the Install_Now icon, or from
  311. a Shell window type amigafax:install. The script will prompt you for
  312. information required to complete the installation.
  313.    If you are updating to a later revision, the installation procedure will not
  314. overwrite your configuration or alias files, so you will not lose information.
  315. However in this case you may want to examine the files in the directories
  316. lib.user and s.user on the distribution disk for examples of more recent
  317. configuration options.
  318.    The AmigaFaX software requires certain logical assignments to be made.
  319. The installation procedure will create a file afax:s/User-Startup.  You
  320. must edit your S:User-Startup (2.0) or S:Startup-Sequence (1.3)
  321. to include the contents of that file, which will be typically something like:
  322.  
  323. assign afax: Work:AmigaFax
  324. mount null:
  325. run >nil: <nil: l:fifo-handler
  326. if exists afax:s/AFAX-Startup
  327.         execute afax:s/AFAX-Startup
  328.  
  329.  
  330.                              5
  331. ^L
  332.  
  333.  
  334.  
  335.  
  336. endif
  337.  
  338.  
  339.    If your devs:MountList doesn't contain an entry for the NULL: device,
  340. append the MountList file from the devs directory on the AmigaFax to it.
  341.  
  342.  
  343.  
  344. 2.2    Basic Configuration
  345.  
  346.  
  347. There are many possible ways to operate the AmigaFax software. You may
  348. wish to operate it as the only software using your FaxModem, or have it
  349. share the modem with other software such as AmigaUUCP. The AmigaFax
  350. spooler may be started when you boot up your computer, or only when you
  351. want to send a fax. Fax Auto-Answer may be left on all the time, started
  352. only when you are expecting a fax, or not used at all.
  353.    If you want the fax-spooler to start when you boot up your system, you
  354. must add the line
  355.  
  356.  
  357. run >nil: <nil: AFAX:C/afaxspl
  358.  
  359.  
  360.    to your startup sequence. This can be done in the AFAX:s/AFaxAssign
  361. file, for example. Normally this would only be necessary if you send a lot
  362. of faxes with delayed spooling, and your computer may be rebooted often,
  363. as the spooler is automatically started when sending a fax.
  364.    If you want auto-answer with Fax detection running constantly in back-
  365. ground, you may either use the modified Getty command, or use faa di-
  366. rectly, by adding the line
  367.  
  368.  
  369. run >nil: <nil: faa
  370.  
  371.  
  372. somewhere in your startup sequence.
  373.    Note that the modified getty will allow you to receive data and fax calls
  374. effectively, and is the recommended approach. However if you only wish to
  375. receive faxes, faa is effective and may be started by double-clicking on the
  376. FaxAutoAnswer icon.
  377.  
  378.  
  379.  
  380. 2.3    Hardware
  381.  
  382.  
  383. The cable between your Amiga and Modem MUST connect CTS,RTS,
  384. DTR, DCD, TXD, RXD and GND conductors.  CTS and RTS are used
  385. for flow control handshaking. DTR is used to keep the modem on line -
  386. hangup occurs if it is dropped. DCD is used for carrier detection.
  387.  
  388.  
  389.                               6
  390. ^L
  391.  
  392.  
  393.  
  394.  
  395. TXD    2     Transmit Data
  396. RXD   3     Receive Data
  397. RTS    4     Request to Send
  398. CTS    5     Clear to Send
  399. GND   7     Signal Ground
  400. DCD   8     Data Carrier Detect
  401. DTR    20    Data Terminal Ready
  402.  
  403.  
  404.  
  405. 2.4    ARP
  406.  
  407.  
  408. If you have the ARP library installed (Libs:arp.library) the system will
  409. make use of it for file requesters.
  410.    Support for the ASL library under AmigaDOS2.0 has now been added
  411. to AmigaFax. It is used in preference to ARP.
  412.  
  413.  
  414.  
  415. 2.5    Extra FONTS
  416.  
  417.  
  418. Some extra fonts have been included in the FaxFonts directory. You may
  419. let the installation script copy them into your FONTS: directory, or under
  420. AmigaDOS2.0 you may copy them into another directory, and modify your
  421. startup to extend the FONT: assign to that directory. The extra fonts are
  422. from the Computer Modern series, as used with TEX.
  423.  
  424.  
  425.  
  426. 2.6    Printer Setup
  427.  
  428.  
  429. AmigaFax currently uses the standard printer driver, as configured in Pref-
  430. erences.  A future update may allow you to override the default settings
  431. via the configuration file. Using a dot-matrix printer, Halftone Dithering,
  432. Integer Scaling, Black and White, Density 7 appears to work reasonably
  433. well.
  434.  
  435.  
  436.  
  437. 2.7    Configuring for Hardware and User Pref-
  438.  
  439.        erences
  440.  
  441.  
  442. You will need to modify the file FAXLIB:Config to suit your specific hard-
  443. ware and preferences. See Chapter 3 for details on how to do this.
  444.  
  445.  
  446.  
  447.                              7
  448. ^L
  449.  
  450.  
  451.  
  452.  
  453. 8
  454. ^L
  455.  
  456.  
  457.  
  458.  
  459. Chapter  3
  460.  
  461.  
  462.  
  463. Configuring  the  System
  464.  
  465.  
  466.  
  467. The file FAXLIB:Config is used to configure the basic operation of Ami-
  468. gaFax to suit your particular hardware and preferences.  You must edit
  469. this file carefully, using a text editor.  You should always keep a backup
  470. copy of this file. The configuration options are continually being added to
  471. as AmigaFax grows, so if you are upgrading you should look at the latest
  472. copy. This will NOT overwrite your existing configuration as part of the
  473. installation process.
  474.    From version 1.30, AmigaFax configuration can be done using local or
  475. global environmental variables. This will override the values read in from
  476. the FAXLIB:Config file. For example typing from the CLI/Shell
  477.  
  478. SetEnv LocalID +61-52-786355
  479.  
  480. will override the LocalID string with the new number.
  481.  
  482.  
  483.  
  484. 3.1    General Configuration
  485.  
  486.  
  487.    o Debug
  488.      Debug level, 0-9.  Takes one numeric argument.  Useful for fault-
  489.      finding, observing handshake between the Amiga and your FaxMo-
  490.      dem.
  491.  
  492.    o LogFile
  493.      Specifies the file for logging debug and error information. If not given,
  494.      information will not be logged.
  495.  
  496.    o LocalID
  497.      The rest of the line is used as the local identifier string, which is
  498.  
  499.  
  500.                              9
  501. ^L
  502.  
  503.  
  504.  
  505.  
  506.      passed to the remote fax machine. This is usually your fax number,
  507.      and is limited to 20 characters.
  508.  
  509.  
  510.    o Device
  511.      The device to use for connecting to the modem, usually serial.device
  512.      (default). This should only be changed if using a different serial de-
  513.      vice, as with a third-party serial hardware.
  514.  
  515.  
  516.    o Unit
  517.      Takes one numeric parameter as the unit number to use on the given
  518.      device. Default is 0. For example when using the first port on the
  519.      A2232 multi-serial, set this to 2.
  520.  
  521.  
  522.  
  523. 3.2    AmigaFax User Interface
  524.  
  525.  
  526. These items are used by the afax program.
  527.  
  528.  
  529.    o Editor
  530.      The name of the your prefered text editor, for example TxEd, ced,
  531.      memacs, dme, mg, or Ed (default). I use mg (MicroGnuEmacs).
  532.  
  533.  
  534.    o ILBMEditor
  535.      The editor you prefer for editing IFF ILBM graphics, for example
  536.      dpaint.
  537.  
  538.  
  539.    o Template
  540.      The name of a file to use as a template for building fax documents, If
  541.      given, the editor will be given a copy of this file to work on when you
  542.      ask for a new fax file. This may include references to your address,
  543.      your signature, etc.
  544.  
  545.  
  546.  
  547. 3.3    Fax Page Layout Options
  548.  
  549.  
  550. These items are used by the mkafax program.
  551.  
  552.  
  553.    o DefaultFont
  554.      This is the default font, used for normal text unless otherwise spec-
  555.      ified.  It takes two parameters, the font name, and size.  The font
  556.      cmtt10 41 looks quite good for standard text.
  557.  
  558.  
  559.    o HeaderFont
  560.      This is the font used for page headers.
  561.  
  562.  
  563.                              10
  564. ^L
  565.  
  566.  
  567.  
  568.  
  569.    o PHeader
  570.      If given, a header will be printed on each fax page, and the rest of
  571.      the line used as the main text, along with the date, local ID string,
  572.      and page number. If not given, no header will be printed.
  573.  
  574.    o LeftIndent
  575.      The left indentation (border) to be used, in pixels. Many fax machines
  576.      will not print to the full fax width, and typically an indentation of
  577.      at least 50 pixels (approx 1/4 inch) on each size is required to avoid
  578.      losing characters.
  579.  
  580.    o RightIndent
  581.      The right indentation (border) to be used, in pixels.
  582.  
  583.  
  584.  
  585. 3.4    Fax Viewer Configuration
  586.  
  587.  
  588. These items are used by the viewafax program.
  589.  
  590.    o ViewScale
  591.      Takes one numeric argument, 1-8. This is the default scale used by
  592.      the fax viewer when it starts up. A value of three allows a standard
  593.      fax to fit across the screen. A scale of 1 shows maximum detail.
  594.  
  595.  
  596.  
  597. 3.5    Fax Printer Configuration
  598.  
  599.  
  600. These items are used by the afaxprt program.
  601.  
  602.    o MinLines
  603.      Takes one numeric argument. This is the minimum number of lines
  604.      that must be on a fax page before we print it. The default value is
  605.      0 (zero), meaning print all pages. This is for cut-sheet feeders (Laser
  606.      Printers), where the fax may be just a little longer than one page.
  607.      Use a value of around 100 here to stop getting `blank pages' printed
  608.      out.
  609.      1.32 and later MinLines is now used to scale a fax page to fit on a
  610.      printer page. If the fax page is longer then the printer page by less
  611.      than MinLines, it will be scaled to fit. A value of around 500 works
  612.      for most faxes.
  613.  
  614.  
  615.  
  616. 3.6    Fax Spooler Configuration
  617.  
  618.  
  619. These items are used by the afaxspl program.
  620.  
  621.  
  622.                              11
  623. ^L
  624.  
  625.  
  626.  
  627.  
  628.    o SpoolInterval
  629.      This is the time interval, in minutes, at which the outbound fax queue
  630.      is scanned for untransmitted files.
  631.  
  632.  
  633.  
  634. 3.7    Fax Receiver Configuration
  635.  
  636.  
  637. These items are used by the faa program.
  638.  
  639.    o RSetup
  640.      The receive setup string. This optional string is sent to the modem.
  641.      Unlike versions before 1.23, the string is NOT preceded by AT. In-
  642.      stead, the line is sent as it appears. This allows multiple commands
  643.      to be sent when initializing the modem. This allows you to add com-
  644.      mands to set such things as speaker use and volume.
  645.  
  646.    o RStatus
  647.      Receive Status. If present, a status window will pop up when a fax is
  648.      being received, showing various details such as name, connect speed,
  649.      transmitter ID, amount of data received. It takes two optional nu-
  650.      meric parameters, which are used for the top and left edge pixel po-
  651.      sitions to place the window.
  652.  
  653.    o DLEmode
  654.      There are many incompatible modems and modem ROM revisions
  655.      about.  This allows you to specify certain things about how your
  656.      FaxModem sends your data. It currently takes one numeric argument,
  657.      (0, 1 or 3).
  658.  
  659.        - 0
  660.          (default) treat DLE in received data as escape (Maestro 3.1,
  661.          ZyXEL 3.99+)
  662.  
  663.        - 1
  664.          Received DLE is g3 data (ZyXEL Vn3.90, Supra?)
  665.  
  666.        - 3
  667.          RAW input mode. Data is saved raw. For debug only.
  668.  
  669.  
  670.  
  671. 3.8    Fax Transmitter Configuration
  672.  
  673.  
  674. These items are used by the afaxsend program.
  675.  
  676.  
  677.    o WSetup
  678.      The transmit setup string. This optional string is sent to the modem.
  679.  
  680.  
  681.                              12
  682. ^L
  683.  
  684.  
  685.  
  686.  
  687.      As in the RSetup line, the line is sent to the modem as it appears
  688.      (since 1.23). This allows you to add commands to set such things as
  689.      speaker use and volume.
  690.  
  691.    o DialType
  692.      Takes the parameters Pulse (default) or Tone.
  693.  
  694.    o DialPrefix
  695.      Prefix to add before number when dialling. I use it to get an outside
  696.      line (dials 0 first), by setting it to ATDP0,DT, which will pulse-dial
  697.      0, then tone-dial the rest of the number.
  698.  
  699.    o DoPadding
  700.      This should not be necessary. However, some FaxModems to not ob-
  701.      serve the minimum scan-time restrictions set by the standard. When
  702.      connecting to slower fax machines, this may result in missed scan-
  703.      lines. Note that if you set this parameter, it will usually result in fax
  704.      transmissions taking longer, as worst-case padding must be added.
  705.  
  706.    o WStatus
  707.      Write Status.  If present, a status window will pop up when a fax
  708.      is being transmitted, showing various details such as name, connect
  709.      speed, receiver ID, percent of file sent. It takes two optional numeric
  710.      parameters, which are used for the top and left edge pixel positions
  711.      to place the window.
  712.  
  713.  
  714.  
  715. 3.9    Modem Command and Status Strings
  716.  
  717.  
  718. Certain modem commands and status codes have now been made variable.
  719. The variables default to their own value, and may be set in the Config file,
  720. or as environment variables.
  721.  
  722. eg setenv +FLID +FLI
  723.  
  724. will result in the string +FLI rather than +FLID being used for setting the
  725. local ID code.
  726.    Variables are:
  727.  
  728.  
  729.    o Status
  730.  
  731.        - +FCON
  732.          Fax connect established
  733.  
  734.        - +FCSI
  735.          Called station identifier follows
  736.  
  737.  
  738.                              13
  739. ^L
  740.  
  741.  
  742.  
  743.  
  744.     - +FTSI
  745.       Transmitting station identifier follows
  746.  
  747.     - +FDCS
  748.       Current session parameters follow
  749.  
  750.     - +FK
  751.  
  752.  
  753.  
  754.     - +FPTS
  755.  
  756.  
  757.  
  758.     - +FHNG
  759.       Fax hangup (terminal)
  760.  
  761. o Command
  762.  
  763.     - +FDT
  764.       Fax Data Transmit (I am about to transmit)
  765.  
  766.     - +FDR
  767.       Fax Data Receive
  768.  
  769.     - +FLID
  770.       Local ID string follows
  771.  
  772. o Dual Use
  773.  
  774.     - +FET
  775.       Fax End of Transmission (Followed by status code)
  776.  
  777.     - +FDIS
  778.       Constrain session parameters
  779.  
  780.  
  781.  
  782.                           14
  783. ^L
  784.  
  785.  
  786.  
  787.  
  788. Chapter  4
  789.  
  790.  
  791.  
  792. The  Workbench  Interface
  793.  
  794.  
  795.  
  796. Once configured, AmigaFax may be operated either from a Shell or CLI
  797. (Command Line Interface), or from the Workbench. If you choose to op-
  798. erate from the Workbench, you will find three main icons, `AmigaFax',
  799. `FaxAutoAnswer' and `FaxSpool'.
  800.  
  801.  
  802.  
  803. 4.1    AmigaFax
  804.  
  805.  
  806. When you double-click on the `AmigaFax' icon, the main AmigaFax con-
  807. trol window will open.  This allows you to edit, compile and view faxes,
  808. queue them for transmission, review previously queued transmissions, and
  809. so forth. There are currently six string gadgets, six pushbutton gadgets,
  810. and one toggle gadget on the control window.
  811.    The gadget functions are:
  812.  
  813.  
  814.    o FINE/STD
  815.      This toggle gadget allows the user to toggle between Fine (200 DPI)
  816.      and Standard (100 DPI) vertical resolution, when creating AFax files.
  817.      Standard resolution takes half the space, and half the time to trans-
  818.      mit, of Fine mode, but Fine looks MUCH nicer !!
  819.  
  820.    o To:
  821.      This is the intended recipient of the Fax.  It may be just a phone
  822.      number, or it may be an alias. When you enter a string and press
  823.      return, if the first character is a digit it will be treated as a number,
  824.      otherwise it will be checked for aliases. If no aliases are found, the
  825.      string is removed, otherwise the number of aliases found is shown.
  826.      Refer to section A.1 for more information on aliases.
  827.  
  828.  
  829.                              15
  830. ^L
  831.  
  832.  
  833.  
  834.  
  835. o From:
  836.   This is picked up from the LocalID field in your Config file, if present.
  837.   You may override this value. It is a 20 character string sent to the
  838.   remote Fax to identify you as the sender, usually your phone number
  839.   for return faxes.
  840.  
  841. o Source:
  842.   This is the name of the fax source document, usually an AmigaFax
  843.   command (.FCOM) file, although plain text or ILBM files may also be
  844.   used. If you press return with an empty string, and ARP is installed,
  845.   a requester will prompt you for a filename.
  846.  
  847. o AFAX:
  848.   This is the name for the actual fax file. The system will usually pick a
  849.   name for you, but you may wish to override it. Note that the AFAX
  850.   file name will be reserved, but not actually created, until time to send
  851.   the Fax. You may force creation with the "Make" gadget if you wish
  852.   to test that it is created correctly. If a document is to be faxed to
  853.   multiple recipients, only one copy of the AFAX file will be made. It
  854.   is automatically deleted when all recipients have been reached.
  855.  
  856. o Tries:
  857.   The maximum number of times to try to get a fax through to a
  858.   specific recipient if problems are encountered, such as remote phone
  859.   being engaged. Defaults to three.
  860.  
  861. o Time:
  862.   The Fax will not be sent until after this time. An empty field means
  863.   send at any time.  Fill in as hh:mm, (24 hour format) then press
  864.   return.  The system will interpret the time, and display the result.
  865.   Time can only be in the future, past time is rounded up by a day.
  866.  
  867. o New
  868.   Create a new Fax document, and edit it using your configuration
  869.   editor. The file pointed to by the configuration entry "Template" will
  870.   be used as a fax pro-forma. The system will pick a default document
  871.   name for you, which you may keep or override.
  872.  
  873. o Edit
  874.   Edit a Fax document, using your configuration editor. Note that you
  875.   may set both a text and a graphic editor in your config file.
  876.  
  877. o Make
  878.   The system will attempt to build an AFAX file from your source
  879.  
  880.  
  881.                           16
  882. ^L
  883.  
  884.  
  885.  
  886.  
  887.      document. This is not necessary when sending faxes, but does allow
  888.      you to check whether the document will appear as you wish.
  889.  
  890.    o Preview
  891.      Invokes the AFAX viewer program, so you can preview the completed
  892.      document.
  893.  
  894.    o Send
  895.      Your facsimile document will be queued for sending to the appropriate
  896.      recipients. If the fax-spooler is not running, you will be asked if you
  897.      wish to start it.
  898.  
  899.    o QCheck
  900.      This gadget will bring up the queue check window, to monitor the
  901.      progress of outgoing Faxes. From here it is possible to requeue Faxes
  902.      that have exceeded their error allowance, and to remove the spool files
  903.      for faxes that have been successfully sent, or that are still queued for
  904.      transmission.
  905.  
  906.  
  907.  
  908. 4.2    FaxAutoAnswer
  909.  
  910.  
  911. This icon will activate the background automatic-answer facility.  If it is
  912. already operating, you will get the choice of removing the existing applica-
  913. tion (stopping it), or replacing it with the new version. You may wish to
  914. replace it if you have modified the configuration file settings.
  915.    Note that you should only activate the auto-answer system in this fash-
  916. ion if you are not using the GETTY mode of operation, and only want to
  917. receive facimile transmissions, not data.
  918.  
  919.  
  920.  
  921. 4.3    FaxSpool
  922.  
  923.  
  924. This icon will activate the background fax-spooler program. If it is already
  925. operating, you will get the choice of removing the existing application (stop-
  926. ping it), or replacing it with the new version. Note that in normal operation
  927. the main AmigaFax program will start the spooler for you when you queue
  928. a fax for transmission, or you will run it up automatically in your startup
  929. sequence. You may wish to replace it if you have modified the configuration
  930. file settings.
  931.  
  932.  
  933.  
  934.                              17
  935. ^L
  936.  
  937.  
  938.  
  939.  
  940. 18
  941. ^L
  942.  
  943.  
  944.  
  945.  
  946. Chapter  5
  947.  
  948.  
  949.  
  950. Operating  from  the  Shell
  951.  
  952.  
  953.  
  954. There are 11 separate executable modules included in the release.
  955.  
  956.  
  957.    o afax
  958.      Intuitionized interface for AFAX create/edit/send etc
  959.  
  960.  
  961.    o newfax
  962.      Notifies new fax received, allows print/view/delete, etc [Intuitionized
  963.      interface]
  964.  
  965.  
  966.    o afaxspl
  967.      Fax spooler daemon, many options/features
  968.  
  969.  
  970.    o mkafax
  971.      Convert documents to AmigaFax AFAX IFF file format
  972.  
  973.  
  974.    o afaxprt
  975.      Print and AmigaFax AFAX IFF file using preferences printer
  976.  
  977.  
  978.    o afaxsend
  979.      Send an AmigaFax AFAX IFF file to a remote Fax machine
  980.  
  981.  
  982.    o faa
  983.      Receive Fax documents in auto-answer mode
  984.  
  985.  
  986.    o afaxilbm
  987.      Convert pages from an AmigaFax AFAX IFF file to ILBM format
  988.  
  989.  
  990.    o viewafax
  991.      FAX viewer
  992.  
  993.  
  994.                              19
  995. ^L
  996.  
  997.  
  998.  
  999.  
  1000.    o fxfx
  1001.      Manipulates fax files
  1002.  
  1003.  
  1004.    o dvifax
  1005.      Converts TEX.dvi file to fax format (Registered version only)
  1006.  
  1007.  
  1008.  
  1009. 5.1    AFAX
  1010.  
  1011.  
  1012. AFAX:c/afax - no command line switches at present. This brings up a win-
  1013. dow which you can use to create new Fax documents, edit the documents,
  1014. create the actual AFAX files, and send your faxes.
  1015.  
  1016.  
  1017.  
  1018. 5.2    NEWFAX
  1019.  
  1020.  
  1021. AFAX:C/newfax faxname This program is automatically invoked by faa
  1022. when a fax is received.  It puts up a window informing you of the Fax,
  1023. with details about it (name, sender ID, number of pages), and allows you
  1024. to view, print or delete the document.
  1025.  
  1026.  
  1027.  
  1028. 5.3    AFAXSPL
  1029.  
  1030.  
  1031. [run >nil: <nil:] afax:c/afaxspl  [-s] [-i n]
  1032.  
  1033.  
  1034.  
  1035.    With the -S option, the spooler will run once only, checking for any
  1036. faxes waiting to be spooled out. In this mode, it could be launched using
  1037. cron/dcron/amicron at whatever times you wish to send faxes.
  1038.    Otherwise it will run in background and check for faxes to spool at in-
  1039. tervals of every n minutes, where n is the interval in minutes from the con-
  1040. figuration file default, optionally overridden by the -i command-line switch.
  1041. You could do this perhaps every 1/2 hour, (n = 30), or even at 1 minute
  1042. intervals while testing.
  1043.    The spooler checks for files of the form FAXSPOOL:*.SPL. These are
  1044. human-readable. As calls progress, results are added to the end of the file. If
  1045. successfully sent, the file is renamed FAXSPOOL:*.OK . If unsuccessful for
  1046. more than the specified number of tries, it is renamed FAXSPOOL:*.ERR
  1047. . Note that you can re-spool a .ERR file by using an editor to increase the
  1048. allowed tries, then renaming it back to .SPL .
  1049.  
  1050.  
  1051.                              20
  1052. ^L
  1053.  
  1054.  
  1055.  
  1056.  
  1057. 5.4    MKAFAX
  1058.  
  1059.  
  1060. mkafax <docfilename> <AFAX_filename>
  1061.  
  1062.  
  1063.    mkafax currently recognizes the IFF file types AFAX and ILBM, plain
  1064. text files, and AFAX command text files, as input.
  1065.    A plain text file will be converted to an AFAX file using default settings.
  1066.    An IFF ILBM will be converted to a single-page FAX document. Only
  1067. the first plane is converted, to convert multi-plane (eg DigiView Pics) use
  1068. another tool, such as PfiltView (AmigaTeX). May integrate later ?
  1069.    An AFAX command file uses lines starting with a dot (.)  as special
  1070. commands, similar to TROFF style text processors. The file MUST start
  1071. with .FCOM on the first line.
  1072.  
  1073.  
  1074.  
  1075. 5.5    AmigaFax Command File Format
  1076.  
  1077.  
  1078. An AFAX command file uses lines starting with a dot (.) as special com-
  1079. mands, similar to TROFF style text processors. The file MUST start with
  1080. .FCOM on the first line.
  1081.  
  1082.  
  1083.  .FCOM
  1084. on the first line to be recognised as a command file.
  1085. .FCOM may optionally be followed by a dialstring or target alias.
  1086. (Currently unused, future compatability)
  1087.  
  1088.  
  1089. Other commands currently supported are :
  1090.  
  1091.  
  1092.  .PG Clear out the old page and start a new one
  1093.  .LM n Set the left margin to n characters, in the current font
  1094.  .LI n Set the left  indentation to n pixels (default 50)
  1095.  .RI n Set the right indentation to n pixels (default 50)
  1096.  .LJ Left-justify text and Graphics from now on
  1097.  .RJ Right Justify text and Graphics
  1098.  .CT Center Text and Graphics
  1099.  .TS n Set Tabs every n characters (default 8)
  1100.  .PL n Set page length to n (pixel) rows (default 2292 == A4)
  1101.  .FILL Turn on fill mode
  1102.  .NOFILL Turn off fill mode
  1103.  
  1104.  
  1105.  .VERBATIM
  1106. All text read in will be printed verbatim, until .ENDVERB
  1107.  
  1108.  
  1109.  
  1110.                              21
  1111. ^L
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  .VERBINC filename
  1117. Include a file in verbatim mode. Still requires a .ENDVERB
  1118.  
  1119.  
  1120.  .ENDVERB
  1121. End verbatim mode
  1122.  
  1123.  
  1124.  .FONT name size [styles]
  1125. Set the font as specified. Typical use might be
  1126. .FONT topaz 11
  1127. .FONT diamond 20
  1128. .FONT cmr10 30
  1129. and so on. See the .STYLE command for style options.
  1130.  
  1131.  
  1132.  .ENDF pop the current font/style, and return to the previous one.
  1133.  
  1134.  
  1135.  .STYLE styles
  1136. Set the style according to the style string,
  1137. N - Normal
  1138. B - Bold
  1139. U - Underlined
  1140. I - Italics
  1141. E - Extended
  1142. eg .STYLE BU (set to bold, underlined)
  1143.  
  1144.  
  1145.  .  (dot followed by white-space) Rest of line is a comment
  1146.  
  1147.  
  1148.  .INC file
  1149. Include the named file. File may be text, ILBM, or another command
  1150. file. Type is auto-recognised. If a full path is not given to the
  1151. include file, the current directory will be searched, then the
  1152. FAXLIB: directory. Thus addresses, signatures, etc may be kept
  1153. in FAXLIB:
  1154.  
  1155.  
  1156. From version 1.34, you may also .INC an AFAX format file. At
  1157. present only one page is included, by default the first page.
  1158. Page number can be specified by an optional parameter, eg
  1159. .INC FAXREC:Fax0001 2
  1160. At present only 1 page from an AFAX file can be included for each .INC
  1161. command, and no data after that page will appear on the page it is
  1162. included on. Text/graphics can be included before the included fax
  1163. page, so you could use this, for example, to automatically add some
  1164. header text to a received fax before relaying it on.
  1165.  
  1166.  
  1167.                              22
  1168. ^L
  1169.  
  1170.  
  1171.  
  1172.  
  1173. Note that at present, normal page-length checking is NOT done while
  1174. processing the included fax page, so you may get a longer than
  1175. expected page.
  1176.  
  1177.  
  1178.  .DATE Insert a line with the current date and time, using current font
  1179. and line settings.
  1180.  
  1181.  
  1182.  
  1183.    Any line not beginning with a . will be processed as normal text, ac-
  1184. cording to the current settings.
  1185.  
  1186.  
  1187.  
  1188. 5.5.1   Fill Mode
  1189.  
  1190. In this mode, lines will be filled from input to full width (inside LR indent)
  1191. in the current font. Line filling terminates on a dot command, blank line,
  1192. or end of page. Left Margin is disabled while filling.
  1193.    See the included test.com file for examples of useage.
  1194.  
  1195.  
  1196.  
  1197. 5.5.2   Stackable fonts and Style support
  1198.  
  1199. Starting at version 1.34, mkafax supports stackable fonts, and the use of
  1200. styles, such as Bold, Italic and Underline_.
  1201.    Useage of the command .FONT has been extended, and the commands
  1202. .STYLE and .ENDF have been added.
  1203.    The font system has been modified so that fonts are now nestable. This
  1204. means you can set a font/style, and then return to the original font/style,
  1205. without needing to know what that was. This can be very useful for include
  1206. files, which can return to the original font before they exit, for example.
  1207.    The .FONT command now takes an optional third parameter, which
  1208. defines the requested style to use. This takes the form of a string, consisting
  1209. of the letters N, B, U, I and E in any order, upper or lower case.
  1210.  
  1211.  
  1212. N - Normal
  1213. B - Bold
  1214. U - Underlined
  1215. I - Italics
  1216. E - Extended
  1217.  
  1218.  
  1219.    Note that the letters are parsed in order, and that N will clear the other
  1220. flags and set the font back to normal. For example,
  1221.  
  1222.  
  1223. .FONT topaz 30 BU
  1224.  
  1225.  
  1226.                              23
  1227. ^L
  1228.  
  1229.  
  1230.  
  1231.  
  1232. will set the font to topaz 30, Bold and Underlined.
  1233.  
  1234.  
  1235. .FONT CGTimes 50 I
  1236.  
  1237.  
  1238. set CGTimes at 50-point, Italic.
  1239.    You can retain the existing font, but change its style, by using the new
  1240. .STYLE command.
  1241.  
  1242.  
  1243. .STYLE U
  1244.  
  1245.  
  1246. This is Underlined.
  1247.  
  1248.  
  1249. .STYLE IU
  1250.  
  1251.  
  1252. This is Underlined and Italic.
  1253.  
  1254.  
  1255.    All .FONT and .STYLE commands can now be nested. This means that
  1256. the font/style you set will remain in effect until the new command .ENDF
  1257. is encountered. After this the previous font/style set will be in force. The
  1258. Default font, which can be set from your FAXLIB:Config file or by environ-
  1259. mental variable, is always the underlying font. No matter how many .ENDF
  1260. commands you enter, this will not be popped from the font stack.
  1261.    Note that if you have defined a Header font, this will be automatically
  1262. pushed for headers, and popped afterwards.
  1263.  
  1264.  
  1265. Example .FCOM file:
  1266.  
  1267.  
  1268. .FCOM
  1269. This is in default font
  1270. .FONT CGTimes 30 U
  1271. This is in Underlined 30 point CGTimes
  1272. .FONT topaz 20 B
  1273. This is in Bold 20 point topaz
  1274. .STYLE NIU
  1275. And this is Italic Underlined 20 point topaz
  1276. .ENDF
  1277. Bold 20 point topaz
  1278. .ENDF
  1279. Underlined 30 point CGTimes
  1280. .ENDF
  1281. Default font
  1282. .ENDF
  1283. Default font
  1284.  
  1285.  
  1286.                              24
  1287. ^L
  1288.  
  1289.  
  1290.  
  1291.  
  1292. 5.6    AFAXSEND
  1293.  
  1294.  
  1295. afaxsend [-t -d -P] <dialstring _ alias> <AFAX_filename>
  1296.  
  1297.  
  1298.    eg afaxsend Jeff MyFaxFile
  1299.  
  1300.  
  1301.  
  1302. -D name - Use name for the device  (default serial.device)
  1303. -U num - Use device unit num  (default 0)
  1304. -t  - Use Tone Dialing
  1305. -P - Padding on (default)
  1306. -p - Padding off
  1307.  
  1308.  
  1309.  
  1310.    Attempts to dial out, connect to the remote fax machine, and tranfer
  1311. the specified document.
  1312.    If the first character of dialstring is not a digit, and not a name alias,
  1313. the whole string will we be sent to the modem non-prefixed as a dial string.
  1314. If an alias is used, it may be a group alias, resulting in the fax being sent
  1315. to everyone in that group.
  1316.  
  1317.  
  1318.  
  1319. 5.7    AFAXPRT
  1320.  
  1321.  
  1322. afaxprt [-pnum] [-n] [-dn]<AFAX_filename>
  1323.  
  1324.  
  1325.    eg afaxprt -p2 MyFaxFile
  1326.    If the -p option is not used, all pages are printed.
  1327.    The -n option does not actually send the data to the printer.  Useful
  1328. with the debug option -d.
  1329.    Sends the AmigaFax document to the preferences printer. It is a good
  1330. idea to set your printer for high density.  Using a dot-matrix, Halftone
  1331. Dithering, Integer Scaling, Black and White, Density 7 appears to work ok.
  1332.    Note that this has not been extensively tested with printers other than
  1333. the HPLJIII and the Star NX10.
  1334.  
  1335.  
  1336.  
  1337. 5.8    FAA
  1338.  
  1339.  
  1340. faa [BaseName]
  1341.    Fax auto-answer. Sets up the FaxModem to auto-answer and recognise
  1342. Fax or data tranmissions. Incoming Faxes will be saved in AFAX format.
  1343. the default BaseName is FAXREC:FAX, so that incoming faxes will be
  1344. named
  1345.  
  1346.  
  1347.                              25
  1348. ^L
  1349.  
  1350.  
  1351.  
  1352.  
  1353. FAXREC:FAX0000
  1354. FAXREC:FAX0001
  1355. FAXREC:FAX0002
  1356.  
  1357.    etc.
  1358.    Note also that although faa recognises the difference between Fax and
  1359. Data, it currently does nothing special with data. I hope to integrate this
  1360. with the UUCP system in the future. Any other suggestion ?
  1361.    To terminate the faa program, send it a CTL_C break.  If you ran it
  1362. directly from your shell, just type control-C and wait. If you used RUN or
  1363. RUNBACK, send a break to its process number. (eg break 7 all)
  1364.    Command Line switches are:
  1365.  
  1366. -dn - Set debug on, level n  (default 1)
  1367. -D name - Use name for the device  (default serial.device)
  1368. -U num - Use device unit num  (default 0)
  1369. -a - Immediate Answer
  1370. -G - Run from a Getty
  1371. -z - Diagnostic, do not detach, so debug messages can be read
  1372.  
  1373.    The Immediate Answer switch assumes phone is ringing, configures the
  1374. modem & answers immediately. It probably makes sense to attach this to
  1375. an alias if you use it this way. eg. alias fa "faa -a"
  1376.    The Getty option specifies that faa was run from a Getty. It will not
  1377. modify the serial port parameters. It assumes that the Getty has answered
  1378. the phone, detected a Fax call, and set up the line accordingly. Faa will
  1379. connect, collect a Fax document, and return control to the Getty.
  1380.  
  1381.  
  1382.  
  1383. 5.9    AFAXILBM
  1384.  
  1385.  
  1386. afaxilbm [-pnum] <AFAX_filename> <ILBM_filename>
  1387.  
  1388.  
  1389. eg
  1390.  
  1391.  
  1392. afaxilbm -p2 RAM:AFAXR001 FX.ILBM
  1393.  
  1394.  
  1395.    This will extract the specified page from the AFAX file to the named
  1396. ILBM file. It may then be viewed using standard ILBM viewing programs,
  1397. such as LoadImage from Fish disks 281 and 355, of programs like Deluxe-
  1398. Paint.
  1399.    If no page number is given, all pages will be extracted to separate files,
  1400. and given names of the format base.1 base.2, etc
  1401.    The default ILBM file base name is afax_ilbm
  1402.  
  1403.  
  1404.                              26
  1405. ^L
  1406.  
  1407.  
  1408.  
  1409.  
  1410. 5.10    VIEWAFAX
  1411.  
  1412.  
  1413. viewafax [opts] <FaxFile>
  1414.  
  1415. The fax viewer is normally started automatically by from the NewFax win-
  1416. dow. When invoked from the CLI, it takes the options:
  1417.  
  1418. -d debug_level
  1419. -p Page_Number
  1420. -s Scale
  1421.  
  1422.    The current version of the viewer keeps one entire fax page in memory.
  1423. If the page will not fit in the requested scale, it tries to reduce the resolut*
  1424.  *ion
  1425. until it finds one that will fit. Once a page is displayed, you can move about
  1426. the page using the arrow keys. There is a scale gadget at the top left of
  1427. the window, in the form of 1:n, where n is the current scale (say 3). You
  1428. can click on the gadget, delete the current scale, and enter your own, in the
  1429. range 1 to 8, where 1 is 1:1 (full size), 2 is 1:2 (half size) etc. To the right
  1430. of that gadget is another of the form Page: n where n is the current page
  1431. displayed. Again you may enter the required page number in this gadget.
  1432.    To the top right of the window is a group of gadgets of the form | <<
  1433. -- >> |. These are actually four gadgets, which allow moving through
  1434. the pages of the fax. From left to right they are First Page, Previous Page,
  1435. Next Page, and Last Page.
  1436.    You may use the windows sizing gadget to resize the window. However
  1437. with the current viewer, sizing the window larger than the fax page will
  1438. result in the window shrinking to the page size at the next movement.
  1439.    Several keys are active in the viewer window.
  1440.  
  1441.    o Down Arrow (Cursor Key or Numeric Pad)
  1442.      Move window down fax page.
  1443.  
  1444.    o Up Arrow (Cursor Key or Numeric Pad)
  1445.      Move window up fax page.
  1446.  
  1447.    o Right Arrow (Cursor Key or Numeric Pad)
  1448.      Move window right on fax page.
  1449.  
  1450.    o Left Arrow (Cursor Key or Numeric Pad)
  1451.      Move window left on fax page.
  1452.  
  1453.    o Numeric pad keys 1,3,7,9
  1454.      Diagonal window movement
  1455.  
  1456.    o i
  1457.      Flip fax page vertically. Useful when faxes are sent upside-down.
  1458.  
  1459.  
  1460.                              27
  1461. ^L
  1462.  
  1463.  
  1464.  
  1465.  
  1466.    o q
  1467.      Quit from viewer
  1468.  
  1469.  
  1470.    o b
  1471.      Move back on page in fax file
  1472.  
  1473.  
  1474.    o n
  1475.      Move to next page in fax file
  1476.  
  1477.  
  1478.    o f
  1479.      Move to first page in fax file
  1480.  
  1481.  
  1482.    o e
  1483.      Move to end page in fax file
  1484.  
  1485.  
  1486.    o s
  1487.      Make fax smaller - reduce scale one step
  1488.  
  1489.  
  1490.    o l
  1491.      Make fax larger - increase scale one step
  1492.  
  1493.  
  1494.  
  1495. 5.11     FXFX
  1496.  
  1497.  
  1498. This utility allows you to split and merge AFAX format fax files. A typical
  1499. use is where you have a complete fax document, perhaps generated by TeX-
  1500. >dvifax, or received as an AFAX fax-file and you want to sent it with an
  1501. attached cover page, or you want to extract one or more pages from the
  1502. document.
  1503.  
  1504.  
  1505. The command-line format is:
  1506.  
  1507.  
  1508. fxfx infile [-range] [infile[-range]] [...] outfile
  1509.  
  1510.  
  1511. Some examples:
  1512.  
  1513.  
  1514. fxfx file1 file2
  1515.  
  1516.  
  1517.  copies fax files file1 to file2
  1518.  
  1519.  
  1520. fxfx file1 file2 file3 file4
  1521.  
  1522.  
  1523.  merges all pages from file1-3 to create file4
  1524.  
  1525.  
  1526.  
  1527.                              28
  1528. ^L
  1529.  
  1530.  
  1531.  
  1532.  
  1533. fxfx file1 file2 -1,3,5-7,9- file3 -4 file4
  1534.  
  1535.  
  1536.  merges all pages from file1, pages 1,3,5-7 and 9 on from file2, and
  1537.  page 4 from file3, to create file4
  1538.  
  1539.  
  1540.  
  1541. The range is currently sorted, so to reverse page order is currently
  1542. not simple, eg
  1543.  
  1544.  
  1545. fxfx file1 -3 file1 -2 file1 -1 file2
  1546.  
  1547.  
  1548.  to create file2 from pages 1-3 of file1 in reverse order.
  1549.  
  1550.  
  1551.  
  1552. 5.12    DVIFAX
  1553.  
  1554.  
  1555. This module works with the AmigaTeX package from Radical Eye Software,
  1556. to enable you to convert a TEX.dvi file into an AmigaFax fax file.
  1557.    The command line syntax is
  1558.  
  1559. dvifax file.dvi -o file.afx
  1560.  
  1561.    You will be prompted for various size and scaling numbers.  You are
  1562. probably best to accept the default values (hit return) unless you have a
  1563. very good idea what you are doing.
  1564.    The Squeeze Fax option will remove all white-space from the top and
  1565. bottom of each page. This can result in significant savings in transmission
  1566. time, and in fax paper at the other end.
  1567.    When creating faxes with dvifax, you may want to add a cover page.
  1568. This can be done easily with the fxfx utility.
  1569.  
  1570.  
  1571.  
  1572.                              29
  1573. ^L
  1574.  
  1575.  
  1576.  
  1577.  
  1578. 30
  1579. ^L
  1580.  
  1581.  
  1582.  
  1583.  
  1584. Appendix  A
  1585.  
  1586.  
  1587.  
  1588. Configuration  Specifics
  1589.  
  1590.  
  1591.  
  1592. A.1     FAXLIB:Aliases
  1593.  
  1594.  
  1595. This file allows you to alias numbers to names, create fax mailing groups,
  1596. etc. Aliases may be defined in terms of other aliases.
  1597.    For example we could have:
  1598.  
  1599.  
  1600.  
  1601. joe: 1234596
  1602.  
  1603.  
  1604. fred: 9876123
  1605.  
  1606.  
  1607. bill: 0981234
  1608.  
  1609.  
  1610. andy: "0,123-4567,,,"
  1611.  
  1612.  
  1613. customers: joe, fred, bill
  1614.  
  1615.  
  1616.  
  1617.    Lines beginning with # are treated as comments, a comma means the
  1618. alias list continues.
  1619.    If you want to include spaces or commas in an alias (commas are a way of
  1620. inserting delays into a dial-string), you should surround the aliased number
  1621. with double quotes.  Adding coma-delays at the end of a dial string can
  1622. be useful when dialing numbers that take a long time to respond, avoiding
  1623. possible timeouts.
  1624.    The alias system is modelled closely on the one used in Matt Dillon's
  1625. UUCP package. See UUCP documentation for more details. Thanks, Matt.
  1626.  
  1627.  
  1628.                              31
  1629. ^L
  1630.  
  1631.  
  1632.  
  1633.  
  1634. A.2     FONTS
  1635.  
  1636.  
  1637. AmigaFax can use all the standard Amiga fonts. Under AmigaDOS2.0 the
  1638. ability to perform font-scaling means that you can generate quite impressive
  1639. documents very easily.
  1640.    The AmigaFax distribution also includes a selection of larger sized fonts
  1641. from the Computer Modern series, which again allows very high quality
  1642. faxes to be produced. These were generated from standard TEXfonts using
  1643. the TEXF program.  Note that these fonts do not contain the umlaut
  1644. characters commonly used in Europe.
  1645.    These include the fonts cmr10, cmbx10, cmssbx10 and cmtt10 in sizes
  1646. from 29 to 103.
  1647.    I would suggest that anyone using AmigaDOS 2.0 use the standard
  1648. Amiga fonts. Even Topaz scaled to 30 point size or greater comes out quite
  1649. effectively. Play around until you find a setup you like.
  1650.  
  1651.  
  1652.  
  1653.                              32
  1654. ^L
  1655.  
  1656.  
  1657.  
  1658.  
  1659. Appendix  B
  1660.  
  1661.  
  1662.  
  1663. Integration  with  other
  1664.  
  1665.  
  1666.  
  1667. software
  1668.  
  1669.  
  1670.  
  1671. B.1     UUCP
  1672.  
  1673.  
  1674. AmigaFax was designed from the beginning to integrate with UUCP, in
  1675. particular with Matt Dillon's AmigaUUCP1.15D. Using the modified Getty
  1676. program provided, a Fax call will be recognised, and the Fax auto-answer
  1677. program will be called to handle it. Normal logins and UUCP connections
  1678. should function as usual.
  1679.  
  1680.    Other facilities, such as network fax-server capability, can be provided
  1681. to enhance the basic AmigaFax system.
  1682.  
  1683.  
  1684.  
  1685. B.2     TEX
  1686.  
  1687.  
  1688. We have written a dvifax program, which will take a standard TEX .dvi
  1689. file, and transform it to an AmigaFax file, with superb quality output. This
  1690. is now provided with the distribution.
  1691.  
  1692.  
  1693.  
  1694. B.3     PostScript
  1695.  
  1696.  
  1697. PostScript support is not yet in place, but it is on the list. Priority given
  1698. depends on demand.
  1699.  
  1700.  
  1701.                              33
  1702. ^L
  1703.  
  1704.  
  1705.  
  1706.  
  1707. B.4     Printer Driver
  1708.  
  1709.  
  1710. An AmigaFax printer-driver is also high on the list of things to do. This
  1711. will allow any program that normally produces output using the standard
  1712. Amiga Preferences printer to produce AmigaFax files as output.
  1713.  
  1714.  
  1715.  
  1716. B.5     BBS Systems
  1717.  
  1718.  
  1719. The FifoBBS BBS system for VLT is no longer distributed with AmigaFax.
  1720. There several BBS systems that should work well alongside AmigaFax,
  1721. the one we are currently using at C-Born is TransAmiga. This is a freely
  1722. distributable shareware package which also supports FidoNet. It is available
  1723. from several sources, including Amiga ftp sites. See the file BBSREADME
  1724. in the distribution disk BBS directory for more details.
  1725.  
  1726.  
  1727.  
  1728.                              34
  1729. ^L
  1730.  
  1731.  
  1732.  
  1733.  
  1734. Appendix  C
  1735.  
  1736.  
  1737.  
  1738. FaxModem  Specifics
  1739.  
  1740.  
  1741.  
  1742. C.1     ZyXEL U-1496
  1743.  
  1744.  
  1745. The ZyXEL U-1496 provides data rates to v32bis and higher, with v42bis er-
  1746. ror correction and compression. It is capable of facsimile data rates greater
  1747. than 9600bps, currently up to 14400bps. ZeroOne makes ROM upgrades
  1748. available through their BBS, with frequent upgrades. They are very helpful
  1749. and responsive to customer requests.
  1750.    The latest ROM version we have used is V5.00.
  1751.    With this ROM, it is possible to lock the DCE/DTE data rate for fax
  1752. with the sequence ATS38=8S18=n, where n is the DTE speed as per the S20
  1753. register list, eg 2 for 38.4Kbps, 3 for 19.2Kbps.
  1754.    There is a Voice-mode ROM for the ZyXEL currently in Beta-test.
  1755. When this is released, we will try to integrate it with AmigaFax.  this
  1756. will allow you to send and receive voice messages, as well as fax and data
  1757. calls, all from your Amiga.
  1758.    A few more tips on configuration, with getty. In my standard startup
  1759. line I have been setting the page-length to A4, as my printer is A4, which
  1760. is the standard here. However, it appears that my fax (and most others)
  1761. when appending their header/footer lines, force the page past A4. This has
  1762. not been a problem in the past, but now the U1496 must be obeying the
  1763. page-length setting, and forces out an extra very short page for each A4
  1764. page. This causes handshake problems, etc.
  1765.    So for now, the best solution seems to be setting up for unlimited page-
  1766. length. The AmigaFax software has no problem with this, but your printer
  1767. may, if single-sheet type.
  1768.    Another option allows fax data-rates greater than 9600. Not many fax
  1769.  
  1770.  
  1771.                              35
  1772. ^L
  1773.  
  1774.  
  1775.  
  1776.  
  1777. machines support this yet, but we may as well use it, just in case.
  1778.  
  1779.  
  1780. The +FDCC options are as follows:
  1781.  
  1782.  
  1783. +FDCC=1,5,0,2
  1784.       ^ ^ ^ ^
  1785.       | | | +- Page Length: 0=A4(297mm) 1=B4(364mm) 2=unlimited
  1786.       | | +--- Page Width : 0=1728 Pixels in 215mm (Current AmigaFax Limit)
  1787.       | +----- Bit Rate   : 0=2400 1=4800 2=7200 3=9600 4=12000 5=14400
  1788.       +--------Vert. Res. : 0=Normal(98 lpi) 1=Fine(196 lpi)
  1789.  
  1790.  
  1791.  
  1792.    Other options cover compression format, error correction mode, binary
  1793. file transfer, and scan time.  These are not yet supported, probably not
  1794. until the standards are finalized.
  1795.    The line I use to start up Getty is:
  1796.  
  1797.  
  1798. RunBack Getty -Mh -B19200 -x8 -F6 AT&C1&D3+FDCC=1,5,0,2
  1799.  
  1800.  
  1801.    As I have the FaxModem running from a AS2232 multiport serial card,
  1802. with a maximum baud rate of 19200, I must limit the DCE/DTE rate to
  1803. that.
  1804.  
  1805.  
  1806.  
  1807. C.2     Maestro 9600XR
  1808.  
  1809.  
  1810. This is a low-cost Australian made 2400bps data, 9600bps send/receive fax
  1811. modem, based on the Exar chipset. It does not allow DCE/DTE rate lock-
  1812. ing, and as of the latest version ROMs we have, still has occasional problems
  1813. in correctly synchronising to incoming fax data, resulting in `garbage data'
  1814. faxes, and missing lines from the top of pages. These problems may have
  1815. been fixed in later ROM versions, but we have not been notified of any up-
  1816. grades. The modem software does not appear to observe specified line-scan
  1817. delays, which may result in missing lines when transmitting to older/slower
  1818. fax machines.
  1819.    A typical Getty startup-line for this modem is:
  1820.  
  1821. run >nil: <nil: Getty -Mh -B2400 -F AT&C1&D2+FDCC=1,3
  1822.  
  1823.  
  1824.  
  1825.                              36
  1826.