Table of Contents Index NMS Glossary Previous Page Next Page (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 page width. 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.



Table of Contents Index NMS Glossary Previous Page Next Page (Page 4 of 10 in this chapter) Version


Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2000, Natural MicroSystems, Inc. All rights reserved.