L_StartFastMagicWandEngine

#include "l_bitmap.h"

L_LTIMGCOR_API L_INT EXT_FUNCTION L_StartFastMagicWandEngine(pMagicWnd, LeadBitmap, uFlags)

MAGICWANDHANDLE * pMagicWnd;

/* pointer to the magic wand handle */

pBITMAPHANDLE LeadBitmap;

/* pointer to bitmap */

L_UINT32 uFlags;

/* flags */

Starts the fast magic wand engine.

Parameter

Description

pMagicWnd

Pointer to a MAGICWANDHANDLE. This handle is needed to be used in the fast magic wand operation.

LeadBitmap

Pointer to the bitmap handle referencing the bitmap to perform the fast magic wand operation on.

uFlags

Reserved for future use. Must be 0.

Returns

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

Windows 2000 / XP, Windows VISTA.

See Also

Functions:

L_DeleteObjectInfo, L_EndFastMagicWandEngine, L_FastMagicWand, L_ObjectCounter, L_SetBitmapRgnMagicWand

Topics:

Raster Image Functions: Image Analysis

 

Processing an Image

Example

For an example, refer to L_FastMagicWand.