This document contains information on installing the Adobe PDF Library SDK, as well as general information regarding the release. In addition to this document, please read the PDF Library Overview for important information on developing with and using the PDF Library. See the Installation section below.

Major updates in Release X (10.1.1)

  • Fixed customer bugs
  • Added a new API -- "PDPageDrawContentsToWindowEx2()" which allows user to specify double precision drawing regions

Major updates in Release X (10.1)

  • Enabled compatibility with Acrobat X (10.1.1) -- Added a new PDFProcessor plug-in (for Windows) to convert an existing PDF into a PDF/A-1b compliant file
  • Added the new API “PDFlattenerConvertEx2” in Flattener-Plugin which allows the users to specify a Blending Color-Space for flattening transparent objects
  • Enhanced the existing API “PDPageDrawContentsToMemoryEx“ to specify a Blending Color-Space while using DrawToMemory workflow
  • Added two new parameters in PDFLDataRec structure to take custom color profile directory paths from clients
  • Added two color profile resource files at /Resource/Color/Profiles
  • Updated samples for new plug-in and color profile directory paths
  • Fixed customer bugs

Major updates in Release X (10.0.1)

  • Fixed bugs
  • Added Windows specific LOGFONTW structure, defining font attributes, to PDFEdit Layer's PDSysFontPlatData structure

Major updates in Release X

  • Enabled compatibility with Acrobat X
  • Added APIs to PDFEdit Layer which enable higher precision editing, by providing ASDouble support to existing ASFixed API
  • Improved editing of PDF files to reduce content loss
  • Added the new API "PDPageDrawContentsToMemoryEx()" which enables rendering of a huge page with high resolution, by handling loss of precision when using the DrawToMemory workflow
  • Added support for more than 27 spot colors in printing workflow (non-transparent) and ink enumeration
  • Improved print output to bring it closer to Acrobat X
  • Provided support for Linux 64-bit platform (PDF Library only)
  • Fixed bugs
  • Updated samples for new and updated APIs

Known issues

The following is a list of open issues in PDF Library SDK X (10.1.1):

  • The Jar and HTML interface of SnippetRunner do not work in PDFL SDK X.

As a workaround, one can use SnippetRunner by running the executable directly.

Status of Print functionality

  • PDFLPrintDoc()honors only default values for tilingMode (kPDNoTiling).
  • emitShowPage is not honored anymore. It is always true.
  • emitDSC is not honored anymore. It is always true.
  • brokenCRDs is not honored anymore. It is always false.
  • incProcsets is not honored anymore. It is always false.
  • Default value for useSubFileDecode is false. The SubFileDecode filter will always be emitted if printing in binary format.
  • emitColorSeps will be honored only when printing to a printer.
  • On setting transparencyQuality = 0, a PDF file with vector data will be rasterized. Set it to 80 for non-rasterized output as in PDFL SDK 7.0.
  • For printing to a printer, the %%DocumentData DSC comment will only represent the output protocol of the printer and will not be dependent on the binaryOK parameter provided by the client.
  • The kPDPageEmitSlurMarks enumeration in whichMarks is now obsolete.
  • The TTasT42 parameter is valid only for the Export to PS workflow and not for printing to a printer. The default value is false.
  • applyOCGPrintOverrides is no longer honored. It is always considered as true whatever may be the value passed to it.
  • The grayToK parameter has been introduced to convert gray (c,m,y,k) to K-only cmyk values (0,0,0,k).
  • The following callbacks are not supported in PDDocPrintPages():
    • EmitFont()
    • DataSourceString()
    • EmitPrologResolurce()
    • DocBegin()
    • EmitPageContents()
    • EmitPrologString()
    • EmitPSFontBegin()
    • GetFontVMUsage()
    • UndefineFont()
  • PDFontDownloadContextCreate() does not work. It always returns NULL.

Note: Avoid the use of PDDocPrintPages(). Instead, use the higher-level pdflprintdoc() method.

Getting started

  1. Install the PDF Library SDK as described in the Installation section.
  2. Read the PDF Library Overview, which describes the PDF Library and development issues with the PDF Library.
  3. Examine, compile, and run the relevant code samples or snippets for your platform. The code samples and the SnippetRunner are in the PDFLSDK10. 1/samples directory that is created when you install the Library.
  4. On all platforms, read the comments in the source code before compiling and running the code sample to understand the functionality demonstrated by the sample.

The following platforms, operating systems, and compilers are supported by PDFL SDK X (10.1.1):

Platform Processor Operating System Compilers
Windows 32-bit and 64-bit
Intel
Windows XP (32-bit), Windows 7(32-bit & 64-bit)
Microsoft Visual Studio 2008 SP1
 
Linux 32-bit and 64-bit
Intel
Red Hat WS 4
gcc 4.1.0
 
Mac 32-bit
Mactel
Mac OS Leopard 10.5
Mac OS Snow Leopard 10.6
XCode 3.2
 

Important: While it may be possible to use the library in other development environments, such use is not supported by Adobe. The PDF Library has been tested only with the compiler versions listed in the table above.

Installation

All platforms:

The following is the directory structure for all platforms:

/PDFLSDK10.1.1 /Docs /Include /Headers /Source /Libs /Platform /Resource /Samples /samples_name /Plugins /Flattener /Include /Headers /Libs /Platform /Samples /PDFProcessor /Include /Headers /Libs /Platform /Samples / XPS2PDF /Include /Headers /Libs /Platform /Resource /joboptions /Samples

Modify the MyPDFLibUtils.cpp file so that the folder lists passed to PDFLDataRec's dirList, cMapDirectory,unicodeDirectory,and colorProfileDirList members in the PDFLInit()via PDFLGetDirList, PDFLGetCMapDir, PDFLGetUnicodeDir, and PDFLGetColorProfileDirList function calls correctly locate the font, CMap ,unicode, color profile files on your system. This is needed for samples that  require font, CMap, unicode, or color profile files.

Important: Samples are tested and built with the valid values in the PDFLDataRec structure. If you do not have the valid font, CMap, unicode, or color profile folders on your system, samples may crash or throw an exception. You must either install the font, CMap, unicode and color profile files in the correct folder or you must pass NULL to these members in order for the PDF library not to look for the fonts, CMaps, unicode, or color profile files.

Installing on Windows:

  1. Do one of the following:
    • For standard version of the PDF Library SDK, use the installer
      WinPDFL10.1.1SDKminSize.exe
    • For the speed-optimized version of the PDF Library SDK, use the installer
      WinPDFL10.1.1SDKmaxSpeed.exe

      Using the Typical Install option ensures that all samples build and run.

      Important: You must install only one version of the PDFL SDK Library at a time. Before installing another version of the PDFL SDK Library, the previous version of the library must be uninstalled using the Windows Add/Remove Programs option.

      To ensure that applications run successfully outside the Microsoft Visual Studio C++ .NET IDE, make sure that the executables always find the dynamic linked libraries at run time. Do one of the following:

      • Copy the libraries supplied in the Libs folder to the folder where your executable resides.
      • Place the path for the libraries into the PATH environment variable.

      To ensure that the plugins run successfully, do one of the following:

      • Copy the libraries supplied in the Plugins\[PluginName]\Libs folder to the folder where your executable resides.
      • Place the path for the libraries into the PATH environment variable.
  1. Executing SnippetRunner in UI mode (64-bit): You must explicitly set 64BitMode parameter to 1 in the pdflsdk.config file in your home directory. This variable is initialized to 0 (zero) by default.

Installing on UNIX:

  1. Copy the SDK file to a directory.
  2. Run the following command in the directory that you want to unpack the SDK to:
    Linux: gunzip < linuxpdfl10.1.1sdk.tar.gz | tar xvf
  3. Change directory to PDFLSDK10.1.1/Samples/utils and modify the appropriate .mak file to point to your installed gcc directory and static library directories.
  4. Set the environment variable LD_LIBRARY_PATH to point to PDFLSDK10.1.1/Libs/linux.
  5. Important: PDF Library is dynamically linked with libgcc and libstdc++ libraries on Linux. These libraries are released in PDFLSDK10.1.1/Libs/linux.

Installing on Mac OS:

Run the installer for the MacPDFL10.1.1SDK.dmg.

By default, all libs are installed in the PDFLSDK10.1.1:Libs:Mac:AdobeXXX.framework folder. Aliases or proper paths must be set to ensure that the sample applications run properly.

Documentation

The following documents are available in the /PDFLSDK10.1.1/Docs folder created once the installer is run:

  1. PDF Reference and Related documentation, Sixth Edition (pdf_reference.pdf):  This PDF Portfolio contains the documents that describe the PDF standard supported by Adobe Acrobat X. It includes these documents:
  2. PDF Reference, sixth edition, version 1.7 (Nov. 2006)

    PDF Redaction: Addendum to the PDF Reference, sixth edition, version 1.7

    Errata for the PDF Reference, sixth edition, version 1.7

    Adobe Supplement to the ISO 32000, BaseVersion 1.7, ExtensionLevel 3 (for Acrobat X)

    Technical documentation (detailed in point 2 below) provided with the Adobe PDF Library is available in the /PDFLSDK10.1.1/Docs folder as well as the following URL:

    http://livedocs.adobe.com/pdfl_sdk/10/PDFL_SDK10_HTMLHelp/index.html

  3. The following documents are available in HTML form in the PDFL_SDK10_1_1_HTMLHelp.zip file for Windows. They are also available in the file PDFL_SDK10_1_1_HTMLHelp.tar.gz for UNIX. Extract the file (ignore checksum warnings) in /PDFLSDK10.1.1/Docs /PDFL_SDK10_1_1_HTMLHelp folder. The following documents can be viewed by opening the index.html file in a web browser:
  4. Acrobat and PDF Library API Reference: This document is the reference manual for all APIs exposed by both the PDF Library and Acrobat. Thus, it includes APIs that are common to both PDF Library and Acrobat, as well as APIs that are specific to each.

    Developing Plug-ins and Applications: This is a developer guide for creating PDF Library applications as well as plug-ins for Acrobat.

    Snippet Runner Cookbook: Guide for installing and running SnippetRunner, using the Common Interface, and writing snippets.

    PDF Library Overview: Provides an introduction to development using Adobe PDF Library.

Web access and support

General information about the Adobe PDF Library is available here. For further details, contact your Adobe representative.

Copyright ­­­­­­­­­­­­­­­­­­1984-2012 Adobe Systems Incorporated and its licensors.  All rights reserved.

Adobe, the Adobe logo, Acrobat, the Adobe PDF logo, Distiller and Reader are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. All other trademarks are the property of their respective owners.

<AdobeIP#0001622>

Third party software notices and/or additional terms and conditions

Information about the third party license is available here.