IG_batch_CB_register

In This Topic

This function registers one of two available batch callback functions.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_batch_CB_register( LPVOID lpfnBatchCB, AT_MODE nCBType, LPVOID lpPrivate );

Name	Type	Description
lpfnBatchCB	LPVOID	A far pointer to the scan callback function you would like to register.
nCBType	AT_MODE	Set to the type of callback being registered. Use one of the following ImageGear-defined constants: IG_BATCHCB_BEFORE_OPEN IG_BATCHCB_BEFORE_SAVE
lpPrivate	LPVOID	Optional pointer to from which to pass and receive data. Set this to NULL if this is not required.

Returns the number of ImageGear errors that occurred during this function call.

All pixel formats supported by ImageGear for C and C++.

None

This function registers one of two available batch callback functions.

LPFNIG_BATCH_BEFORE_OPEN is called before a file is opened, allowing you to get the file name and correct some settings. For example, some multimedia formats and PDF files require you to get the file name before converting a page.
LPFNIG_BATCH_BEFORE_SAVE is called before an image file is saved, allowing you to correct an image before saving it. For example, you might want to rotate an image before saving it.