C++ Syntax

bool

MKI_BitmapLibraryCalcFrame(

const LPCWSTR f_pszLibraryName,

__int32 f_nBitmapIndex,

MKI_CONST_MATRIX_PTR f_pMatrix,

MKI_RECT_REF f_rFrame );

Calculates the surrounding frame of a bitmap in the given library.

Parameters

LibraryName

[const LPCWSTR] Name of the library whose bitmap list shall be accessed. Fails if library name is MKI_BLOCK_ID.

BitmapIndex

[__int32] Zero-based index of the bitmap whose name shall be retrieved. Valid range: 0 <= Value < MKI_BitmapLibraryGetNumber.

Matrix

[MKI_CONST_MATRIX_PTR] Matrix with which the bitmap is to be temporarily multiplied before calculating the surrounding frame. If Matrix is nullptr, no temporary modification is performed. The bitmap itself will never be modified!

Frame

[MKI_RECT_REF] Address of a rectangle buffer to receive the calculated surrounding frame. The coordinates are sorted, i.e. x1 <= x2 and y1 <= y2.

Return Value

Returns true if successful. If false is returned, the rectangle pointed to by Frame is not modified.