Installation Guide Adobe PDF Library v6 Datalogics ®
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.
Contents.1 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 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.
Contents.
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.
1.2 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de 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).
About This Guide What You Should Know This book is not for developers new to application programming interfaces; therefore, it does not describe programming concepts and techniques.
1.4 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de 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.
About This Guide 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.
1.
2 Installing the PDF Library and DLI This chapter covers installation procedures and lists supported platforms and compilers. 2.
2.2 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de 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.
Installing the PDF Library and DLI 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.
2.4 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de 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 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.
2.6 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de 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.
Installing the PDF Library and DLI the Browse button to select an alternate location. 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. 6 Doublecheck the displayed installation location and click the Next button to proceed 2.
2.8 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de 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.
Installing the PDF Library and DLI By default, the Adobe PDF Library and DLI will be installed under C:\Datalogics\. The Adobe PDF Library is placed in C:\Datalogics\APDFLxxx\Apdfl\ (e.g. C:\Datalogics\APDFL6.1.0\Apdfl\). The Datalogics Interface is placed in C:\Datalogics\APDFLxxx\Dli\ (e.g. C:\Datalogics\APDFL6.1.0\Dli\) NOTE: Versions of the Adobe PDF Library and DLI prior to APDFL v4.05 were placed in C:\Program Files\ by default.
2.10 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de Repetitive Installations In order to avoid installing multiple copies of Adobe PDF Library on your machine, InstallShield detects whether a previous copy of this Adobe PDF Library version is already installed.
Installing the PDF Library and DLI Selecting Features During installation, while you are on the Setup Type installation screen, InstallShield will offer the option of selectively installing only certain portions of the Adobe PDF Library and DLI.
2.12 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de OS/400 Installation To install the Adobe PDF Library for OS/400, follow the steps below to restore the files. OS/400 releases are named PDFLvxxxPxx, where vxxx is the Library Version Number (e.g. 6.1.0) and Pxx is the Release Designation (e.g. P1d). 1 Create a directory on your C:\ drive called PDFLvxxx and extract the Savf file into it. 2 Log in to your OS/400. 3 Start PDM. 4 Select the Work With Libraries option.
Installing the PDF Library and DLI 7 Next, do a binary ftp of the SAVF file from your PC to your AS/400: C:\>ftp my400 Connected to my400.network.com. 220-QTCP at my400. 220 Connection will close if idle more than 5 minutes. User (my400.network.com:(none)): me999 331 Enter password. Password: mypass 230 me999 logged on. ftp> cd PDFL600P1D 250 "PDFL600P1D" is current library. ftp>bin ftp>put pdfl600P1d.savf pdfl600P1d 8 Now check the name of the SAVLIB for the SAVF file.
2.
Installing the PDF Library and DLI TESTBEDB *PGM CLP TEXTEXTRB THUMBS THUMBSB UNFILTERIB USEWIDTHSB *PGM *PGM *PGM *PGM *PGM CLP CLE CLP CLP CLP DLAPDFLACE *SRVPGM DLAPDFLAGM *SRVPGM DLAPDFLBIB *SRVPGM DLAPDFLCT *SRVPGM DLAPDFLDLI *SRVPGM DLAPDFLOPP *SRVPGM DLAPDFL60 *SRVPGM LIBASCII *SRVPGM CLE CPP H PROC SAMPLES TMP *FILE *FILE *FILE *FILE *FILE PF-SRC PF-SRC PF-SRC PF-SRC SAVF CLE DLI/Testbed compile & link DLI/UseWidths compile & link APDFL v6.1.0PlusP1d - ACE APDFL v6.1.
2.16 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de UNIX Installation Unix installations will typically contain both Adobe PDF Library and DLI release files in one .tar file. After downloading via ftp or copying the release from CD-ROM (depending on how you receive your software from Datalogics), select a high-level location for unpacking the release: e.g. /var, /opt, /var/ Datalogics or /opt/Datalogics. The release will unpack itself into directory trees under the current location.
Installing the PDF Library and DLI 3 Unpack each of the resulting .tar files in turn: 4 Subsidiary directories will be created as the unpacking process proceeds: 2.
2.18 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de 5 After unpacking the last .tar file, the directories and subdirectories should be fully populated: 6 Under the /var/Datalogics/APDFL6.1.0 (or similar) branch that was just created, locate the *.mak file (whichever one is appropriate for your platform) within /APDFL6.1.
Installing the PDF Library and DLI 7 Under the /var/Datalogics/APDFL6.1.0/Samples/utils (or similar) branch that you just created, locate and edit the appropriate *.mak file for your platform to point to the correct gcc and g++ locations, to ensure that make procedures will build correctly: 8 Do the same local modifications within /var/Datalogics/DLI/Samples/All to update gcc and g++ references in makefile.
2.20 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de 9 Finally, set the environment variables appropriately (as described in the next chapter): (See the appropriate listings for your platform in the section “Setting Environment Variables” on page 3.6) 10 At this point you should be able to build all samples by issuing a gmake command: 11 To install the documentation files on a Windows machine, see “Documentation Unpacking” on page 2.22.
Installing the PDF Library and DLI DLI Installation Procedure NOTE: In most cases, the DLI Installation procedures are part of the Adobe PDF Library installation process. You may only need to follow these steps if you are installing a DLI update separate from a Library delivery. Please see APDFL installation instructions for more information on DLI installation on those platforms.
2.22 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de Documentation Unpacking The Adobe PDF Library and DLI documentation suite is delivered in .zip file form, to be unpacked on a Windows machine in a tree directory structure that will allow quick reference, reading and searching of the various documents. Documentation should be extracted to the same C:\Datalogics\APDFLxxx\ location as that of the code installation.
Installing the PDF Library and DLI 2 Unpack the file with WinZip or comparable utility: 3 The folder names must be used when unpacking: 2.
2.24 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de 4 \Codesamples and \Documentation folders will be created as unpacking proceeds: 5 When complete, you can delete the referencelibrary.
Installing the PDF Library and DLI Sample Jobs Each product contains a collection of sample jobs illustrating various tasks. Each sample job is contained within its own subdirectory under its respective product, such as (on Windows platforms) C:\Datalogics\APDFLxxx\Apdfl\Samples\ or C:\Datalogics\APDFLxxx\Dli\Samples\. You may use the makefile.
2.
3 Configure Your Environment After the Adobe PDF Library and DLI have been installed, the development environment must be configured before you can incorporate the toolkits into your applications. 3.
3.2 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de Building with the Adobe PDF Library and DLI There are some platform-specific considerations that should be made when building and linking to the Adobe PDF Library and DLI. For more information regarding how to compile and link to the Adobe PDF Library, please see the Adobe PDF Library Overview manual. Notes on some specific platforms follow below. IBM AIX Adobe PDF Library v6.1.1Plus for IBM AIX is distributed only in dynamic-library form.
Configure Your Environment Linux Adobe PDF Library v6.1.1Plus for Linux is distributed in dynamic library form. When building with the Library: • Using GCC to drive the linker is highly recommended; ld is not. • The libstdc++ and libgcc are usually included in the shared libraries. Check with your Datalogics Support representative if you need them and cannot find them in your release.
3.4 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de Unresolved Symbol References on Unix Adobe distributes the Adobe PDF Library on several Unix platforms (AIX, Linux and Sun Solaris) built with GCC. Some developers have experienced unresolved symbol references when linking the Library into applications built with non-GCC C and C++ compilers. To resolve these references, if problems occur: 1 Obtain the GCC runtime library for the platform in question.
Configure Your Environment Accessing Font Information The standard fonts (also known as the Base 14 fonts) are assumed to be present on any machine handling PDF or PostScript documents. Those fonts are: • Courier • Courier-Bold • Courier-Oblique • Courier-BoldOblique • Helvetica • Helvetica-Bold • Helvetica-Oblique • Helvetica-BoldOblique • Times-Roman • Times-Bold • Times-Italic • Times-BoldItalic • Symbol • ZapfDingbats NOTE: PDF files that do not have embedded Base 14 fonts will have smaller file sizes.
3.6 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de Setting Environment Variables Resources must be specified by the methods presented in the Adobe PDF Library Overview manual. It is assumed that the resource specification will point to all necessary resources for the job. Specifying CMaps for PDWordFinder Use In particular, you should ensure that your application can find useful CMap files via its ACRO_RES_DIR definition whenever using PDWordFinder to extract text from a document.
Configure Your Environment HP IA32 Platform The following environment variables must be defined prior to building applications. Specifies the location of your CMap files; e.g. ACRO_RES_DIR setenv ACRO_RES_DIR /APDFL6.1.1/Resource/Cmap Also see important details in “Specifying CMaps for PDWordFinder Use” on page 3.6 (preceding). OS Operating System setenv OS ia32hpux CAUTION: As of Adobe PDF Library v6.1.1 and DLI v3.0.
3.8 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de HP IA64 Platform The following environment variables must be defined prior to building applications. Specifies the location of your CMap files; e.g. ACRO_RES_DIR setenv ACRO_RES_DIR /APDFL6.1.1/Resource/Cmap Also see important details in “Specifying CMaps for PDWordFinder Use” on page 3.6 (preceding). OS Operating System setenv OS ia64hpux CAUTION: As of Adobe PDF Library v6.1.1 and DLI v3.0.
Configure Your Environment HP PA-RISC Platform The following environment variables must be defined prior to building applications. Specifies the location of your CMap files; e.g. ACRO_RES_DIR setenv ACRO_RES_DIR /APDFL6.1.1/Resource/Cmap Also see important details in “Specifying CMaps for PDWordFinder Use” on page 3.6 (preceding). OS Operating System setenv OS hppahpux CAUTION: As of Adobe PDF Library v6.1.1 and DLI v3.0.
3.10 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de IBM AIX Platform The following environment variables must be defined prior to building applications. ACRO_RES_DIR Specifies the location of your CMap files; e.g. setenv ACRO_RES_DIR /APDFL6.1.1/Resource/Cmap Also see important details in “Specifying CMaps for PDWordFinder Use” on page 3.6 (preceding). LIBPATH A colon-separated list specifying all of your library file locations; e.g. setenv LIBPATH /APDFL6.1.
Configure Your Environment IBM AS/400 Platform The following environment variables are recommended in conjunction with your application’s dirlist settings. ACRO_RES_DIR Specifies the location of your CMap files. Also see important details in “Specifying CMaps for PDWordFinder Use” on page 3.6 (preceding). PSRESOURCEPATH Specifies a single location of all your fonts. When the SAVF is restored, an object (sample)B will be created.
3.12 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de IBM USS Platform The following environment variables must be defined prior to building applications. ACRO_RES_DIR Specifies the location of your CMap files; e.g. export ACRO_RES_DIR /APDFL6.1.1/Resource/Cmap Also see important details in “Specifying CMaps for PDWordFinder Use” on page 3.6 (preceding). LIBPATH A colon-separated list specifying all of your library file locations; e.g. export LIBPATH /APDFL6.1.
Configure Your Environment IRIX Platform The following environment variables must be defined prior to building applications. ACRO_RES_DIR Specifies the location of your CMap files; e.g. setenv ACRO_RES_DIR /APDFL6.1.1/Resource/Cmap Also see important details in “Specifying CMaps for PDWordFinder Use” on page 3.6 (preceding). A colon-separated list specifying all of your library file locations; e.g. LD_LIBRARY_PATH setenv LD_LIBRARY_PATH /APDFL6.1.
3.14 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de Linux Platform The following environment variables must be defined prior to building applications. ACRO_RES_DIR Specifies the location of your CMap files; e.g. setenv ACRO_RES_DIR /APDFL6.1.1/Resource/Cmap Also see important details in “Specifying CMaps for PDWordFinder Use” on page 3.6 (preceding). A colon-separated list specifying all of your library file locations; e.g. LD_LIBRARY_PATH setenv LD_LIBRARY_PATH /APDFL6.1.
Configure Your Environment Macintosh Platform The following environment variables must be defined prior to building applications. ACRO_RES_DIR Specifies the location of your CMap files; e.g. setenv ACRO_RES_DIR /APDFL6.1.1/Resource/Cmap Also see important details in “Specifying CMaps for PDWordFinder Use” on page 3.6 (preceding). A colon-separated list specifying all of your library file locations; e.g. LD_LIBRARY_PATH setenv LD_LIBRARY_PATH /APDFL6.1.
3.16 Ado be P DF L ibr a ry Ins ta ll a ti on Gui de Solaris Platform The following environment variables must be defined prior to building applications. ACRO_RES_DIR Specifies the location of your CMap files; e.g. setenv ACRO_RES_DIR /APDFL6.1.1/Resource/Cmap Also see important details in “Specifying CMaps for PDWordFinder Use” on page 3.6 (preceding). A colon-separated list specifying all of your library file locations; e.g. LD_LIBRARY_PATH setenv LD_LIBRARY_PATH /APDFL6.1.
Index.1 Index A Accessing Font Information 3.5 ACRO_RES_DIR on HP IA32 3.7 IA64 3.8 PA-RISC 3.9 on IBM AIX 3.10 AS/400 3.11 USS 3.12 on IRIX 3.13 on Linux 3.14 on Macintosh 3.15 on Solaris 3.16 Use with PDWordFinder 3.6 Adobe Acrobat 1.4 Adobe PDF Library Applications Programming Interface (API) manual 1.3 Document Conventions 1.4 Adobe Reader 1.3, 1.4 Adobe Technical Notes #5189 (Adobe PDF Library Overview) 1.5 #5190 (Acrobat Core API Overview) 1.5 #5191 (Acrobat Core API Reference) 1.
Index.2 Adobe PDF Library Installation Guide on Macintosh 3.15 on Solaris 3.16 LIBPATH on IBM AIX 3.10 USS 3.12 OS Caution on required definition 3.7, 3.8, 3.9, 3.10, 3.12, 3.13, 3.14, 3.15, 3.16 on HP IA32 3.7 IA64 3.8 PA-RISC 3.9 on IBM AIX 3.10 USS 3.12 on IRIX 3.13 on Linux 3.14 on Macintosh 3.15 on Solaris 3.16 Platforms HP IA32 3.7 IA64 3.8 PA-RISC 3.9 IBM AIX 3.10 AS/400 3.11 USS 3.12 IRIX 3.13 Linux 3.14 Macintosh 3.15 Other Platforms 3.16 Solaris 3.16 Windows 3.16 PSRESOURCEPATH on HP IA32 3.
Index MVS 2.2 USS 2.2 ICU (International Components for Unicode) Compatibility with DLI 2.2 Index files (for documentation) 2.22 Installation Procedures Documentation 2.3 OS/400 2.12 UNIX 2.16 DLI for UNIX 2.21 Windows 2.3 DLL File Placement 2.11 Documentation 2.22 Repetitive Installations 2.10 Selecting Features 2.11 Supported Platforms and Compilers 2.2 IRIX Setting Environment Variables 3.13 Supported Versions 2.2 L ld Use in Dynamic Building 3.2, 3.3 LD_LIBRARY_PATH 3.3 on IRIX 3.13 on Linux 3.
Index.4 Adobe PDF Library Installation Guide P PDF File format 1.4 PDFLDataRec 3.5 PDFLInit 3.5 PDWordFinder Reliance on ACRO_RES_DIR definition 3.6 Platforms, Supported 2.2 Portable Document Format Reference Manual 1.4 PSRESOURCEPATH on HP IA32 3.7, 3.9 IA64 3.8 on IBM AIX 3.10 AS/400 3.11 USS 3.12 on IRIX 3.13 on Linux 3.14 on Macintosh 3.15 on Solaris 3.16 pure.o 3.4 IA64 3.8 PA-RISC 3.9 Sun Solaris Linking on 3.3 Setting Environment Variables 3.16 Supported Versions 2.2 Symbol font 3.