←Select platform

Insert(RasterImage) Method

Summary

Compresses the specified image, without segmenting it, and inserts the image in the PDF file.

Syntax

C++

public void Insert( 
   RasterImage image 
)

Public Overloads Sub Insert( _ 
   ByVal image As Leadtools.RasterImage _ 
)

public: 
void Insert(  
   Leadtools.RasterImage^ image 
)

Parameters

image
Image to be inserted in the PDF file.

Remarks

This method does not use MRC segmentation on the image being inserted into the PDF file. Use the SetCompression method to specify the compression for the segments. For more information, refer to Creating a Compressed PDF File.

Example

This example inserts an image into a PDF document by using user Segments.

using Leadtools; 
using Leadtools.PdfCompressor; 
using Leadtools.Codecs; 
 
public void pdfCompressor_SegmentImage_MrcSegmentsDocument(object sender, PdfCompressorSegmentImageEventArgs e) 
{ 
   //This will prevent addition to any segment with type background  
   if (e.Segment.Type == SegmentTypeFlags.Background) 
      e.Cancel = true; 
   else 
      e.Cancel = false; 
} 
 
public void PdfCompressorExample_MrcSegmentsDocument() 
{ 
   // 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(); 
 
   //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 | 
                            EnabledCompressionsFlags.EnablePicture; 
 
   pdfCompressor.SetCompression(compressionTypes); 
 
 
   PdfCompressorSegmentsInfo[] segmentInfo = new PdfCompressorSegmentsInfo[2]; 
   segmentInfo[0] = new PdfCompressorSegmentsInfo(); 
   segmentInfo[1] = new PdfCompressorSegmentsInfo(); 
   pdfCompressor.SegmentImage += new EventHandler<PdfCompressorSegmentImageEventArgs>(pdfCompressor_SegmentImage_MrcSegmentsDocument); 
   segmentInfo[0].Rectangle = new LeadRect(0, 0, 100, 100); 
   segmentInfo[0].Type = SegmentTypeFlags.Background; 
   segmentInfo[0].ValidColors = 1; 
   segmentInfo[0].Colors[0] = new RasterColor(0, 0, 0); 
 
   segmentInfo[1].Rectangle = new LeadRect(100, 100, 200, 200); 
   segmentInfo[1].Type = SegmentTypeFlags.Gray; 
   segmentInfo[1].ValidColors = 1; 
   segmentInfo[1].Colors[0] = new RasterColor(255, 255, 255); 
 
 
   pdfCompressor.InsertSegments(image, segmentInfo, false, new RasterColor(0, 0, 0)); 
   pdfCompressor.Write(Path.Combine(LEAD_VARS.ImagesDir, "Out_Image.pdf")); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images"; 
}

Imports Leadtools 
Imports Leadtools.PdfCompressor 
Imports Leadtools.Codecs 
 
Public Sub pdfCompressor_SegmentImage_MrcSegmentsDocument(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 
   Else 
      e.Cancel = False 
   End If 
End Sub 
 
Public Sub PdfCompressorExample_MrcSegmentsDocument() 
   ' 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() 
 
   '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 
 
   pdfCompressor.SetCompression(compressionTypes) 
   AddHandler pdfCompressor.SegmentImage, AddressOf pdfCompressor_SegmentImage_MrcSegmentsDocument 
   Dim segmentInfo As PdfCompressorSegmentsInfo() = New PdfCompressorSegmentsInfo(1) {} 
   segmentInfo(0) = New PdfCompressorSegmentsInfo() 
   segmentInfo(1) = New PdfCompressorSegmentsInfo() 
 
   segmentInfo(0).Rectangle = New LeadRect(0, 0, 100, 100) 
   segmentInfo(0).Type = SegmentTypeFlags.Background 
   segmentInfo(0).ValidColors = 1 
   segmentInfo(0).Colors(0) = New RasterColor(0, 0, 0) 
 
   segmentInfo(1).Rectangle = New LeadRect(100, 100, 200, 200) 
   segmentInfo(1).Type = SegmentTypeFlags.Gray 
   segmentInfo(1).ValidColors = 1 
   segmentInfo(1).Colors(0) = New RasterColor(255, 255, 255) 
 
   pdfCompressor.InsertSegments(image, segmentInfo, False, New RasterColor(0, 0, 0)) 
   pdfCompressor.Write(Path.Combine(LEAD_VARS.ImagesDir, "Image.pdf")) 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images" 
End Class

Requirements

Target Platforms

Reference

PdfCompressorEngine Class

PdfCompressorEngine Members

Overload List

SetCompression Method

InsertSegments Method

PdfCompressorOptions Structure

Help Version 19.0.2017.10.27

Leadtools.PdfCompressor Assembly

Introduction

Getting Started

Namespaces

Leadtools.PdfCompressor Namespace

Assemblies