(Page 4 of 10 in this chapter)
Version
Receiving a Fax: nfxrecv
Name
nfxrecv
Purpose
Demonstrates receiving a fax.
nfxrecv
can be used to receive a fax from a fax terminal, or from the
nfxsend
demonstration program.
Usage
nfxrecv
[
options
]
filename1
[
filename2
[ ... ]]
options
are:
Option
Description
Default
-b
n
Specifies the AG board number
n
.
0
-q
Specifies that the board is a QX 2000 board.
AG board
-s
n:m
Specifies the stream and timeslot.
0:0
-r
resolution
Specifies the resolution (
low
,
high
, or
superhigh
).
low
-e
encoding
Specifies the encoding (
1D
,
2D
,
MMR,
or TIFF_S
).
1D
-c
mode
Specifies conversion mode:
y
= yes (
NFX_OTF_ALWAYS
)
m
= maybe (
NFX_OTF_ONLY_IF_FAIL
)
n
= no (
NFX_OTF_NEVER
)
m
-p
protocol
Specifies the protocol (TCP name).
nocc
-w
pagewidth
Specifies the page width (A4, B4, A3).
A4
-E
Toggles using ECM mode when encoding is 1D or 2D.
Do not use ECM.
-v
Toggles verbose reporting of event information.
Non-verbose mode.
Description
nfxrecv
receives a fax using NaturalFax and CT Access functions. The CT Access environment is initialized and the ADI service is opened with the specified board, stream, and timeslot.
The fax document queue is created and the specified files are enqueued. Then the call is answered, the receive parameters are set, and the fax is received.
Specifying
TIFF_S
encoding causes the calling application to receive a file using TIFF-S attributes of 1D encoding, LOW resolution, and A4 pagewidth. TIFF-S encoding overrides any values specified on the command line.
While waiting for the
NFXEVN_SESSION_DONE
event, all events are monitored, and appropriate action is taken in case the call is disconnected or a board error occurs. After the fax has been received, the application releases the call, destroys the document queue and the event queue, and closes the CTA context.
(Page 4 of 10 in this chapter)
Version
tech_support@nmss.com
Copyright © 1999, Natural MicroSystems, Inc. All rights reserved.