Attaching the PDF Component to Core ImageGear

To use the ImageGear PDF Component, you have attach this component to core ImageGear using the function IG_comm_comp_attach:

	Copy Code
IG_comm_comp_attach("PDF")

To check if the Component is attached successfully, use the function IG_comm_comp_check:

	Copy Code
IG_comm_comp_check("PDF")

This function (method) returns TRUE if the Component is attached.

Initializing the Component

To initialize the ImageGear PDF component, the "PDF" component needs to be attached to the ImageGear component manager. Then, each thread which uses PDF functionality must call IG_PDF_initialize. Please see Single- and Multi-Threaded Applications for additional 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)
Resource\PS\Fonts\	PS fonts directory
Resource\PS\ProcSet\	PostScript procedures
Resource\PS\ps.vm	A file for initialization 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

PDF Global Control Parameters

PDF.ENABLE_POSTSCRIPT

Used to enable/disable PostScript support in PDF component.

By default the ImageGear PDF Component enables PDF and PostScript file format support. But it is possible to disable PostScript file format support in case if it is not required. There is a boolean global parameter named PDF.ENABLE_POSTSCRIPT used to control this.

To disable PostScript use:

	Copy Code
AT_BOOL bEnable = FALSE; IG_gctrl_item_set( "PDF.ENABLE_POSTSCRIPT", AM_TID_AT_BOOL, &bEnable, sizeof(AT_BOOL), NULL );

Retrieving Info About the Component

To retrieve information about the attached Component, call the following function:

	Copy Code
IG_comm_comp_list(LPUINT *lpnCount, UINT nIndex, LPCHAR lpComp, DWORD dwCompSize, LPUINT lpnRevMajor, LPUINT lpnRevMinor, LPUINT lpnRevUpdate, LPCHAR lpBuildDate, UINT nBDSize, LPCHAR lpInfoStr, UINT nISSize)

Copy Code

      IG_comm_comp_list(LPUINT *lpnCount, UINT nIndex, LPCHAR lpComp, DWORD dwCompSize,
LPUINT lpnRevMajor, LPUINT lpnRevMinor, LPUINT lpnRevUpdate,
LPCHAR lpBuildDate, UINT nBDSize, LPCHAR lpInfoStr, UINT nISSize)

This function (methods) provides you with the full list of info about the component determined by nIndex index from the list of currently attached components whose number are returned trough lpnCount argument.

For more detailed information about these functions usage see Using ImageGear Component Manager section