Adobe V6 User Manual

Installation Guide

Adobe PDF Library v6

Datalogics

ADOBE PDF LIBRARY

Installation Guide

This guide is part of the Adobe PDF Library v6.1.1 suite; 11/30/04. Copyright 1999-2004 Datalogics Incorporated. All Rights Reserved. Use of Datalogics software is subject to the applicable license agreement.

Datalogics Interface and Datalogics Java Interface are trademarks of Datalogics Incorporated. Other products mentioned herein as Datalogics products are also trademarks or registered trademarks of Datalogics, Incorporated. Adobe, Adobe PDF Library, Portable Document Format (PDF), PostScript, Acrobat, Distiller, Exchange and Reader are trademarks of Adobe Systems Incorporated. Microsoft, Windows and Windows NT are trademarks or registered trademarks of Microsoft Corporation. IBM, AIX, AS/400, OS/400, MVS, and OS/390 are registered trademarks of International Business Machines. HP and HP-UX are registered trademarks of Hewlett Packard Corporation. SAS/C is a registered trademark of SAS Institute Inc. Java, J2EE, J2SE, J2ME, all Java-based marks, Sun and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. UNIX is a registered trademark of The Open Group. Linux is a registered trademark of Linus Torvalds. All other trademarks and registered trademarks are the property of their respective owners.

For additional information, contact:

Datalogics, Incorporated 101 North Wacker Drive, Suite 1800 Chicago, Illinois 60606-7301

Phone: 312-853-8200 Fax: 312-853-8282

www.datalogics.com dlcomments@datalogics.com

Table of Contents

1 About This Guide 1.1

Introduction 1.2

The Purpose of This Book 1.2

What You Should Know 1.3

How This Book is Organized 1.3

Document Conventions 1.4

Introduction

This chapter explains the scope and contents of this guide, provides highlights of each chapter, describes

the organization of the information, and explains the conventions used throughout.

The Purpose of This Book

This guide is intended to provide information necessary to install and set up the Adobe PDF Library (APDFL) and Datalogics Interface (DLI). However, it is not a replacement of Adobe’s own Adobe PDF Library Overview document, but should be used as a supplement.

NOTE: Datalogics ports the Adobe PDF Library and DLI to the HP-UX, OS/390, OS/

400 and SGI IRIX platforms, but also supports the products on the original Adobe-

selected platforms. Except where noted, information in this Datalogics manual

applies to all platforms, not just those to which Datalogics has ported the

software.

About This Guide 1.3

What You Should Know

This book is not for developers new to application programming interfaces; therefore, it does not describe

programming concepts and techniques. The following list describes the level of experience or knowledge

required to understand this book:

• Product development knowledge in addition to programming, such as database and macro

development

• Familiarity with the process of writing applications

• Understanding of high-level language Application Programming Interfaces (APIs)

• Knowledge of programming on the specific platform of interest, including use of the corresponding

development tools

• A general understanding of the structure and contents of PDF files and the PostScript language

• Experience in managing fonts (the complete set of characters of a particular design), including the style,

arrangement and appearance of typeset matter for print or electronic display from composition

• Knowledge of the operating-system environment of the platform

You should have access to the Adobe PDF Library Applications Programming Interface (API) manual, related Datalogics Interface documentation, and the Adobe PDF Specifications manual for your system.

You should find these documents provided within your release, accessible via the referencelibrary.pdf document using the copy of Adobe Reader provided (or any other PDF

viewer utility).

The explanations and assumptions in this guide refer to Adobe PDF Library v6.1.1Plus and DLI v3.0 or

higher.

How This Book is Organized

The following list provides an outline of the chapters as well as a brief description of their contents. Click

on each Chapter title below to jump to its first page.

Chapter 1: "About This Guide" (This chapter) outlines the chapters to follow, explains the document

conventions used here, and lists other related documentation which you may find useful for your work.

Chapter 2: "Installing the PDF Library and DLI" provides installation procedures for Adobe

PDF Library and DLI by platform.

Chapter 3: "Configure Your Environment" describes how to configure your development

environment after installation and before incorporating the Library into your applications.

1.4

Adobe PDF Library Installation Guide

Document Conventions

The terms note, link and bookmark are used in this book the same way they are in the user interface of Adobe PDF Library v6.1.1Plus®, Adobe Acrobat® and Adobe Reader®. These correspond to the text annotation, link annotation and routine entry structures (respectively) that appear in a PDF file. See the

Portable Document Format Reference Manual for a description of the PDF file format.

The following documentation conventions appear throughout the manual to help you differentiate regular

text from product and program names, and to distinguish command syntax.

• Product and program names are set in italic type.

• Multi-line examples are separated from the text and set in

Courier monospace

• Directory names and filenames are contained within the text and set in Courier monospace.

• Commands are contained within the text and set in Courier mono space.

• New terms are italicized.

• Page numbers in this book do not correspond to page numbers in the PDF file. The numbering scheme

(e.g. 4.1 or A.10) indicates the chapter number (4) or appendix letter (A) first, followed by the page

number (1 or 10), separated by a period.

Related Documentation

The following documents will be useful in developing applications using DLI.

Datalogics Resources

Adobe PDF Library and DLI Installation Guide (This book) This document describes the installation requirements for using the Adobe PDF Library and DLI on the various platforms to which Datalogics has ported these products.

Adobe PDF Library Developer Overview This document is designed to aid developers with incorporating the API calls for the Adobe PDF Library into their composition application.

DLI Implementation and Reference Guide This document details the Datalogics Interface, a simplified interface to the COS Layer of the Adobe PDF Library.

Java Interface User Guide This document details the Datalogics Java Interface, a Java-language wrapper interface to the Adobe PDF Library and DLI.

About This Guide 1.5

Adobe Resources

The following documents are distributed by Adobe as part of the original Adobe PDF Library release, and

are redistributed by Datalogics without alteration. These and other documents may also be found on the Adobe website at http://partners.adobe.com/asn/acrobat/technotes.jsp. (Descriptions below are provided by Adobe as part of their original accompanying readme.txt file.)

NOTE: Adobe Solutions Network (ASN) membership may be required in order to

access some material on the Adobe website. See

partners.adobe.com/asn/programs/developer/index.jsp

more details.

Portable Document Format Reference Manual This document describes PDF Standard 1.5 specifications. The latest version may be found at http://partners.adobe.com/asn/tech/pdf/

specifications.jsp.

NOTE: Adobe also provides an accompanying errata file for this manual, with last-

minute updates and corrections. One copy is provided with this documentation

(see your documentation file folder), and you can check for newer copies at

http://partners.adobe.com/public/developer/en/pdf/ errata.txt

http://

for

Adobe PDF Library Overview Technical Note #5189 provides background information and development information for the Adobe PDF Library. Read this document before beginning development

for information such as supported platforms, known issues and development requirements.

Acrobat Core API Overview Technical Note #5190 provides an overview of the Acrobat API in

general. It covers information applicable to both Plug-in development and Library development. Read this

document to obtain an understanding of how the Acrobat API is organized.

AcroColor API Reference Technical Note #5425 explains the Host Function Table (HFT) that allows you to access the AcroColor Engine (ACE), which controls color profile.

Acrobat Core API Reference Technical Note #5191 is the reference manual for all of the Acrobat

API methods made available by the Acrobat Viewer. It documents the parameters, return values and

availability of each method, as well as specific implementation notes. This document is useful while developing with the Adobe PDF Library or planning development to determine method availability and

capabilities.

PDF Library Supplement to the Acrobat Core API Technical Note #5414 complements the Acrobat Core API Reference and is specific to the Adobe PDF Library API methods. This is an important and useful document for all Adobe PDF Library developers.

1.6

Adobe PDF Library Installation Guide

Installing

the PDF Library and

DLI

This chapter covers installation procedures and lists

supported platforms and compilers.

2.1

2.2

Adobe PDF Library Installation Guide

Supported Platforms and Compilers

The following table lists the supported platforms, operating system and compiler versions for the Adobe PDF Library and DLI. Except where noted, support for a higher version above and beyond that listed

below is not automatically implied. Please see “Notes on Supported Platforms and Compilers” on page

2.2 (below) for more details.

Table 2-1: Supported Platforms and Version Numbers

Platform Operating System Version Compiler and Version

HP IA32 32-bit HP/UX v11.23 acc 5.50

HP IA64 64-bit HP/UX v11.23 acc 5.50

HP PA-RISC HP/UX v11.0 acc 3.50

IBM AIX v5.1 gcc v3.3 for AIX Compiler

or XL C/C++ (VisualAge) compiler, version 6

IBM AS/400 OS/400 (Service programs distrib-

uted as V4R5-compatible)

IBM MVS OS/390 V2R9 (TBD) †

IBM USS Z/OS v1.2 and higher (TBD) †

IRIX v6.5 and higher gcc v3.3

Linux Red Hat 7.2 and 8.0 gcc v3.2

Macintosh Mac OS X Carbon CodeWarrior v8.3

Sun Solaris v8 and higher gcc v3.2

Windows (Intel) Windows NT 4.0 (Service Pack 6

and higher), 2000 or XP

ILEC C, C++ V5R1

MS Visual Studio C++ v6.0 or MS Visual Studio .NET

Notes on Supported Platforms and Compilers

1 The preceding table refers to Adobe PDF Library v6.1.x and DLI v3.x releases (and higher) only. If

building your application with a prior release, please consult its accompanying documentation.

2 Except where noted, the preceding table refers to 32-bit implementations only. 3 Datalogics distributes DLI with International Components for Unicode (ICU) v2.6. Depending on

your application and system configuration, it may be easier for you to use your own ICU build. Any of the v2.6.x series should be compatible with DLI, if it was built in a compatible manner (i.e.

corresponding tools and compiler).

4 † Compiler and Version for IBM MVS and USS platforms are to be determined.

Installing the PDF Library and DLI 2.3

Adobe PDF Library Installation Procedure

Platform-specific installation procedure notes follow below. After the code libraries have been installed,

documentation files should be unpacked in the appropriate areas. (They are not automatically installed as

part of the software.)

If you are reading this Installation manual prior to running the installation procedure itself (e.g. after downloading this manual from the Datalogics website), please continue with the installation of the

software release itself first, after which the documentation files can be unpacked into the directories

created during the software install, per the directions given in “Documentation Unpacking” on page 2.22.

Windows Installation

An installation directory will be delivered with the product on CD-ROM, or made available for download from a secure ftp user account on the Datalogics ftp site (ftp.datalogics.com). This directory contains all the files you will need to install the Adobe PDF Library and Datalogics Interface.

NOTE: Throughout this guide, vxxx is used to denote the version number of the

product, such as Adobe PDF Library v6.1.0Plus. This formula applies not only to the

product itself, but also to any generated files or directories which are associated

with and contain that version number.

Before beginning a new installation, you should uninstall any prior releases of Adobe PDF Library and Datalogics Interface. (InstallShield itself will check for current copies of the installation; see “Repetitive

Installations” on page 2.10 for further details.) Next, locate and double-click on the Setup.exe program, and InstallShield will guide you through the installation.

2.4

Adobe PDF Library Installation Guide

1 An initial setup screen will appear as InstallShield loads:

2 After InstallShield has initialized, a welcome screen will appear:

Click the Next button to proceed.

Installing the PDF Library and DLI 2.5

3 You must accept the License Agreement in order to continue with the installation:

Click the Yes button to proceed.

4 At the Customer Information screen, enter your User Name and Company Name in the corresponding

fields:

2.6

Adobe PDF Library Installation Guide

Accept the "Anyone" radio button if any users beside yourself will be using the application, or select

the "Only for me" (current user logged in) option if you are the only person who should be using the application.

5 Select the Setup Type and the destination folder:

While the Custom option does allow you to choose which program features you want installed, in

general practice we recommend installing all features at once. See “Selecting Features” on page 2.11

for further details. By default, InstallShield will place the new release under the C:\Datalogics\APDFLxxx\ directory structure, where "xxx" denotes the current Library version. (Thus a new release of Adobe PDF Library and DLI will typically reside at the same level as previous releases, not overwrite them.) Click

+ 40 hidden pages