.. _group__a3d__pdflib__functions:

#############################
PDF Library Session Functions
#############################

Starts, configures, and terminates a session with the PDF Library.

The functions in this section start and terminate a session with the PDF Library.


   The initialization and termination functions must be called only once during the life of the application. Attempting to initialize the PDF Library more than once in the application may cause errors or unpredictable behavior, and is not supported. You are free to create multiple documents and/or multiple files within the run, but the initialization and termination of the PDF Library is limited to one iteration of each.


**Parameters**


   **pcResourceDirectory**\ : The path of an existing directory with full resource definition as provided in the HOOPS Publish package. The path must be absolute, or must be relative to the location of your binary files. If relative, please make it start by a '.' or ".." character. Empty string ("") is valid but should be used very cautiously as not using resources can lead to unexpected behavior and crashes (see function description).


**Returns**


   A3D_SUCCESS in case of success or an error code


.. rst-class:: kind-group kind-function

.. rubric:: Functions
   :class: kind-group-title


.. rst-class:: api-xref-list


* :c:func:`~A3DPDFInitializePDFLibAndResourceDirectory`
* :c:func:`~A3DPDFTerminatePDFLib`
* :c:func:`~A3DPDFCheckPDFLibInitialization`

.. toctree::
   :maxdepth: 1
   :hidden:

   ../functions/A3DPDFInitializePDFLibAndResourceDirectory
   ../functions/A3DPDFTerminatePDFLib
   ../functions/A3DPDFCheckPDFLibInitialization


