L_StartFastMagicWandEngine

#include "l_bitmap.h"

L_LTIMGCOR_API L_INT EXT_FUNCTION L_StartFastMagicWandEngine(pMagicWnd, LeadBitmap, uFlags)

Starts the fast magic wand engine.

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.