In This Topic ▼

L_SetPDFInitDir

Summary

Overrides the default path of PDF initialization directories.

Syntax

#include "l_bitmap.h"

L_LTFIL_API L_INT L_SetPDFInitDir(pszInitDir)

Parameters

L_TCHAR* pszInitDir

Character string containing the new path of the initialization directory.

Returns

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

Comments

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

LtPdfu.dll (Win32), LtPdfx.dll (x64) is the DLL for PDF format. Use this DLL as any other file filter in LEADTOOLS, such as Lfbmpu.dll (Win32), Lfbmpx.dll (x64) for BMP support and Lftifu.dll (Win32), Lftifx.dll (x64) 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 LtPdfu.dll (Win32), LtPdfx.dll (x64) will look for LtPdfUtl.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.

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; 
}