L_MrcLoadBitmap

Summary

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

Syntax

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

Parameters

L_TCHAR * pszFileName

Character string containing the name of the file to load.

pBITMAPHANDLE pBitmap

Pointer to the bitmap handle referencing the target bitmap.

L_UINT uStructSize

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

L_INT nPageNo

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

FILEREADCALLBACK pfnCallback

Reserved for future use. Pass NULL.

L_HANDLE pUserData

Reserved for future use. Pass NULL.

Returns

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; 
}