SaveList method (ILEADRasterIO)

Remarks

(Document/Medical only) Saves MRC images contained in a bitmap list to a file using the MRC LEAD, standard Proprietary T44 or PDF format.

Use this method to save a list of bitmaps as a TIF file using the Standard T44 format (if the nFormat value is FILE_TIF_MRC), as a TIF file with a LEAD MRC subtype format (if the nFormat value is FILE_TIF_LEAD_MRC), or as a multipage PDF using segmentation capabilities (if the lFormat value is FILE_PDF_LEAD_MRC). If lFormat is FILE_TIF_MRC or FILE_TIF_LEAD_MRC, *.TIF is the default file extension. If lFormat is FILE_PDF_LEAD_MRC, *.PDF is the default file extension.

Use the SaveList method to save a list of bitmaps as a TIF file with a Standard T44 subtype format, LEAD MRC subtype format, or PDF file, based on the LEAD segmentation technique, if you want 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.

All formats supported by this method generate multi-page files (TIF, or PDF). The number of pages in the file is either the value in MRCRasterCount property or the number of images in pRaster, whichever is smaller.

Use the SaveT44, or Save methods to save a single image or to append, inset overwrite to already existing TIF file.

It is best to perform segmentation for all images in the list before calling the SaveList method. Segmentation can be performed automatically by calling the AutoSegmentExt method, or performed manually by calling the CreateNewSegment method.

When using the SaveList method, segments can be any of the following types:

SEGTYPE_BACKGROUND

SEGTYPE_ONECOLOR

SEGTYPE_TEXT_1BIT_BW

SEGTYPE_TEXT_1BIT_COLOR

SEGTYPE_TEXT_2BITBW

SEGTYPE_TEXT_2BIT_COLOR

SEGTYPE_GRAYSCALE_2BIT

SEGTYPE_GRAYSCALE_8BIT

SEGTYPE_PICTURE

Each element in MRCRaster array will contains a segment for each bitmap in the pRaster.

If there is an element in the MRCRaster array that does not contain a segment then the method will automatically segment the bitmaps in pRaster by calling AutoSegmentExt method. The AutoSegmentExt method maps the text, grayscale and picture segments into layers (mask, background and foreground layers) as defined in the NLS* model of the T.44 standard. A segment is a rectangular area on the bitmap that can be classified as text, grayscale, or picture, depending on the number of colors used in its area. The Mixed Raster Content (MRC) format was developed by the International Telecommunications Union as part of ITU-T Recommendation T.44. For more information on Mixed Raster Content (MRC) formats, refer to General Information.

Note that the Grayscale2BitCoder, Grayscale8BitCoder, and the Grayscale8BitQFactor properties are used only with the FILE_TIF_LEAD_MRC formats. The Text2BitCoder property is used with the FILE_TIF_LEAD_MRC and FILE_PDF_LEAD_MRC formats only.

See Also