Fax Software Reference for Windows Table of Contents
1. Introduction
1.1. Purpose and Audience
1.2. Using this Guide
1.3. Related Publications
1.3.1. Dialogic Publications
1.3.2. Other Publications
1.4. Documentation Conventions
1.5. Contacting Dialogic
1.6. What's in this Guide
2. Basics of Dialogic Fax Software
2.1. Welcome to Dialogic Fax Software
2.2. Product Support
2.3. System Requirements
2.4. Key Product Features
2.5. Dialogic Fax API/Library Overview
2.6. Voice and Fax Integration
2.7. Modes of Operation
2.7.1. Synchronous Mode
2.7.2. Asynchronous Mode
2.8. System Configuration Models
2.8.1. Stand-alone Model
2.8.2. SCbus Model
2.9. Sample Demonstration Programs
2.10. Complying with the Telephone Consumer Protection Act
3. Background on Fax Communications
3.1. Overview
3.2. Fax Terminology
3.3. Structure of a Fax Call
3.3.1. Phase A - Set Up Fax Call
3.3.2. Phase B - Pre-Message Procedure
3.3.3. Phase C - Transmit Message
3.3.4. Phase D - Post-Message Procedure
3.3.5. Phase E - Release Fax Call
3.4. Types of Fax Transmission
3.4.1. Normal Fax Transmission
3.4.2. Polling Fax Transmission (Fax on Demand)
3.4.3. Turnaround Polling Fax Transmission
3.5. File Storage Formats
3.5.1. Raw Files
3.5.2. TIFF/F Files
3.5.3. ASCII Files
3.6. Data Encoding Schemes
3.7. Error Correction Mode (ECM)
3.8. Image Scaling
3.9. Image Resolution
3.10. Subaddress Fax Routing
4. Implementing Fax Capability -- Send Fax
4.1. Overview
4.2. Guidelines for Implementing Fax
4.3. Opening and Closing a Fax Channel Device
4.4. Setting the Initial State of a Fax Channel
4.5. Specifying Fax Data for Transmission in a DF_IOTT Table Entry
4.5.1. Declaring a Table of DF_IOTT Entries
4.5.2. Connecting DF_IOTT Table Entries
4.5.3. Sending Data from Device or Memory
4.5.4. Specifying File Storage Format
4.5.5. Sending Raw Files
4.5.6. Sending TIFF/F Files
4.5.7. Sending ASCII Files
4.5.8. Specifying Encoding Scheme for Data Transmission
4.5.9. Setting Phase D Continuation Values
4.5.10. Merging Images from Different Sources or Sub-Page Addressing
4.6. Setting Parameters for Send Fax
4.6.1. Selecting a Transmission Baud Rate
4.6.2. Specifying a Preferred Encoding Scheme for Transmission
4.6.3. Defining a Fax Page Header
4.6.4. Retransmitting a Fax
4.7. Setting the Bit Mask for a Send Fax Function
4.7.1. Mode of Operation
4.7.2. Enable Phase B Event Generation
4.7.3. Enable Phase D Event Generation
4.7.4. Enable Operator Intervention (Voice Request)
4.7.5. Select Resolution for Fax Transmission
4.7.6. Enable Subaddress Fax Routing
4.8. Issuing a Send Fax Function
4.8.1. Send Fax Issued by the Transmitter
4.8.2. Send Fax Issued by the Called Application
4.8.3. Status of Fax Transmission
4.9. Stopping a Fax Transmission or Reception
4.10. Replacing Bad Scan Lines
4.11. Creating User-Defined I/O Functions
5. Implementing Fax Capability -- Receive Fax
5.1. Overview
5.2. Setting Parameters for Receive Fax
5.2.1. Specifying Encoding Scheme to Store Incoming Fax Data
5.2.2. Storing Incoming Fax Data
5.2.3. Setting Acceptable Percentage of Bad Scan Lines
5.2.4. Selecting Preferred Maximum Receive Baud Rate
5.2.5. Replacing Bad Scan Lines
5.2.6. Routing Fax Data to Multiple Subaddresses
5.3. Setting the Bit Mask for a Receive Fax Function
5.3.1. File Format for Incoming Fax Data
5.3.2. Mode of Operation
5.3.3. Enable Phase B Event Generation
5.3.4. Enable Phase D Event Generation
5.3.5. Enable Operator Intervention (Voice Request)
5.3.6. Selectable Receive Width
5.3.7. Selectable Receive Length
5.3.8. Resolution for Storing Incoming Fax Data
5.4. Issuing a Receive Fax Function
5.4.1. Receive Fax Issued by the Receiver
5.4.2. Receive Fax Issued by the Transmitter
5.4.3. Status of Fax Reception
5.5. Creating User-Defined I/O Functions
6. Specifying Fonts in ASCII to Fax Conversion
6.1. Overview
6.2. Supported Fonts
6.3. Using the Dialogic Configuration File
6.4. Using the ASCII Font Loader Utility
6.4.1. Overview
6.4.2. ASCII Font Loader Flow of Control
6.5. Enabling Katakana Character Support
6.6. Using Windows Font Handles
6.6.1. VFX and DSP-Based Group 3 Fax Font Features
6.6.2. Using fx_setparm( ) and fx_getparm( ) to Select Fonts
6.6.3. Overriding Fonts Set with fx_setparm( )
6.6.4. Compatibility Issues
6.6.5. Preserving Dialogic Fonts as Default Fonts
7. Fax Data Structures
7.1. Overview
7.2. Declaring Fax Data Structures
7.3. DF_ASCIIDATA -- ASCII Data Description
7.3.1. DF_ASCIIDATA Definition
7.3.2. DF_ASCIIDATA Field Descriptions
7.3.3. Usage Rules
7.4. DF_DCS -- Digital Command Signal
7.5. DF_DIS -- Digital Identification Signal
7.6. DF_IOTT -- Fax Transmit Data Description
7.6.1. DF_IOTT Definition
7.6.2. DF_IOTT Field Descriptions
7.7. DF_UIO -- User-Defined I/O
7.7.1. DF_UIO Definition
7.7.2. DF_UIO Field Descriptions
7.7.3. Usage Rules
8. Using the Dialogic Fax Library
8.1. Overview
8.2. Function Categories
8.2.1. Send Fax
8.2.2. Receive Fax
8.2.3. Set Initial Fax State
8.2.4. Initialize DF_IOTT
8.2.5. Configuration
8.2.6. Extended Attribute
8.2.7. Resource Management
8.2.8. SCbus Routing
8.2.9. Miscellaneous
8.2.10. Convenience Functions
8.3. Error Handling
8.3.1. Synchronous Mode
8.3.2. Asynchronous Mode
8.4. Include (Header) Files
8.5. Compiling Applications
9. Fax Library Function Reference
FAX Library Overview
Reference Header Information
Description
Details
Cautions
Example
Source Code
See Also
ATFX_BADIOTT( )
ATFX_BADPAGE( )
ATFX_BADSCANLINES( )
ATFX_BSTAT( )
ATFX_CHTYPE( )
ATFX_CODING( )
ATFX_ECM( )
ATFX_ESTAT( )
ATFX_FXVERSION( )
ATFX_LASTIOTT( )
ATFX_PGXFER( )
ATFX_PHDCMD( )
ATFX_PHDRPY( )
ATFX_RESLN( )
ATFX_RTNPAGES( )
ATFX_SCANLINES( )
ATFX_SPEED( )
ATFX_STATE( )
ATFX_TERMMSK( )
ATFX_TFBADTAG( )
ATFX_TFNOTAG( )
ATFX_TFPGBASE( )
ATFX_TRCOUNT( )
ATFX_WIDTH( )
fx_close( )
fx_getDCS( )
fx_getDIS( )
fx_GetDllVersion( )
fx_getNSF( )
fx_getparm( )
fx_initstat( )
fx_libinit( )
fx_loadfont( )
fx_open( )
fx_rcvfax( )
fx_rcvfax2( )
fx_rtvContinue( )
fx_sendascii( )
fx_sendfax( )
fx_sendraw( )
fx_sendtiff( )
fx_setiott( )
fx_setparm( )
fx_setuio( )
fx_stopch( )
Appendix A - TIFF/F Tags and Values
Overview
Input to the Library from Disk Storage
Output from the Library to Disk Storage
Appendix B - Fax Phase D Status Values
Fax Phase D Status Overview
Appendix C - Fax Phase E Status Values
FAX Phase E Status Overview
Appendix D - Fax Error Codes
FAX Error Code Overview
FAX Error Code Listing
Appendix E - Fax Event Codes
FAX Event Code Listing
Appendix F - ASCII to Fax Tables
Overview
Dialogic ASCII to Fax Command Set
Appendix G - Acronyms List
Acronyms
Glossary
Copyright notice
Copyright 2002, Intel Corporation
All rights reserved
This page generated February, 2002