L_InetGetMagGlassData

#include "l_bitmap.h"
#include "ltnet.h"

L_LTNET_API L_INT L_InetGetMagGlassData(pBitmap, plColorSize, pColor, pMaskPlane, nMaskPlaneStart, nMaskPlaneEnd)

pBITMAPHANDLE pBitmap;

/* pointer to the bitmap handle */

L_UINT32 *plColorSize;

/* address of a variable to be updated with the length of pColor */

COLORREF * pColor;

/* address of COLORREF array to be updated */

L_UCHAR *pMaskPlane;

/* pointer to a buffer that will contain an array of bit flags */

L_INT nMaskPlaneStart;

/* start index of the mask plane array */

L_INT nMaskPlaneEnd;

/* end index of the mask plane array */

Gets the required bitmap pixel colors according to the pMaskPlane array. These colors are necessary for Magnifying Glass to paint the zoomed area.

Parameter

Description

pBitmap

Pointer to the bitmap handle referencing the bitmap from which to get Magnifying Glass data.

plColorSize

Address of a variable to be updated with the required length of the array to hold the required colors.

pColor

Address of the COLORREF array to be updated with the required colors that match the position of needed data on the mask plane array.

pMaskPlane

An array of bit flags which represents a mask plane, this array work as a plane for the parts of the bitmap that is updated or not yet.

nMaskPlaneStart

The start index of the mask plane array.

nMaskPlaneEnd

The end index of the mask plane array.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

If pColor is NULL, then plColorSize will be updated with the required size of the array to hold the required colors.

If pColor is not NULL, then plColorSize will contain the size of the colors copied into pColor and pColor will filled with the required colors.

You must initialize the LEADTOOLS Peer-to-Peer DLL using L_InetStartUp before calling this function.

Required DLLs and Libraries

LTNET

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

See Also

Functions:

L_InetSendGetMagGlassDataCmd, L_InetSendGetMagGlassDataRsp, L_InetShutDown

Topics:

Peer-to-Peer Functions

Example

For an example, refer to L_InetSetCommandCallback.