beautypg.com

Dialogic 6.2 User Manual

Page 49

background image

The Bfv API Functions

November 2009

49

To create an infopkt stream file to test the fax functionality of your

hardware and software:

mkinfopk -o fax.ips doc 1 ascii fax.c

Where:

For fax-receiving applications, an INFOPKT_DOCUMENT_PARAMETERS

infopkt begins each new G3 page within it. If the application uses a

nonstandard receive format (see the BfvFaxSetReceiveFmt

function in Volume 4, Fax Processing, Bfv API Reference Manual), it

must also include a G3_STRIP_PARAMTERS infopkt.

For fax-transmitting applications, an infopkt stream must begin

with an INFOPKT_DOCUMENT_PARAMETERS infopkt. Any type of

infopkt or combination of infopkts can follow the first
INFOPKT_DOCUMENT_PARAMETERS

infopkt.

Within a fax-transmitting application, a new page is indicated when

one of the following infopkt types is encountered in an infopkt

stream:

INFOPKT_BEGINNING_OF_PAGE

INFOPKT_DOCUMENT_PARAMETERS

INFOPKT_T30_PARAMETERS

INF0PKT_FAX_HDR

Figure 3

on

page 50

illustrates how to create an infopkt stream that

transmits G3 data. G3 data includes MH, MR, MMR, and PCX

formats.

fax.ips

Is the name of the output infopkt stream file that contains

the ASCII file fax.c (the sample fax application program

included on your distribution CD).

doc

Is required as the first infopkt in a stream (1 is its

argument). See

mkinfopk

on

page 153

for more

information about doc.

ascii

Indicates that the input file fax.c is an ASCII formatted

file.

fax.c

Is the input file.