L_SetPDFInitDir

Show in webframe

#include "l_bitmap.h"

L_LTFIL_API L_INT L_SetPDFInitDir(pszInitDir)

L_TCHAR* pszInitDir;

/* path of the initialization directory */

Overrides the default path of PDF initialization directories.

Parameter	Description
pszInitDir	Character string containing the new path of the initialization directory.

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:

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.
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_GetPDFInitDir
Topics:	Implementing PDF Plug in Features
	Raster Image Functions: Input/Output File Filters

Example

This example will show how to get the path of PDF initialization directories

 L_INT SetPDFInitDirExample(L_VOID)
{
   L_INT nRet;
   L_TCHAR *pszInitDir=NULL;
   pszInitDir = (L_TCHAR*)malloc(MAX_PATH*sizeof(L_TCHAR));
   nRet = L_GetPDFInitDir(pszInitDir, MAX_PATH);
   if(nRet != SUCCESS)
      return nRet;
   nRet = L_SetPDFInitDir(pszInitDir);
   free(pszInitDir);
   return nRet;
}