L_MrcSaveBitmapT44

Summary

Saves an MRC image contained in a bitmap to a file using the Standard T44 format.

Syntax

L_LTSGM_API L_INT L_MrcSaveBitmapT44(hSegment, pBitmap, pCmpOption, pszFileName, pfnCallback, pUserData, nFormat, pSaveOptions)

Parameters

HSEGMENTATION hSegment

An existing segmentation handle. This handle is obtained by calling the L_MrcStartBitmapSegmentation function.

pBITMAPHANDLE pBitmap

Pointer to the bitmap handle referencing the bitmap that holds the image data.

pCOMPRESSIONOPTIONS pCmpOption

Pointer to the COMPRESSIONOPTIONS structure that contains the compression information to use when saving the file.

L_TCHAR * pszFileName

Character string that contains the output file name.

FILESAVECALLBACK pfnCallback

Reserved for future use. Pass NULL.

L_HANDLE pUserData

Reserved for future use. Pass NULL.

L_INT nFormat

Output file format. Possible values are:

pSAVEFILEOPTION pSaveOptions

Pointer to optional extended save options. Pass NULL to use the default save options.

Returns

Comments

Use this function to save the given LEADImage bitmap in one of the standard T44 Formats: either as a Standard T44 format file (if the nFormat value is FILE_MRC) or as a TIF file with a MRC subtype format (if the nFormat value is FILE_TIF_MRC). When an nFormat value of FILE_MRC is used, *.MRC is the default file extension. When an nFormat value of FILE_TIF_MRC is used, *.TIF is the default file extension.

Use the L_MrcSaveBitmapT44 function to save a file if it is necessary that the file be readable by any application that supports the T44 standard.

Use the L_MrcSaveBitmap function to save a file in the LEAD Proprietary T44 format to:

• Take advantage of the greater number of different segment types available when using the proprietary format.

• Create smaller files than would be possible by saving them to the Standard T44 format.

• Create higher quality files than would be possible by saving them to the Standard T44 format.

Please note that when creating a Standard T44 format file (calling the L_MrcSaveBitmapT44 function using an nFormat value of FILE_MRC), only one page can be saved.

If segmentation has been performed, when the L_MrcSaveBitmapT44 function is called any 2-bit text, 2-bit grayscale, and 8-bit grayscale segments are treated as 24-bit image segments. If a text segment contains text over a background, when it is saved using the L_MrcSaveBitmapT44 function the background color is lost. For more information on Mixed Raster Content (MRC) formats, refer to General Information.

When using the L_MrcSaveBitmapT44 function, segments can be any of the following types:

SEGTYPE_BACKGROUND

SEGTYPE_ONECOLOR

SEGTYPE_TEXT_1BIT_BW

SEGTYPE_TEXT_1BIT_COLOR

SEGTYPE_PICTURE

Use the COMPRESSIONOPTIONS structure to set the compression to be used for the different types of segments.

It is best to perform segmentation before calling the L_MrcSaveBitmap function. Segmentation can be performed automatically by calling the L_MrcSegmentBitmap function, or performed manually by calling the L_MrcCreateNewSegment function. Call the L_MrcStartBitmapSegmentation function before calling any of the segmentation methods. When the handle to the segmentation is no longer needed, free it by calling the L_MrcStopBitmapSegmentation function. For more information on segmentation, refer to General Segmentation, Auto-Segmentation, and Manual Segmentation.

If the hSegment parameter is NULL, then the function will automatically segment the bitmap by calling the L_MrcSegmentBitmap function and then saves the MRC image file.

If the pCmpOption parameter is NULL, then the function will use Fax G4 compression for the mask layer, JPEG compression for the 24 bit image segments and 2 for the quality factor. The 2 bit text segments and the grayscale (2 bit and 8 bit) segments will be treated as 24 bit image segments. For more information, refer to COMPRESSIONOPTIONS.

Control page replacement/insertion operations by using some of the member values available in the SAVEFILEOPTION structure. When saving using an nFormat of FILE_MRC (where only one page can be saved), use the SAVEFILEOPTION.PageNumber member to designate the page number to be saved. When saving using an nFormat of FILE_TIF_MRC, use one of the following SAVEFILEOPTION.Flags values to specify what to do with the image being saved:

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_MrcSaveBitmap
• L_MrcLoadBitmap
• L_MrcGetPagesCount
• L_MrcSegmentBitmap

Topics

• Saving Capabilities
• MRC Bitmap Functions: Saving Bitmaps

Example

L_INT MrcSaveBitmapT44Example(HSEGMENTATION  hSegmentation, 
                                             pBITMAPHANDLE  pBitmap, 
                                             L_TCHAR*       pszFileName) 
{ 
   L_INT                nRet; 
   COMPRESSIONOPTIONS   CmpOption; 
 
   /* Initialize the compression structure */ 
   CmpOption.uStructSize      = sizeof(COMPRESSIONOPTIONS); 
   CmpOption.nMaskCoder       = MRC_MASK_COMPRESSION_FAX_G3_1D; 
   CmpOption.nPictureCoder    = MRC_PICTURE_COMPRESSION_JPEG; 
   CmpOption.nPictureQFactor  = 10; 
 
   /* Save the MRC bitmap using the Standard T44 Format */ 
   nRet = L_MrcSaveBitmapT44 (hSegmentation, pBitmap, &CmpOption, pszFileName, NULL, NULL, FILE_MRC, NULL); 
   if (nRet != SUCCESS) 
      return nRet; 
 
   return SUCCESS; 
}