SaveImageT44 Method

C#
Visual Basic
Objective-C
Java
C++

public void SaveImageT44( 
   RasterImage image,
   string fileName,
   MrcT44ImageFormat format,
   MrcCompressionOptions options,
   RasterCodecs codecs
)

'Declaration
 
Public Sub SaveImageT44( _
   ByVal image As RasterImage, _
   ByVal fileName As String, _
   ByVal format As MrcT44ImageFormat, _
   ByVal options As MrcCompressionOptions, _
   ByVal codecs As RasterCodecs _
)

'Usage
 
Dim instance As MrcSegmenter
Dim image As RasterImage
Dim fileName As String
Dim format As MrcT44ImageFormat
Dim options As MrcCompressionOptions
Dim codecs As RasterCodecs
 
instance.SaveImageT44(image, fileName, format, options, codecs)

public:
void SaveImageT44( 
   RasterImage^ image,
   String^ fileName,
   MrcT44ImageFormat format,
   MrcCompressionOptions options,
   RasterCodecs^ codecs
)

Parameters

image: MRC image to save.
fileName: The output file name.
format: The output file format.
options: Structure that contains the compression information to use when saving the file.
codecs: Extended saving options support

Use this method to save the given image in one of the standard T44 Formats either as a:

Standard T44 format file (if the format parameter is set to MrcImageFormat.Mrc).
TIF file with a MRC subtype format (if the format parameter is set to MrcImageFormat.MrcTif).

When format parameter is set to MrcImageFormat.Mrc, *.MRC is the default file extension.

When format parameter is set to MrcImageFormat.MrcTif, *.TIF is the default file extension.

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

Use the SaveImage method 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 this method using a format parameter set to of MrcT44ImageFormat.MrcT44), only one page can be saved.

If segmentation has been performed, when this method 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 this method the background color is lost. For more information on Mixed Raster Content (MRC) formats, refer to Working with the LEADTOOLS Mixed Raster Content (MRC) .NET Class Library.

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

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

It is best to perform segmentation before calling the SaveImage method.

Segmentation can be performed automatically by calling the SegmentImage method. or performed manually by calling the AddSegment method.

If the options parameter is empty, then the method 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 MrcCompressionOptions.

C#
Visual Basic
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Copy Code

Imports Leadtools
Imports Leadtools.Codecs
Imports Leadtools.Mrc

<TestMethod()> _
Public Sub SaveImageT44Example()
   ' Load an image
   Dim codecs As RasterCodecs = New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True
   Dim image As RasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "MRCSegmentation.mrc"))

   Dim segmenter As MrcSegmenter = New MrcSegmenter(image, Path.Combine(LEAD_VARS.ImagesDir, "MRCSegmentation.sgm"))

   Dim compressionOptions As MrcCompressionOptions = New MrcCompressionOptions()
   compressionOptions.MaskCoder = MrcMaskCompression.FaxG31D
   compressionOptions.PictureCoder = MrcPictureCompression.Jpeg
   compressionOptions.PictureQualityFactor = 10

   Try
      segmenter.SaveImageT44(image, Path.Combine(LEAD_VARS.ImagesDir, "Result.Mrc"), MrcT44ImageFormat.MrcT44, compressionOptions, codecs)
   Catch ex As Exception
      MessageBox.Show(ex.Message)
   End Try
End Sub

Public NotInheritable Class LEAD_VARS
Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class

using Leadtools;
using Leadtools.Codecs;
using Leadtools.Mrc;

[TestMethod]
public void SaveImageT44Example()
{
   // Load an image
   RasterCodecs codecs = new RasterCodecs();
   codecs.ThrowExceptionsOnInvalidImages = true;
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir,"MRCSegmentation.mrc"));

   MrcSegmenter segmenter = new MrcSegmenter(image,Path.Combine(LEAD_VARS.ImagesDir,"MRCSegmentation.sgm"));

   MrcCompressionOptions compressionOptions = new MrcCompressionOptions();
   compressionOptions.MaskCoder = MrcMaskCompression.FaxG31D;
   compressionOptions.PictureCoder = MrcPictureCompression.Jpeg;
   compressionOptions.PictureQualityFactor = 10;

   try
   {
      segmenter.SaveImageT44(image,Path.Combine(LEAD_VARS.ImagesDir,"Out_Result.Mrc"), MrcT44ImageFormat.MrcT44, compressionOptions, codecs);
   }
   catch(Exception ex)
   {
      MessageBox.Show(ex.Message);
   }
}

static class LEAD_VARS
{
public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
}

Target Platforms

Reference

MrcSegmenter Class
MrcSegmenter Members
SegmentImage Method
SaveImage Method
LoadImage Method
GetPagesCount Method
Save Method
SaveBitmapList Method
Programming with LEADTOOLS MRC