JagPDF enables parallel composition of multiple documents in a single process. The only limitation is that the objects returned from JagPDF cannot be passed among threads. There is one exception to this rule - Profile object. A single Profile instance can be passed to multiple threads. However, Profile itself does not internally implement any synchronization so if you intend to modify a Profile instance concurrently you have to ensure synchronized access in order to prevent race conditions.

Python

Python uses the Global Interpreter Lock (GIL). In short, it means that only one thread that acquired GIL may operate on Python objects or call Python/C API functions.

This is not a limitation for JagPDF. Whenever the Python interpreter makes a call to JagPDF it releases GIL and calls the JagPDF core code which is written in C++ and does not interact with Python at all. When the call is finished the interpreter acquires GIL and continues executing Python code. As a result, if you are composing documents in a single process on multiple threads, despite GIL, the JagPDF core code can be executed truly concurrently which can improve scalability of your application.

Overview

Versions are denoted using a standard triplet of integers: MAJOR.MINOR.PATCH. The basic intent is that MAJOR versions are incompatible, large-scale upgrades of the API. MINOR versions retain binary compatibility with older minor versions, and changes in the PATCH level are perfectly compatible, forwards and backwards.

Run-time Checks

Use version() to determine the JagPDF version at run-time.

Compile-time Checks

A C/C++ application can be compiled with a different JagPDF version than it will be actually used in run-time. For that reason, compile-time constants are provided.

C/C++ Compile-time Version Constants

Compatibility Examples

	While some of the cells say no, it is possible that the versions may be compatible, depending very precisely upon the particular APIs used by the application.

Some functions accept an options string. It is a semicolon separated list of options. An option can be:

'value; keyword=value; array=1, 10, 100'