IG_PDF_initialize

This function is used to initialize the ImageGear PDF Component.

Declaration:

AT_ERRCOUNT ACCUAPI IG_PDF_initialize(
    LPVOID lpVoid
);

Arguments:

Name	Type	Description
lpVoid	LPVOID	Reserved, must be set to NULL.

Return Value:

Error count

Supported Raster Image Formats:

This function does not process image pixels.

Example:

AT_ERRCOUNT ErrCount = 0;
static char* pdf_path = "[INSTALLDIR]\\ImageGear for C and C++ vXX\\Build\\Bin\\x64\\Resource\\PDF";
static char* ps_path = "[INSTALLDIR]\\ImageGear for C and C++ vXX\\Build\\Bin\\x64\\Resource\\PS";
IG_gctrl_item_set("PDF.PDF_RESOURCE_PATH", AM_TID_MAKELP(AM_TID_CHAR), (LPVOID)pdf_path, strlen(pdf_path) + 1, NULL);
IG_gctrl_item_set("PDF.PS_RESOURCE_PATH", AM_TID_MAKELP(AM_TID_CHAR), (LPVOID)ps_path, strlen(ps_path) + 1, NULL);
ErrCount += IG_PDF_initialize(NULL);
//...
ErrCount += IG_PDF_terminate();

Remarks:

To initialize the ImageGear PDF component it needs to be attached to the core ImageGear and then IG_PDF_initialize() function must be called.

For a multi-threaded application, you must call IG_PDF_initialize and IG_PDF_terminate in the main thread and in each worker thread which uses PDF component. See Single- and Multi-Threaded Applications for more information.

The following resource content is required by the ImageGear PDF component initialization routine:


Resource\PDF\CIDFont\	PDF CID fonts directory.
Resource\PDF\CMap\	PDF font CMaps directory.
Resource\PDF\Font\	PDF fonts directory.
Resource\PDF\Unicode\	PDF unicode mappings directory.
Resource\PS\ColorRendering\	Color rendering PostScript.
Resource\PS\ICCProfiles\	Directory containing the ICC profiles that allow using the Adobe® Color Engine® (ACE®). The profiles in this directory must be placed in the system folder, which on Windows is named \Windows\System32\Color.
Resource\PS\Fonts\	PS fonts directory.
Resource\PS\ProcSet\	PostScript procedures.
Resource\PS\ps.vm	A file for initializing the PostScript Interpreter's virtual memory.
Resource\PS\startupNORM.ps	Startup PostScript program used to initialize the PostScript Interpreter.
Resource\PS\superatm.db	Adobe® Type Manager® (ATM®) database used to substitute missing fonts.

ImageGear PDF component uses the following PDF global control parameters to locate resource content:


PDF.PDF_RESOURCE_PATH	Path to the Resource\PDF directory
PDF.PS_RESOURCE_PATH	Path to the Resource\PS directory
PDF.HOST_FONT_PATH	Path to the system font directory
PDF.TMP_PATH	Path to the TEMP directory

Examples provided below demonstrate setting and getting the value of PDF.PDF_RESOURCE_PATH control parameter.

// Path to the Resource\PDF directory.
char* szResourcePath = "C:\\PDF\\Resource\\PDF\\";

IG_gctrl_item_set("PDF.PDF_RESOURCE_PATH", AM_TID_MAKELP(AM_TID_CHAR), szResourcePath, (DWORD)strlen(szResourcePath) + 1, "");

// Get path to the Resource\PDF directory.
char szResourcePath[_MAX_PATH];

IG_gctrl_item_get("PDF.PDF_RESOURCE_PATH", NULL, (LPVOID)&szResourcePath, sizeof(szResourcePath) - 1, NULL, NULL, 0, NULL);

If the PDF global parameters are not defined, the ImageGear PDF Component behavior depends on the OS:

Resource content gets from the ImageGear component directory defined by COMM.PATH parameter
Host fonts get from the Windows font directory
Temporary directory gets from the GetTempPath() result