L_StartFastMagicWandEngine (original) (raw)
Summary
Starts the fast magic wand engine.
Syntax
#include "l_bitmap.h"
L_LTIMGCOR_API L_INT EXT_FUNCTION L_StartFastMagicWandEngine(pMagicWnd, LeadBitmap, uFlags)
Parameters
MAGICWANDHANDLE * pMagicWnd
Pointer to a MAGICWANDHANDLE. This handle is needed to be used in the fast magic wand operation.
pBITMAPHANDLE LeadBitmap
Pointer to the bitmap handle referencing the bitmap to perform the fast magic wand operation on.
L_UINT32 uFlags
Reserved for future use. Must be 0.
Returns
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
Comments
The L_StartFastMagicWandEngine function must be called before calling the L_FastMagicWand and L_EndFastMagicWandEngine functions.
When the handle to the MAGICWANDHANDLE is no longer needed, it should be freed by calling L_EndFastMagicWandEngine. For every call to L_StartFastMagicWandEngine there must be a call to L_EndFastMagicWandEngine.
This function supports 1, 8, and 24-bit images.
This function does not support 32-bit grayscale images. It returns the error code ERROR_GRAY32_UNSUPPORTED if a 32-bit grayscale image is passed to this function.
Required DLLs and Libraries
- LTIMGCOR
- 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, Linux.
See Also
Functions
Topics
Example
For an example, refer to L_FastMagicWand.
LEADTOOLS Raster Imaging C API Help