upCast 4.0

User Manual and Reference

Christian Roth

infinity-loop GmbH

Information in this document is subject to change without any prior notice. The software described in this document is furnished under a license agreement. The software may be used or copied only in accordance with the terms of the license agreement.

All product names identified throughout this document are trademarks or registered trademarks of their respective owners.

No part of this publication may be reproduced in any form or distributed in any form by any means, in whole or in part, without the prior written permission of infinity-loop GmbH.

Revision History
Revision 12003-03-22cr
initial version
Revision 22003-04-15cr
updated to UpcastEngine class
Revision 32003-09-06cr
changed 'span' to 'inline'
Revision 42003-10-14cr
updated for 4.0.2 release
Revision 52003-11-16cr
updated for custom encodings and use of stdfonts.config

Table of Contents

1. Introduction
1.1. Document Conversion
1.2. The name: upCast
2. Product Overview
2.1. Features
2.2. Architecture & Concepts
2.2.1. Modules
2.2.2. Filter Concept
3. Getting started
3.1. Installation
3.1.1. Windows 95/98/2000/NT/XP
3.1.2. Mac OS X
3.1.3. Unix/Linux/Solaris
3.2. Running the application
3.2.1. Windows 95/98/2000/NT/XP
3.2.2. Mac OS X
3.2.3. Unix/Linux/Solaris
3.3. Supplying a License file
3.3.1. File based licensing
3.3.2. JAR based licensing
4. Using upCast
4.1. Quick Tour: upCast in seven steps
4.2. Basic operations
4.2.1. Choosing an import filter
4.2.2. Configuring an import filter
4.2.3. Choosing the source file
4.2.4. Adding an Export Filter
4.2.5. Configuring an Export Filter
4.2.6. Removing an Export Filter
4.2.7. Choosing the destination folder
4.2.8. Specifying a separate destination folder for images
4.2.9. The conversion process
4.2.10. Aborting a running conversion
4.3. Working with Configurations
4.3.1. What is a configuration?
4.3.2. Saving a configuration
4.3.3. Opening a configuration
4.3.4. A special configuration: preferences.plist
4.4. Logging
5. Filter Reference
5.1. Import Filters
5.1.1. (none)
5.1.2. RTF 1.6
5.1.3. Batch Processor
5.1.4. WordLink
5.2. Export Filters
5.2.1. XML (upCast DTD)
5.2.2. XHTML 1.0 (strict)
5.2.3. External CSS2
5.2.4. XML Validator
5.2.5. Commandline Processor
5.2.6. XSLT Processor
6. Menu Reference
6.1. File
6.2. Extras
6.3. Help
7. Configuration File Format Reference
7.1. General format description
7.2. Export Filter Preferences
7.3. Preference Keys Reference
8. BCF Reference
8.1. Using the built-in batch processor
8.2. General BCF file structure
8.3. Element Reference
8.4. Examples
9. upCast API Reference
9.1. Concepts
9.2. Using the API
9.3. General programming steps
9.3.1. Setup
9.3.2. The UpcastEngine object
9.3.3. Importing a document
9.3.4. Exporting a document
9.3.5. Setting global parameters
9.3.6. Cleanup
9.4. Method reference
10. Export Filter API
11. Inline Processor API
12. Section Processor API
13. RTF Conversion Technical Information
13.1. General
13.2. Bookmark Handling
13.3. Calculated fields
13.3.1. Simple fields (flat fields)
13.3.2. Nested fields (hierarchical fields, expressions)
13.4. The hidden element
13.5. Overview: Supported RTF Symbols
14. upCast DTD
15. Support file formats
15.1. stdfonts.config
15.1.1. Properties and Values
15.1.2. File structure
15.1.3. Matching Algorithm
15.2. Custom Encodings
15.2.1. How it works
15.2.2. Associating a Font with an Encoding
15.2.3. File format
15.3. Unicode translation map
15.4. CSS property unit table
15.5. XML Catalog
A. System Requirements
A.1. General
A.2. Windows 95/98/2000/NT/XP
A.3. Mac OS X
A.4. Unix/Linux/Solaris
B. Technical Support