ADDFRAMEINFO

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

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

Member

Description

uStructSize

Size of this structure in bytes, for versioning. Use the sizeof() macro 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

This structure is used by the L_AddFrame function.