201 lines
6.9 KiB
C
201 lines
6.9 KiB
C
#ifndef _AWG3FILE_
|
|
#define _AWG3FILE_
|
|
|
|
/********************************************************************
|
|
|
|
@doc EXTERNAL SRVRDLL LINEARIZER
|
|
|
|
@type VOID | AWG3 File Format |
|
|
|
|
An AWG3 file can be used to describe any
|
|
multi page image encoded using a CCITT G3 standard like
|
|
MH, MR, or MMR.
|
|
|
|
The file format is a special case of the Microsoft Fax Linearized
|
|
format. It consists of a LINHEADER structure, followed by
|
|
an extended linearized header, followed by the image data.
|
|
The image data is specified as one or more headers, each followed
|
|
by a page of encoded image data. Each header starts a
|
|
new page. The file is terminated with a header containing
|
|
a special end-of-file signature marker.
|
|
|
|
Linearizer helper function CreateSimpleHeader should be used to
|
|
write the LINHEADER and extended linearized header when creating
|
|
an AWG3 file.
|
|
|
|
Linearizer helper function DiscardLinHeader should be used to
|
|
skip past the LINHEADER and extended linearized header when
|
|
reading the AWG3 file.
|
|
|
|
The page header format is defined by the structure <t AWG3HEADER>.
|
|
The data for each page consists of one or more frames.
|
|
A frame consists of a DWORD indicating the length of data in
|
|
the frame followed by that many bytes of data. The last
|
|
frame of each page must be of zero length and indicates
|
|
the end of the page data.
|
|
The data consists of raw MH, MR, or MMR, encoded so that the
|
|
least significant bit of each byte should be sent first over
|
|
the wire.
|
|
|
|
@xref <t AWG3HEADER>
|
|
|
|
********************************************************************/
|
|
|
|
/********
|
|
@doc EXTERNAL SRVRDLL LINEARIZER
|
|
|
|
@types AWG3HEADER | Describes the Header Structure for an AWG3 File.
|
|
|
|
@field WORD | wSig | Must be SIG_G3 for the page headers, and
|
|
SIG_ENDFILE for the end of file header.
|
|
|
|
@field WORD | wHeaderSize | Must be set to the size of the header
|
|
structure. Used for version control.
|
|
|
|
@field WORD | wTotalHeaders | If non-zero, this indicates the total
|
|
number of and headers (including the end-of-file header)
|
|
in this file. This need only be set in the first header.
|
|
If zero, the total number of headers is not specified directly and
|
|
can be obtained by traversing the headers in the file (until
|
|
the end-of-file header).
|
|
|
|
@field WORD | wHeaderNum | Gives the ordinal number for this
|
|
header. Must be set for all headers. Numbering starts at 1.
|
|
|
|
@field DWORD | lDataOffset | Gives the offset from the beginning
|
|
of the current header to the start of the first frame
|
|
of the data for this page.
|
|
Must always be set.
|
|
|
|
@field DWORD | lNextHeaderOffset | Gives the offset from the start of the
|
|
current header to where the header for the next page can be found. If this
|
|
is set to 0, the next header starts at the end of the
|
|
last frame (which will be a null frame) for this page.
|
|
|
|
@field DWORD | AwRes | One of the standard resolution defines
|
|
specified in <t STD_RESOLUTIONS>.
|
|
|
|
@field DWORD | Encoding | One of the G3 Fax types from the
|
|
standard types defined in <t STD_DATA_TYPES>. Basically one
|
|
of MH_DATA, MR_DATA, or MMR_DATA.
|
|
|
|
@field DWORD | PageWidth | One of the standard page widths as defined in
|
|
<t STD_PAGE_WIDTHS>.
|
|
|
|
@field DWORD | PageLength | One of the standard page lengths as defined in
|
|
<t STD_PAGE_LENGTHS>.
|
|
|
|
@xref <t AWG3 File Format>
|
|
********/
|
|
|
|
#define SIG_G3 0x3347
|
|
#define SIG_ENDFILE 0x4067
|
|
|
|
#ifndef WIN16 // remove WIN16 irritation
|
|
#pragma pack(push)
|
|
#endif
|
|
|
|
#pragma pack(1)
|
|
typedef struct {
|
|
WORD wSig; // always set to one of the above SIG_ #defines
|
|
WORD wHeaderSize; // always set
|
|
WORD wTotalHeaders; // can be 0
|
|
WORD wHeaderNum; // starts from 1
|
|
// 8 bytes
|
|
|
|
// all offsets from start of _this_header_
|
|
DWORD lDataOffset; // always set. points to the first frame-size DWORD
|
|
DWORD lNextHeaderOffset; // may be NULL--then next header follows end of data
|
|
// 16 bytes
|
|
|
|
DWORD AwRes; // as per AWRES_ defines below. DIFFERENT from Snowball
|
|
DWORD Encoding; // as per _DATA defines below. Same as Snowball
|
|
DWORD PageWidth; // as per WIDTH_ defines below. Same as Snowball
|
|
DWORD PageLength; // as per LENGTH_ defines below. Same as SNowball
|
|
// 32 bytes
|
|
|
|
BYTE Reserved1[32]; // pad out to 64 bytes for future expansion
|
|
} AWG3HEADER, far* LPAWG3HEADER;
|
|
|
|
#ifdef WIN16 // remove WIN16 irritation
|
|
#pragma pack()
|
|
#else
|
|
#pragma pack(pop)
|
|
#endif
|
|
|
|
|
|
|
|
// Standard Bit Valued MetaData values
|
|
#define MH_DATA 0x00000001L
|
|
#define MR_DATA 0x00000002L
|
|
#define MMR_DATA 0x00000004L
|
|
|
|
|
|
// Standard Resolutions
|
|
#define AWRES_UNKNOWN 0x00000000L
|
|
#define AWRES_CUSTOM 0x00000001L
|
|
#define AWRES_mm080_038 0x00000002L
|
|
#define AWRES_mm080_077 0x00000004L
|
|
#define AWRES_mm080_154 0x00000008L
|
|
#define AWRES_mm160_154 0x00000010L
|
|
#define AWRES_200_100 0x00000020L
|
|
#define AWRES_200_200 0x00000040L
|
|
#define AWRES_200_400 0x00000080L
|
|
#define AWRES_300_300 0x00000100L
|
|
#define AWRES_400_400 0x00000200L
|
|
#define AWRES_600_600 0x00000400L
|
|
#define AWRES_75_75 0x00000800L
|
|
#define AWRES_100_100 0x00001000L
|
|
|
|
/********
|
|
@doc EXTERNAL DATATYPES SRVRDLL
|
|
|
|
@type WORD | STD_PAGE_LENGTHS | Standard Page Lengths
|
|
|
|
@emem LENGTH_A4 | Std A4 paper length, Value: 0
|
|
@emem LENGTH_B4 | Std B4 paper length, Value: 1
|
|
@emem LENGTH_UNLIMITED | Unknown length, Value: 2
|
|
|
|
@comm These lengths are compatible with those defined
|
|
by the CCITT for G3 machines. They are used
|
|
in fax format headers, and in structures dealing
|
|
with fax machine capabilities.
|
|
********/
|
|
|
|
// Length defines
|
|
#define LENGTH_A4 0
|
|
#define LENGTH_B4 1
|
|
#define LENGTH_UNLIMITED 2
|
|
|
|
|
|
/********
|
|
@doc EXTERNAL DATATYPES SRVRDLL
|
|
|
|
@type WORD | STD_PAGE_WIDTHS | Standard Page Widths
|
|
|
|
@emem WIDTH_A4 |1728 pixels, Value: 0
|
|
@emem WIDTH_B4 |2048 pixels, Value: 1
|
|
@emem WIDTH_A3 |2432 pixels, Value: 2
|
|
@emem WIDTH_A5 |1216 pixels, Value: 16
|
|
@emem WIDTH_A6 |864 pixels, Value: 32
|
|
|
|
@comm These widths are compatible with those defined
|
|
by the CCITT for G3 machines. They are used
|
|
in fax format headers, and in structures dealing
|
|
with fax machine capabilities.
|
|
********/
|
|
|
|
//Width defines
|
|
#define WIDTH_A4 0 /* 1728 pixels */
|
|
#define WIDTH_B4 1 /* 2048 pixels */
|
|
#define WIDTH_A3 2 /* 2432 pixels */
|
|
#define WIDTH_MAX WIDTH_A3
|
|
|
|
#define WIDTH_A5 16 /* 1216 pixels */
|
|
#define WIDTH_A6 32 /* 864 pixels */
|
|
#define WIDTH_A5_1728 64 /* 1216 pixels */
|
|
#define WIDTH_A6_1728 128 /* 864 pixels */
|
|
|
|
#endif // _AWG3FILE_
|
|
|