ImageGear v26.3 - Updated
ImageGear.Formats.Pdf Assembly / ImageGear.Formats.PDF Namespace / ImGearPDFDocument Class / SaveCompressed Method / SaveCompressed(Stream,ImGearCompressOptions) Method
Stream object to save to. Only FileStream and MemoryStream are currently supported.
Options used for compressing PDF document.




In This Topic
    SaveCompressed(Stream,ImGearCompressOptions) Method
    In This Topic
    Save highly-compressed PDF document to a System.IO.Stream object.
    Syntax
    'Declaration
     
    Public Overloads Sub SaveCompressed( _
       ByVal stream As Stream, _
       ByVal compressOptions As ImGearCompressOptions _
    ) 
    'Usage
     
    Dim instance As ImGearPDFDocument
    Dim stream As Stream
    Dim compressOptions As ImGearCompressOptions
     
    instance.SaveCompressed(stream, compressOptions)
    public void SaveCompressed( 
       Stream stream,
       ImGearCompressOptions compressOptions
    )
    public: void SaveCompressed( 
       Stream* stream,
       ImGearCompressOptions* compressOptions
    ) 
    public:
    void SaveCompressed( 
       Stream^ stream,
       ImGearCompressOptions^ compressOptions
    ) 

    Parameters

    stream
    Stream object to save to. Only FileStream and MemoryStream are currently supported.
    compressOptions
    Options used for compressing PDF document.
    Exceptions
    ExceptionDescription
    Thrown when stream is not writable.
    Remarks

    ImageGear 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. If saving a compressed PDF would result in an increase in file size, the original document is saved instead.

    Example
    See Also