Adobe V6 User manual

Datalogics

®

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.

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 Data-

logics, 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

[email protected]

Table of Contents

Contents.1

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

Related Documentation 1.4

2 Installing

the PDF Library and DLI 2.1

Supported Platforms and Compilers 2.2

Adobe PDF Library Installation Procedure 2.3

DLI Installation Procedure 2.21

Documentation Unpacking 2.22

Sample Jobs 2.25

3 Configure

Your Environment 3.1

Building with the Adobe PDF Library and DLI 3.2

Unresolved Symbol References on Unix 3.4

Accessing Font Information 3.5

Setting Environment Variables 3.6

Contents.2 Adobe PDF Library

1.1

1

About This

Guide

This guide describes the system components and

installation requirements for the Adobe PDF Library

(APDFL) and the Datalogics Interface (DLI). This guide

also includes information on how to configure the

development environment, and discusses application

considerations.

1.2

Adobe PDF Library Installation Guide

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 monospace.

• 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.)

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.

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.

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

access some material on the Adobe website. See

http://

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

for

more details.

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

1.6

Adobe PDF Library Installation Guide

2.1

2

Installing

the PDF Library and

DLI

This chapter covers installation procedures and lists

supported platforms and compilers.

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

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.

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)

ILEC C, C++ V5R1

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

MS Visual Studio C++ v6.0

or MS Visual Studio .NET

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.

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.

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.

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

Installing the PDF Library and DLI 2.7

the Browse button to select an alternate location.

6 Doublecheck the displayed installation location and click the Next button to proceed

NOTE: Versions of the Adobe PDF Library and DLI prior to APDFL v4.05 were placed

in

C:\Program Files\ by default. You should ensure that any old DLL files

and/or PATH definitions relating to the previous installations have been removed.

2.8

Adobe PDF Library Installation Guide

7 At this point InstallShield will begin the installation, displaying a Setup Status screen as it progresses:

8 When the completion screen appears, click the Finish button to conclude.

9 To install the documentation files, see “Documentation Unpacking” on page 2.22.

Page is loading ...

Adobe V6 User manual

Related papers

Other documents