Dialogic 6.2 manual Mkinfopk -o fax.ips doc 1 ascii fax.c

The Bfv API Functions

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:

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
ascii	information about doc.
	Indicates that the input file fax.c is an ASCII formatted
	file.
fax.c	Is the input file.

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.

November 2009 49