LSegment::MrcLoadBitmap

Summary

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

Syntax

L_INT LSegment::MrcLoadBitmap(pszFileName, pBitmap, uStructSize, nPageNo)

Parameters

L_TCHAR * pszFileName

Character string containing the name of the file to load.

LBitmapBase * pBitmap

Pointer to the target LBitmapBase object that references 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.

Returns

Comments

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

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

Elements

• LSegment::MrcSaveBitmap
• LSegment::MrcSaveBitmapT44
• LSegment::MrcGetPagesCount
• Class Members

Topics

• General Segmentation
• Loading Capabilities

Example

The following is a simple example that uses LSegment::MrcLoadBitmap to load an MRC image.

L_INT LSegment__MrcLoadBitmapExample(LBitmapBase & Bitmap, L_TCHAR * pszFileName) 
{ 
   L_INT    nRet; 
   LSegment Segment; 
 
   // Load the image 
   nRet = Segment.MrcLoadBitmap(pszFileName, &Bitmap, sizeof(BITMAPHANDLE), 1); 
   if(nRet != SUCCESS) 
      return nRet; 
 
   return SUCCESS; 
}