int IMAPI ImgPlugInInvokeEx( hImage, hOwner, rect, lpData, bShowUI )

This causes the currently loaded plug-in to display its U/I or to begin processing of the image if the plug-in has no U/I.

 

Parameter	Type	Description
hImage	HANDLE	A handle to an ImageMan image handle.
hOwner	HWND	The handle of the parent window.
rect	RECT	The portion of the image that the filter is to perform its operations on or NULL for the entire image.
lpData	LPBYTE	Initialization data for the Plugin or NULL. This data is PlugIn specific.
bShowUI	BOOL	Specifies if the PlugIn should display it's User Interface.

 

Return Value

Return IMG_OK if successful, otherwise IMG_ERR and IMGPI_PLUGINERROR will be returned by ImgGetStatus().

Comments

You can only invoke a plug-in only on 24 bit raster images. You will get IMG_BAD_TYPE if you try this on a vector image or non-24bit image.

Example

int iErr;

if ( (iErr=ImgPlugInLoadSpecific(  coolplug.8bf )) == IMG_OK ) {

iErr = ImgPlugInInvokeEx( hImage, hWnd, NULL, NULL, TRUE ) ;

if ( iErr != IMG_OK ) {

ImgErrBox () ;

return ;

}

}

// now you can go on to draw the filtered image!

 

 

---

Copyright 2008 Data Techniques, Inc. All Rights Reserved