Summary of the content on the page No. 1
Proprietary Extension for
COMMON-ISDN-API
Version 2.0
Extension for Fax Paper Formats
and Resolutions
October 2007
Dialogic Corporation
Summary of the content on the page No. 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”). Reasonable effort is made to ensure the accuracy o
Summary of the content on the page No. 3
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.4 • 200 x 200 • 300 x 300 • 4
Summary of the content on the page No. 4
4.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. CAPI_GET_PROFILE fills the buffer with the following structure: Type Description 2
Summary of the content on the page No. 5
4 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 24 bytes reserved for COMMON-ISDN-API use 4 bytes Private options (bit field): [0]...[5]: reserved [6]: FAX paper formats and resolutions [7]...[31]: reserved 16 bytes Manufacturer
Summary of the content on the page No. 6
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 MANU- FACTURER messages should choose a unique value (such as an abbreviation of the company name). The manufacturer ID used by Dialogic is: 0x44444944 This information element appears in: MANUFACTURER_REQ MANUFACTURER_RESP MANUFACTURER_CONF MANUFACTURER_IND Manufacturer Specific The purpose of the parameter manu
Summary of the content on the page No. 7
Manufacturer Command The purpose of the parameter manufacturer command is to specify the kind of operation requested in a MANUFACTURER_REQ. The following manufacturer commands are defined: 1: Assign PLCI 2: Advanced Codec control 3: DSP control 4: Signaling control 5: RXT control 6: IDI control 7: Configuration control 8: Remove Codec 9: Options request This information element appears in: Manufacturer Specific Manufacturer Command Parameters The purpose of the parameter manu
Summary of the content on the page No. 8
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. As the SFF format is a file format specif
Summary of the content on the page No. 9
B.2.2 Page header Parameter Type Comment PageHeaderID byte 254 (Page data record type) PageHeaderLen byte 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. COMMON-ISDN-API ignores and does not provide such additional data. Resolution Vertical byte Definition of ver
Summary of the content on the page No. 10
Line Length word Number of pixels per line 1728: standard fax G3 2048: B4 (optional) 2432: A3 (optional) Support for additional values is optional for COMMON- ISDN-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.4, 200 x 200 2592: ISO A4 at 300 x 300, 300 x 600 3072: ISO B4 at 300 x 300, 300 x 600 3648: ISO A3 at 300 x 30
