SaveCompressed(String,ImGearCompressOptions) Method

Visual Basic
C#
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Overloads Sub SaveCompressed( _
   ByVal fileName As String, _
   ByVal compressOptions As ImGearCompressOptions _
)

'Usage
 
Dim instance As ImGearPDFDocument
Dim fileName As String
Dim compressOptions As ImGearCompressOptions
 
instance.SaveCompressed(fileName, compressOptions)

public void SaveCompressed( 
   string fileName,
   ImGearCompressOptions compressOptions
)

public: void SaveCompressed( 
   string* fileName,
   ImGearCompressOptions* compressOptions
)

public:
void SaveCompressed( 
   String^ fileName,
   ImGearCompressOptions^ compressOptions
)

Parameters

fileName: File name of file to be saved.
compressOptions: Options used for compressing PDF document.

ImageGear .NET improves the overall size of saved PDF documents by reducing or removing data structures in the PDF document, specifically:

Re-compress embedded bitonal Images to use lossless JBIG2 compression, which offers superior compression to either Flate or CCITTFax compression.
Re-compress embedded gray and color Images to use lossy sequential JPEG compression.
Re-compress LZW compressed Streams to use Flate compression.
Remove ASCII85 compression from Streams.
Compress uncompressed Streams to use Flate compression.
Optimize content Streams to share common sub-sequences.
Downsample high-resolution images, which may result reduce image quality when displayed zoomed-in.
Remove Thumbnail Images of PDF pages.
Remove embedded Standard Type 1 Fonts.
Merge identical Font descriptors and encodings.
Merge identical Forms and Images.
Remove symbols specific to deleted images from JBIG2 dictionaries.
Remove any unused Objects.

WARNING: Re-compressing Images with JBIG2 will invalidate PDF/X compliant documents.

WARNING: Removing embedded Standard Type 1 Fonts will invalidate PDF/X compliant documents.

WARNING: Removing embedded Standard Type 1 Fonts will invalidate PDF/A compliant documents when visible text is affected.

File size improvements will vary with each PDF file. In some cases, file size reduction is dramatic. Re-saving an optimized PDF file is not expected to further reduce its size. Less frequently, PDF file size may increase due to metadata that is always written when PDF documents are saved.

C#

using System;
using System.IO;
using System.Text;

using ImageGear.Core;
using ImageGear.Formats;
using ImageGear.Windows.Forms;
using ImageGear.Formats.PDF;

public String SaveCompressedPDFtoStream(String inputFileName, String outputFileName)
{
    // Load PDF document.
    ImGearPDFDocument pdfDocument = null;
    using (Stream fileStream = new FileStream(inputFileName, FileMode.Open,
       FileAccess.Read, FileShare.Read))
    {
        pdfDocument = (ImGearPDFDocument)ImGearFileFormats.LoadDocument(fileStream);
    }
 
    // Save compressed PDF document to stream.
    pdfDocument.SaveCompressed(outputFileName);
}

Visual Basic

Imports System
Imports System.IO
Imports System.Text

Imports ImageGear.Core
Imports ImageGear.Formats
Imports ImageGear.Formats.PDF

Public Sub SaveCompressedPDFtoStream(inputFileName As String, outputFileName as String)
 
    ' Load PDF document.
    Dim pdfDocument As ImGearPDFDocument
    Using fileStream As New FileStream(inputFileName, FileMode.Open, FileAccess.Read,
            FileShare.Read)
        pdfDocument = DirectCast(ImGearFileFormats.LoadDocument(fileStream),
                ImGearPDFDocument)
    End Using

    ' Save compressed PDF document to stream.
    pdfDocument.SaveCompressed(outputFileName)

End Function

Reference

ImGearPDFDocument Class
ImGearPDFDocument Members
Overload List