L_MrcLoadBitmap

#include "ltsgm.h"

L_LTSGM_API L_INT L_MrcLoadBitmap(pszFileName, pBitmap, uStructSize, nPageNo, pfnCallback, pUserData)

L_TCHAR * pszFileName;

/* name of the file to load */

pBITMAPHANDLE pBitmap;

/* pointer to the target bitmap handle */

L_UINT uStructSize;

/* size in bytes, of the structure pointed to by pBitmap */

L_INT nPageNo;

/* page number */

FILEREADCALLBACK pfnCallback;

/* reserved for future use */

L_HANDLE pUserData;

/* reserved for future use */

Loads an MRC image file into a bitmap. The file can be in any supported image file format.

Parameter

Description

pszFileName

Character string containing the name of the file to load.

pBitmap

Pointer to the bitmap handle referencing the target bitmap.

uStructSize

Size in bytes, of the structure pointed to by pBitmap, for versioning. Use sizeof(BITMAPHANDLE).

nPageNo

The page number of a multi-page file, which can contain more than one image. When loading a file, this is the exact page number. For more information on multi-page files refer to Multipage File Formats.

pfnCallback

Reserved for future use. Pass NULL.

pUserData

Reserved for future use. Pass NULL.

Returns

SUCCESS

The function was successful.

<= 0

An error occurred. Refer to Return Codes.

Comments

This function loads the MRC image files that were saved using either LEAD Proprietary T44 Format or Standard T44 Format.

Note: You can also use L_LoadBitmap to load the MRC image file.

Required DLLs and Libraries

LTSGM

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_MrcSaveBitmapT44, L_MrcSaveBitmap, L_MrcGetPagesCount, L_MrcSegmentBitmap

Topics:

Loading Capabilities

 

MRC Bitmap Functions: Loading Pages

Example

L_INT MrcLoadBitmapExample(L_TCHAR* pszFileName,pBITMAPHANDLE  pBitmap)
{
   L_INT nRet;
   /* Load the MRC file that saved in the LEAD or Standard T44 format*/
   nRet = L_MrcLoadBitmap (pszFileName, pBitmap, sizeof(BITMAPHANDLE), 1, NULL, NULL);
   if (nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}