Collapse All Expand All

L_GetPDFInitDir

#include "l_bitmap.h"

L_LTFIL_API L_INT L_GetPDFInitDir(pszInitDir, uBufSize)

L_TCHAR* pszInitDir;	/* path of the initialization directory */
L_SIZE_T uBufSize;	/* size in bytes of the data buffer pointed to by pszInitDir */

Retrieves the current path of the PDF initialization directories.

Parameter	Description
pszInitDir	Character string containing the PDF initialization directory path to update.
uBufSize	The size (in bytes) of the data buffer that pszInitDir points to.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

A PDF loaded as a raster image in LEADTOOLS is accomplished by two DLLs:

1. LTPDF?.dll is the DLL for PDF format. Use this DLL as any other file filter
   in LEADTOOLS, such as LFBMP?.dll for BMP support and LFTIF?.dll for TIF support.

2. LTPDFENGINE?.DLL is the engine runtime DLL. It contains many resources such as tables
   and fonts required to render a PDF image. This DLL is not referenced in a direct
   way by the file filter, instead it is loaded dynamically and out of a process. You
   must ensure that this DLL is present on the machine to support loading PDF files.
   By default, it is required to have this DLL in the same directory where the
   file filter is located. However, to share many instances of LTPDFENGINE?.dll between
   many applications, use the L_SetPDFInitDir method.

If you call this function with an empty string (length = 0), then the LTPDF?.dll
will look for LTPDFENGINE.dll in the same physical directory it currently resides in.

Required DLLs and Libraries

LTFIL File format DLLs For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64, Linux.

See Also

Functions:	L_SetPDFInitDir
Topics:	Implementing PDF Plug in Features
	Raster Image Functions: Input/Output File Filters

Example

For an example, refer to L_SetPDFInitDir.