next up previous


text2g3 options

ex text2g3;'[-f fontfile] [-v] [-x] [-r res] [-o outdir] [-2]
            [-w N] [-h N] [-l N] [-m macrofile] [-u stemname]
            [-a name] [-M]
            file1 ... fileN'
where:
-f defines an alternative font file
-v invokes verbose mode
-x suppresses the c68 `Any key to exit' message
-o defines a device /directory for the G3 file. The default is ram2_.
-r defines the resolution, 0 for normal low res, 1 for fine high If you don't give this parameter, the value from qfax_dat is used.
-u defines the stem name for the output file.
ex text2g3;`-m macro_fred -u fred faxmerge_txt'
==> fred_fax_001
ex text2g3;`-m macro_bill -u bill faxmerge_txt'
==> bill_fax_001
-m defines a macro file
-2 use 2-D encoding.
-w defines the width (as CCITT code 0,1,2).
-h defines the width (as CCITT code 0,1,2).
-l defines the left margin in fax pixels.
-a Checks the name in QFAX_PHONE for encoding method (1 or 2D).
-M By default, text2g3 produces lsb format files (the default for Class 2 modems), -M forces MSB files.

file1 ...fileN defines the files to process, wildcards are supported. for example:

ex text2g3;`-r 0 -f flp1_qfax_font -o ram3_G3_ flp2_*_txt'
The output file has the extension _fax.
ex text2g3;`-r 0 -o ram3_G3_ flp2_test_txt'
gives a files ram3_G3_test_fax.

qfax options

ex qfax;'[-i ini] [-l logfile] [-v] [-x] [-eN] [-bN]
             [-s phone file | -S phone [file] | -z phone file]'
-v displays progress/debug information on the console (stderr device)
-l defines a log file for process/debug info.
-x suppresses the c68 `Any key to exit' message
-i defines additional Hayes commands to be sent before dialling. (appended to the INI string in the qfax_dat, so if this defines a command starting AT, you don't need another AT here).
-e qfax emits a status code when it terminates. If the transfer was successful, this will be 0, and on error, ERR_IU, ERR_FE, ERR_TE, ERR_BP or ERR_NF. You can use the -e option to change the error result code. For example, if you were invoking qfax from a QLIB program, you might want it to always return 0, regardless of status; in this case -e 0.
-b defines a maximum MODEM value for sending. If your respondent is using high speed modem on hardware that cannot cope, this will provide a "one-off" speed limit.
-s followed by phone number to dial. In a valid `Hayes' ATD format or NAME or ALIAS from QFAX_PHONE.
-S followed by phone number to POLL. In a valid `Hayes' ATD format or NAME or ALIAS from QFAX_PHONE.
-z followed by phone number to dial. In a valid `Hayes' ATD format or NAME or ALIAS from QFAX_PHONE. Uses stack supplied channels:
ex qfax,#serial_channel,#dontcare,#info;'-z etc'

file file to send to the phone number.

for example

ex qfax;'-v -l ram2_sfax_log -s 010-968-699407 ram2_jh_fax'
Send jh a fax, log information to screen and to ram2_sfax_log
ex qfax;'-i M1 -v -s graham  ram2_Graham_fax'

ex qfax;'[-p] [-v] [-x] [-l logfile] [-i ini] [-e N] [-P poll] -R'
ex qfax;'[-v] [-x] [-l logfile] [-i ini] [-e N] [-P poll] -r pattern'

          -v, -l, -x, -i, -e function as for send
-R receives using qfax file naming conventions.
-r pattern receives to pattern_001, pattern_002 etc
-p Print the fax on completion (after any move if VIA is defined) You must have defined PRINT = in qfax_dat and use -p to print.
-P defines the name of a fax file that you will transmit when polled.

Automatic Answer

Let the modem answer the phone after a given number of rings. qfax uses its internal file naming convention. qfax can either exit after a single fax, or continue to answer and receive until you RJOB it, or let qfax ask you want you want to do.

ex qfax;'[-p] [-v] [-x] [-l logfile] [-i ini] [-e N] [-P poll] -w 2'
ex qfax;'[-p] [-v] [-x] [-l logfile] [-i ini] [-e N] [-P poll] -W 3'
ex qfax;'[-p] [-v] [-x] [-l logfile] [-i ini] [-e N] [-P poll] -m 3'

where -v, -l, -x, -i, -e, -P function as above
-p Print the fax on completion (after any move if VIA is defined). You must have defined PRINT = in qfax_dat and use -p to print.
-w N answers after N rings (2 in the above example). Program terminates after receiving.
-W N answers after N rings (3 above), after receiving, the program waits for another call.
-m N answers after N rings (3 above), after receiving, the program waits for another call. You are asked if you want to answer as fax or voice. This is described below as Monitor mode.

Shared

In this mode qfax assumes that another program has answered the phone and issued a modem ATA command to go online. This parent program has then received a +FCON (Class Two FAX connect) message and forked (i.e. invoked using the equivalent of EX/EW) the qfax program. qfax may then be invoked in one of two modes.

-g When qfax is invoked -g. it assumes that the parent program has closed the serial port. qfax will open the serial port, perform fax specific initialisation and then receive the fax. After reception, qfax will close the serial port and exit, it supplies an exit status of 0 for success, non-zero on error.
ex qfax;'[-p] [-v] [-x] [-i ini] [-e N] [-l logfile0]
                                        [-P poll] -g'

where -v, -l, -x, -e, -i, -p, -P function as above
-G When qfax is invoked -G, it assumes that the parent has passed the open serial channel as standard QDOS stack channels, with an additional channel(s) for log messages. The stdin channel is the open serial channel, the stderr channel for verbose qfax messages, the stdout channel may be nul or a temporary (gash) file. qfax will not close the serial port on exit; but will honour exit baud settings and supplies an exit status of 0 for success, non-zero on error.

ew qfax,#c4,nul,#c1;[-p] [-v] [-x] [-i ini] [-e N] [-l log]
                                            [-P poll] -G
where -v, -l, -x, -e, -i, -p, -P function as above

open #4, 'ser2hr'
open #5, 'con'
 ...
ew qfax,#4,#5,nul;'-p -v -G'
 ...
close #4
close #5

qfv options

ex qfv;'[-X n][-m n] [-w xs] [-h ys] [-o dev] [-t name] [-p]
        [-q] [-b] [-g page] [-J|j jump] [-P eol]  [-l | file_name]'

-x Limit the memory allocation to a size defined by 'n' Normally, qfv will try to allocate memory based on the fax page requirements.
-m n Startup magnification level
-w xs Window x-size
-h ys Window y-size
-i dir Set input directory (if no file given)
-q Queries ESC exits (but not HIT/DO on exit button)
-o dev defines print device
-t name defines printer name
-b suppress bad line substitution.
-l Causes qfv to print the last received file.
-j skip
-J skip These options cause printfax to skip a number of scan lines at the top of either the first page (-j) or all pages (-J). This may be used to remove a "From" line inserted by the remote fax machine when producing an image format. A value of "-J 100" is a good starting value for typical "From line" removal.
-P eol The -P eol parameter defines the number of consecutive EOL (end of line) codes to be considered an end of pager (EOP) marker. A standards compliant fax will use 5 EOL markers to signify EOP, and 'qfax' has always inserted sufficient EOLs when the remote machine did not supply them. Some fax machines may not supply the correct EOLs, and early versions of LFAX did not supply the extra markers.
-g page Causes qfv to display page 'page'. Other pages may subsequently be displayed by the menu options.

qfv honours the following printfax options from a PFAXINI option in qfax_dat.

-c n HP compression mode (0/2/3)
-s n Specific actions (only used by HP mode)
-t name printer name
-o dev printer device
-p Causes the window to appear at (or near) the current pointer position rather than centred.

printfax options

ex printfax;`-o dev [-t name] [-x] [-a] [-c n] [-s n] [-q] [-b]
            [-v] [-r range] [-J|j jump] [-P eol] [-l | file]'
where
-o dev is a device or file for output.
-t name is the printer or output format name.
-x Suppresses the c68 `Any key to exit' message
-a Enables a PE popup, giving the name of the file being printed and options `Cancel', `Remove', `Abort'. `Cancel' stops the current fax being printed. `Remove' just removes the requester (printing continues). `Abort' aborts all fax pages printing or queued for printing. This option is most useful when printfax is invoked automatically by qfax for automatic printing of received fax; you then get notification of the sender TSI or name (depending of your use of ALIAS) in the popup.
-sn Enables printer specific options. At present the only specific support is for HP compatible printers.
-cn Enables HP data compression. This can result in large reductions in the amount of data sent to the printer
-q No progress indicator
-v Force progress indicator
-b Suppresses bad line replacement.
-l Causes printfax to print the last received file.
-r range printfax supports a print range, using comma and dash as separators. For example, to print pages 3,5,7,8,9,12 of a fax.
ex printfax;'-r3,5,7-9,12 somefile_fax'
Ranges are denoted by '-', with individual pages and ranges separated by a comma (e.g. 1-4,8-10).
-j skip
-J skip These options cause printfax to skip a number of scan lines at the top of either the first page (-j) or all pages (-J). This may be used to remove a "From" line inserted by the remote fax machine when producing an image format. A value of "-J 100" is a good starting value for typical "From line removal".
-P eol The -P eol parameter defines the number of consecutive EOL (end of line) codes to be considered an end of pager (EOP) marker. A standards compliant fax will use 5 EOL markers to signify EOP, and 'qfax' has always inserted sufficient EOLs when the remote machine did not supply them. Some fax machines may not supply the correct EOLs, and early versions of LFAX did not supply the extra markers.
file is a QFAX G3 file or output from text2g3.

QFAX Tables

Modem Speeds


Modem Max DCE speed
0 2400 bps
1 4800 bps
2 7200 bps
3 9600 bps
4 12000 bps
5 14400 bps

CCITT Encoding


CODE Result
0 1-D coding. 1-Dimensional, each pixel line is encoded separately
1 2-D coding. Pixel lines may be encoded as the difference from a previous ``Reference'' line.

Phonebook KEYS


NAME The name of the respondent, used as the directory name for receive.
ALIAS An alias that may be used for dialling.
TSI The TSI returned by the respondent's fax machine.
DCODE A dial code that is prepended to the TSI to give a dial out number for the respondent.
FULL The full (dial out) number of the respondent. For occasions when the number cannot be constructed from DCODE and TSI.
2D A flag that indicated 2D capability. This may just be for reference or may be used by text2g3 to determine optimum coding method.

Preset options KEYS


QFAXINI default options for qfax
QFVINI default options for qfv
PFAXINI default options for printfax
T2G3INI default options for text2g3


QFAXINI default options for qfax
QFVINI default options for qfv
PFAXINI default options for printfax
T2G3INI default options for text2g3

Date KEYS


DAYS days text string
MONTHS months text string

Paging KEYS


WIDTH_S default page width for text2g3 encoding.
PAGE_S default page length for text2g3 encoding.
WIDTH_R advertised capability for qfax reception.
PAGE_R advertised capability for qfax reception.
PAPERSIZE The size of paper used to print fax.

EOL Alignment KEYS


Value Effect
0 (the default, standard text2g3 conformance) Adds a byte pad before EOL, starts new lines on byte boundary.
1 Starts new lines on byte boundary
2 Does no padding or alignment.

ITU-TSS G3 page widths


Key Pixels mm Descriptive
0 1728 215 A4
1 2048 255 B4
2 2432 303  

ITU-TSS G3 page heights


Key Pixels mm Descriptive
0 2286 297 A4
1 2804 364 B4
2     Unlimited

text2g3 attributes table


Command Effect
~; A comment
~: A verbose comment (displayed on the screen).
~P Page File
~I Include text file text_file
~C Chain to file text_file
~S import screen QDOS_screen [position] [magnification] [invert] [square]
~Q import PIC PIC_Image [position] [magnification] [invert] [square]
~B import PBM pbm_file [position]
~q import PIC PIC_Image [position] [magnification] [invert] [square]
~s import screen QDOS_Screen_Image [position] [magnification] [invert] [square]
~b import PBM pbm_file [position]
~F equate font file with font number filename No
~[0-9] Use this font number
~E Emphasis (Bold) on
~e Emphasis (Bold) off
~U Underline on
~u underline off
~O Oblique (Italics) on
~o Oblique (Italics) off
~~ Single tilde ~ character
~d Date
~D Weekday and Date
~m[0-f] Substitute macro hex number
~# set page size width length
~X include fax file_name

qfm default actions


Edit Fax qed %f$QFAX_INDIR_txt
Make Fax text2g3 %f
View Fax qfv -l
Send Fax qfax -v -s %t %f$QFAX_TEMP$QFAX_SUFFIX
Print Fax printfax %f
Receive Fax qfax -Rv
Edit $QFAX_DATA qed $QFAX_DATA
Edit Phone Book qed $QFAX_PHONE
View Log qless %?
View Info qless $QFAX_INFO

qfm $QFAX_DATA mnemonics


Action LMB Mnemonic RMB Mnemonic
Edit Fax LMB_EDIT RMB_EDIT
Make Fax LMB_MAKE RMB_MAKE
View Fax LMB_VIEW RMB_VIEW
Send Fax LMB_SEND RMB_SEND
Print Fax LMB_PRINT RMB_PRINT
Receive Fax LMB_RECEIVE RMB_RECEIVE
Edit $QFAX_DATA LMB_EDDAT RMB_EDDAT
Edit Phone Book LMB_EDPHONE RMB_EDPHONE
View Log LMB_VLOG RMB_VLOG
View Info LMB_VINFO RMB_VINFO

printfax device mnemonics


Mnemonic Typse
hp-pcl Laser/Deskjet 300 dpi, the default
eps-24 Epson 24 pin, 180 dpi
eps-9 Epson 9 pin, 120x72 dpi
ps Postscript
ps-ltr Postscript
pbm Portable bit map (P4, raw)
pic PIC (1:1) pixel scale
pic-scaled PIC (1:2) pixel scale
gif GIF, whole fax in one file
gif-paged GIF, each page in separate file

QFAX Default settings


Parameter Minimum Abbreviation Default
APRES APRES (none)
ATZ ATZ Z
CHILDLOG CHILDLOG (none)
CLASS2.0 CLASS2.0 (not defined)
CODING COD 0
DATA DATA (none)
DAYS DAYS Sunday,Monday, etc
DELAY DELAY 10
DIAL DIAL D
APRES APRES (none)
APRES APRES (none)
ECM EC (none)
EDR EDR (none)
EXITBAUD EXIT (none)
FAA FAA 0
FONT FONT flp1_QFax_font
GDELAY GDELAY 10
GFLAG GFLAG 0
HANGUPOK HANGUPOK (none)
IDENTIFICATION ID (none)
INDIR IND ram1_fax_
INFO INF ram2_fax_log
INIT INI (none)
LEFTMARGIN LEFTMAR 160
LSB LSB (none)
MDM1 MDM1 (use QFAX default)
MDM2 MDM2 (use QFAX default)
MDM3 MDM3 (use QFAX default)
MDM4 MDM4 (use QFAX default)
MODEM MOD 5
MONTHS MONTHS January,February, etc
MSB MSB (none)
NOPOLL NOPOLL (none)
PAGE_RECEIVE PAGE_R 2
PAGE_SEND PAGE_S 0
PAPERSIZE PAPERS A4
PATHFONT PATHFO (none)
PFAXINI PFAXINI (none)
PHONEBOOK PHONEBOOK QFAX_PHONE
PPR_TRY PPR 3
PREINIT PREINI (none)
PRESCAN PRESCAN (none)
PRINT PRINT (none)
PRVIEW PRVIEW (none)
QFAXINI QFAXINI (none)
QFVINI QFVINI (none)
RCLASS RCLASS 2
RESOLUTION RES 1
RMODEM RMODEM (none)
RSFLAG RSFLAG (none)
SAVETHING SAVET (none)
SCLASS SCLASS 2
SCRIPTLOG SCRIPTLOG ram2_script_log
SENDBITS SEND LSB
SERBAUD SERB 19200
SERDEV SERD ser2hr
SIGNATURE SIG QFAX
STARTCHAR STARTC DC2
STARTSCRIPT STARTS (none)
STOPSCRIPT STOPS (none)
SUFFIX SUFFIX _fax
T2G3INI T2G3INI (none)
TEMP TEMP ram2_
UNLIMITED UNLIM (none)
VIA VIA (none)
WAIT2SEND WAIT YES
WIDTH_RECEIVE WIDTH_R 0
WIDTH_SEND WIDTH_S 0
XDIAL XDIAL (none)

About this document ...

This document was generated using the LaTeX2HTML translator Version 98.1p1 release (March 2nd, 1998)

Copyright © 1993, 1994, 1995, 1996, 1997, Nikos Drakos, Computer Based Learning Unit, University of Leeds.

The command line arguments were:
latex2html -no_subdir -split 0 -local_icons qfaxref.tex.

The translation was initiated by Jonathan Hudson on 1999-03-03


next up previous
Jonathan Hudson
1999-03-03