Insert(RasterImage,PdfCompressorOptions) Method

Segments the specified image using Mixed Raster Content (MRC segmentation) and then compresses it and inserts it into the PDF file.
Public Overloads Sub Insert( _ 
   ByVal image As RasterImage, _ 
   ByVal options As PdfCompressorOptions _ 


Image to be inserted into the PDF file.

The PdfCompressorOptions structure that contains the options to be used to write the image to the PDF file.


This method will use segmentation for inserting the image into the Pdf file. If the SetCompression method is used, the segments will be compressed using the compression options specified by the method's PdfCompressorCompressionTypes structure. For more information, refer to Creating a Compressed PDF File.


This example inserts an image into a PDF document and uses the MRC to make a proper segment for this image.

using Leadtools; 
using Leadtools.PdfCompressor; 
using Leadtools.Codecs; 
public void pdfCompressor_SegmentImage_MrcDocument(object sender, PdfCompressorSegmentImageEventArgs e) 
   //This will prevent addition to any segment with type background  
   if (e.Segment.Type == SegmentTypeFlags.Background) 
      e.Cancel = true; 
      e.Cancel = false; 
public void PdfCompressorExample_MrcDocument() 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "MRCSegmentation.mrc")); 
   PdfCompressorEngine pdfCompressor = new PdfCompressorEngine(); 
   PdfCompressorCompressionTypes compressionTypes = new PdfCompressorCompressionTypes(); 
   PdfCompressorOptions pdfCompressorOptions = new PdfCompressorOptions(); 
   //Sets compression types needed for each segment 
   compressionTypes.Comp1Bit = PdfCompressor1BitCompression.Zip1Bit; 
   compressionTypes.Comp2Bit = PdfCompressor2BitCompression.Lzw2Bit; 
   compressionTypes.CompPicture = PdfCompressorPictureCompression.JpgPic; 
   compressionTypes.QFactor = 2; 
   //Flags for used compression types should be set 
   compressionTypes.Flags = EnabledCompressionsFlags.EnableOneBit | 
      EnabledCompressionsFlags.EnableTwoBit | 
   //Specify suitable profiles for input and output image 
   pdfCompressorOptions.ImageQuality = PdfCompressorImageQuality.ComputerGenerated; 
   pdfCompressorOptions.OutputQuality = PdfCompressorOutputQuality.Excellent; 
   pdfCompressorOptions.Flags = SegmentationOptionsFlags.FavorOneBit | 
   pdfCompressor.SegmentImage += new EventHandler<PdfCompressorSegmentImageEventArgs>(pdfCompressor_SegmentImage_MrcDocument); 
   pdfCompressor.Insert(image, pdfCompressorOptions); 
   pdfCompressor.Write(Path.Combine(LEAD_VARS.ImagesDir, "Out_Image.pdf")); 
static class LEAD_VARS 
   public const string ImagesDir = @"C:\LEADTOOLS21\Resources\Images"; 
Imports Leadtools 
Imports Leadtools.PdfCompressor 
Imports Leadtools.Codecs 
Public Sub pdfCompressor_SegmentImage_MrcDocument(ByVal sender As Object, ByVal e As PdfCompressorSegmentImageEventArgs) 
   'This will prevent addition to any segment with type background  
   If e.Segment.Type = SegmentTypeFlags.Background Then 
      e.Cancel = True 
      e.Cancel = False 
   End If 
End Sub 
Public Sub PdfCompressorExample_MrcDocument() 
   ' 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 pdfCompressor As New PdfCompressorEngine() 
   Dim compressionTypes As PdfCompressorCompressionTypes = New PdfCompressorCompressionTypes() 
   Dim pdfCompressorOptions As PdfCompressorOptions = New PdfCompressorOptions() 
   'Sets compression types needed for each segment 
   compressionTypes.Comp1Bit = PdfCompressor1BitCompression.Zip1Bit 
   compressionTypes.Comp2Bit = PdfCompressor2BitCompression.Lzw2Bit 
   compressionTypes.CompPicture = PdfCompressorPictureCompression.JpgPic 
   compressionTypes.QFactor = 2 
   'Flags for used compression types should be set 
   compressionTypes.Flags = EnabledCompressionsFlags.EnableOneBit Or EnabledCompressionsFlags.EnableTwoBit Or EnabledCompressionsFlags.EnablePicture 
   'Specify suitable profiles for input and output image 
   pdfCompressorOptions.ImageQuality = PdfCompressorImageQuality.ComputerGenerated 
   pdfCompressorOptions.OutputQuality = PdfCompressorOutputQuality.Excellent 
   pdfCompressorOptions.Flags = SegmentationOptionsFlags.FavorOneBit Or SegmentationOptionsFlags.WithBackground 
   AddHandler pdfCompressor.SegmentImage, AddressOf pdfCompressor_SegmentImage_MrcDocument 
   pdfCompressor.Insert(image, pdfCompressorOptions) 
   pdfCompressor.Write(Path.Combine(LEAD_VARS.ImagesDir, "Image.pdf")) 
End Sub 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\LEADTOOLS21\Resources\Images" 
End Class 

Target Platforms

Help Version 21.0.2021.3.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.PdfCompressor Assembly