L_SetPDFInitDir

#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:

  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.

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