ADDFRAMEINFO

typedef struct _ADDFRAMEINFO 
{ 
   L_UINT uStructSize; 
   pBITMAPHANDLE pBitmapFrame; 
   L_BOOL bKeepFrameState; 
   L_BOOL bUseMask; 
   COLORREF crMask; 
   L_UCHAR SmoothEdge; 
   L_INT nLocation; 
   L_INT nQuality; 
} ADDFRAMEINFO, *pADDFRAMEINFO; 

The ADDFRAMEINFO structure contains information about the frame to add to the bitmap.

Members

uStructSize

Size of this structure in bytes, for versioning. Use the sizeof() operator to calculate this value.

pBitmapFrame

Pointer to a bitmap handle that references the frame bitmap.

bKeepFrameState

Boolean flag that indicates the state of the frame bitmap. Possible values are:

Value Meaning
TRUE Keep the state of the frame bitmap and operate on a copy of the frame bitmap.
FALSE Work on the original frame bitmap so this bitmap may be resized during the L_AddFrame function. This is the default value.

bUseMask

Boolean flag that indicates whether to force the bitmap to be put on a specific region of the frame bitmap. Possible values are:

Value Meaning
TRUE Select a region on the frame bitmap with the same color specified in crMask and place the bitmap in this region.
FALSE Put the bitmap in the center of the frame bitmap. This is the default value.

crMask

COLORREF value used to specify the region on the frame bitmap, in which to put the bitmap. This value is used only if the bUseMask member is TRUE. The default value is black.

SmoothEdge

Value that indicates the amount to smooth the edge between the frame and the original bitmap. In most cases, useful values are 30 and 50. This value is used only when the bUseMask member is FALSE. The default value is 0.

nLocation

Flag that indicates the location of the frame with respect to the bitmap. Possible values are:

Value Meaning
FRAME_INSIDE [0] The frame will be within the original bitmap. This is the default.
FRAME_OUTSIDE [1] The frame will be outside the original bitmap.

nQuality

Flag that specifies the quality of the resulting bitmap. Possible values are:

Value Meaning
FRAME_QUALITY_LOW [0] Give the resulting bitmap normal quality.
FRAME_QUALITY_HIGH [1] Give the resulting bitmap high quality.

Comments

The structure is used by:

Help Version 21.0.2023.2.15
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.