Adobe® PDF Library

Required components, Java and .NET applications

For .NET (Windows only), the application must have Datalogics.PDFL.dll and  DL180PDFLPINVOKE.dll.

For Java, the application must have:

  • com-datalogics-DL180PDFL.dll (Windows)
  • com-datalogics-DL180PDFL.so (Linux)
  • libcom-datalogics-DL180PDFL.jnilib (MacOS)
  • com.datalogics.PDFL.jar

The table below lists the rest of the distribution requirements.

Windows Linux MacOS
DL180PDFL.dll libDL180pdfl.so DL180pdfl.framework PDF Library primary DLL file
DL180ACE.dll libDL180ACE.so DL180ACE.framework Adobe Color Engine
DL180AdobeXMP.dll libDL180AdobeXMP.so DL180AdobeXMP.framework XMP metadata
DL180AGM.dll libDL180AGM.so DL180AGM.framework Adobe Graphics Manager printing engine
DL180ARE.dll libDL180ARE.so DL180ARE.framework Adobe Raster Express
DL180AXE8SharedExpat.dll libDL180AXE8SharedExpat.so DL180AXE8SharedExpat.framework XML processing
DL180BIB.dll libDL180BIB.so DL180BIB.framework Bravo interface binder
DL180BIBUtils.dll libDL180BIBUtils.so DL180BIBUtils.framework Bravo interface binder utilities
DL180CoolType.dll libDL180CoolType.so DL180CoolType.framework CoolType Typography Engine
DL180JP2K.dll libDL180JP2K.so DL180JP2K.framework JPEG2000 Library
icuuc68.dll (APDFL 18)
icucnv40.dll (APDFL 15)
libicuuc.68.so libicuuc.dylib International Components for Unicode
icudt68.dll (APDFL 18)
icudt40.dll (APDFL 15)
libicudata.68.so libicudata.dylib International Components for Unicode

Microsoft runtime libraries

For Windows applications, the Microsoft runtime libraries are required for both the Java and .NET interfaces. Include the .dll files from the Microsoft.VC141.CRT subdirectory in your application. It is important to use the runtime libraries supplied with the specific distribution to ensure the correct version will be found.

Plug-ins

There are three optional plug-ins with supporting library files:

DL180XPS2PDF.ppi XPS to PDF conversion
DL180PDFlattener.ppi Transparency Flattener
DL180PDFProcessor.ppi PDF/A and PDF/X conversions

These two library files are needed if you want to use the plug-ins:

Windows Linux MacOS
DL180pdfport.dll libDL180PDFPort.so DL180PDFPort.framework  
DL180pdfsettings.dll libDL180pdfsettings.so DL180pdfsettings.framework 

Max Speed Libraries (Windows only)

Recent versions Adobe PDF Library include an alternate set of the core DLLs built with different compiler options from the standard DLL files. These Maximum Speed Library files may improve system performance. They are found in the MaxSpeedLibs folder and may be used in place of the core DLLs found in the libs folder.

Note that the MaxSpeedLibs directory is only provided with Adobe PDF Library 15. The directory is no longer needed with APDFL 18.

Optical Character Recognition (OCR) processing

The Java and .NET interfaces for the Adobe PDF Library provide an Optical Character Recognition (OCR) feature that can recognize images in a PDF document. The OCR utility recognizes text within each image, and then allows you to save that text to a new PDF file, with that text underlaying the image where it was found.

The Adobe PDF Library uses the Tesseract 4 OCR Engine. The tessdata4 directory holds the language files to support OCR processing to identify text in images in PDF documents. The default languages offered include English, Dutch, French, German, Italian, Spanish, Portuguese, Mandarin, Japanese, and Korean, but many more languages are available:

https://github.com/tesseract-ocr/tessdoc/blob/master/Data-Files-in-different-versions.md

If you want to use OCR for processing documents in a different language, download the files you need from this repository:

https://github.com/tesseract-ocr/tessdata/tree/4.0.0

Move the files to the tessdata4 folder.

A pair of APIs to list the available languages for use with OCR processing and to determine if a specific language file are found in the tessdata4 folder.

Note that the OCR engine in Adobe PDF Library is only compatible with the Windows, macOS, and Linux 64-bit platforms.

The OCR engine library is stored in the Binaries directory, under Java and DotNET:

dltesseract4.dll Windows
libdltesseract4.so Linux
libdltesseract4.dylib macOS

Two sample programs show how to use OCR processing, AddTextToImage and AddTextToDocument. These samples are available for both Java and C# and are found in the OpticalCharacterRecognition folder for Java and C#.

Resources

The files found in the folders under Resources are used for a variety of operations, including creating/setting text and extracting or parsing content. Some of these are font files. Datalogics recommends that you include all of the resources in the Resources tree with your distribution. If, however, you need to limit the total size of the files included in your application, some of the components in the Resources folder can be removed.

  • Font. This folder includes a collection of fonts, including CJKV fonts. CJKV fonts are Multi-byte (16 bit) character fields mostly used by Chinese, Japanese, Korean, and Vietnamese characters. Thus a CJKV character is twice as wide as a normal single-byte character space. The double byte character field is needed because these languages have so many characters that a single 8 bit character field is not enough to represent all of them, but the font files that result tend to be larger than typical fonts. You can leave these files out of your distribution package if you will not be processing documents with CJKV content.
  • CMap. Some fonts in PDF files use predefined mappings between character encodings and specific, predefined character identifier sets. These mappings are called Character Maps (CMaps). We recommend that they all be included with your distribution, even though they can be quite large.
  • Joboptions. The Joboption file is only used by the XPS plug-in provided with the Library. You can leave this file out of your distribution if your application does not use this plug-in.
  • Color. This is used for rendering, printing, and conversion operations.
  • Unicode. Used for text extraction and for text conversion during printing, rendering, and conversion operations. Unicode is an international font standard.
  • tessdata4. This folder contains language files for applications that use the OCR engine.  It can be removed if OCR is not used.

The .NET and Java interfaces will look for the Resources folder under the primary deployment folder. The Font, CMap, Color, and Unicode path names can be specified during the Library initialization.