Proprietary Extension for COMMON-ISDN-API Version 2.
COPYRIGHT NOTICE AND LEGAL DISCLAIMER Sixth Edition (October 2007) 206-412-06 Copyright © 1998-2007 Dialogic Corporation. You may not reproduce this document in whole or in part without permission in writing from Dialogic Corporation at the address provided below. All contents of this document are subject to change without notice and do not represent a commitment on the part of Dialogic Corporation or its subsidiaries (“Dialogic”).
Motivation: The current COMMON-ISDN-API specification defines paper formats ISO A4, ISO B4 and ISO A3 at standard resolution (R8 x 3.85) and high resolution (R8 x 7.7). Support for B4 and A3 is even optional. The following document proposes a COMMON-ISDN-API extension that enables FAX document transmission and reception with paper formats ISO A4, ISO B4 and ISO A3 and these resolutions as specified in T.30: • R8 x 3.85 • R8 x 7.7 • R8 x 15.4 • R16 x 15.
.2.2.7 CAPI_GET_PROFILE Applications call CAPI_GET_PROFILE to retrieve capability information from COMMON-ISDN-API. COMMON-ISDN-API copies information about implemented features, the total number of controllers, and protocols supported by the requested controller to a 64-byte buffer passed by the calling application. The application must ignore unknown bits. COMMON-ISDN-API sets reserved fields to zero.
4 bytes 24 bytes 4 bytes 16 bytes B3 protocol support (bit field): [0]: Transparent, always set [1]: T.90NL with compatibility to T.70NL in accordance to T.90 Appendix II. [2]: ISO 8208 (X.25 DTE-DTE) [3]: X.25 DCE [4]: T.30 for fax group 3 [5]: T.30 for fax group 3 with extensions [6]: reserved [7]: Modem [8]...[31]: reserved reserved for COMMON-ISDN-API use Private options (bit field): [0]...[5]: reserved [6]: FAX paper formats and resolutions [7]...
Manu ID (dword) The purpose of the parameter Manu ID is to communicate a dword which identifies the manufacturer in MANUFACTURER messages. Every manufacturer supplying MANUFACTURER messages should choose a unique value (such as an abbreviation of the company name).
Manufacturer Command The purpose of the parameter manufacturer command is to specify the kind of operation requested in a MANUFACTURER_REQ.
ANNEX B (NORMATIVE): SFF FORMAT B.1 Introduction SFF (Structured Fax File) is a representation specific to fax group 3 documents. As shown below in Fiugre 6 it consists of information concerning the page structure and compressed line data of the fax document. An SFF-formatted document always starts with a header, which is valid for the complete document. Every page starts with a page header. This is followed by the pixel information, line by line.
B.2.2 Page header Parameter Type Comment PageHeaderID PageHeaderLen byte byte Resolution Vertical byte Resolution Horizontal byte Coding byte reserved byte 254 (Page data record type) 0: Document end 1...255: byte offset of first page data from the Resolution Vertical field of the page header. This value is normally equal to the size of the remainder of the header (0x10), but there could be additional user-specific data between page header and page data.
Line Length word Page Length word OffsetPreviousPage dword OffsetNextPage dword Number of pixels per line 1728: standard fax G3 2048: B4 (optional) 2432: A3 (optional) Support for additional values is optional for COMMONISDN-API If FAX paper formats and resolutions are enabled 1728: ISO A4 at R8 x 3.85, R8 x 7.7, R8 x 15.4, 200 x 200 2048: ISO B4 at R8 x 3.85, R8 x 7.7, R8 x 15.4, 200 x 200 2432: ISO A3 at R8 x 3.85, R8 x 7.7, R8 x 15.
