LSegment::MrcLoadBitmap

#include "ltwrappr.h"

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

L_TCHAR * pszFileName;

/* name of the file to load */

LBitmapBase * pBitmap;

/* pointer to an LBitmapBase object */

L_UINT uStructSize;

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

L_INT nPageNo;

/* page number */

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

Returns

SUCCESS

The function was successful.

< 1

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.

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