Ruby Requires Chilkat v11.7.0+

Optimize a PDF Without Rewriting It (Incremental Update)

See more PDF Optimization Examples

Demonstrates the one combination of options that does not rewrite the file. With dropOldRevisions false and objectStreams "disable", the optimized objects are appended to the original bytes as an incremental update: every byte of the input is still there, byte for byte, followed by the changes and a new cross-reference section. That is what keeps an existing digital signature valid, and what lets a reader that has the original cached fetch only the tail. The file gets a little larger before it gets smaller, so this is for compatibility, not for size. Ruby

require 'chilkat'

success = false

#  This example requires the Chilkat API to have been previously unlocked.
#  See Global Unlock Sample for sample code.

#  The PDF used in this example is available at watersense_accomplishments.pdf

pdf = Chilkat::CkPdf.new()
success = pdf.LoadFile("qa_data/pdf/watersense_accomplishments.pdf")
if (success == false)
    print pdf.lastErrorText() + "\n";
    exit
end

json = Chilkat::CkJsonObject.new()
json.UpdateBool("dropOldRevisions",false)
json.UpdateString("objectStreams","disable")

jsonOut = Chilkat::CkJsonObject.new()
success = pdf.Optimize("optimize",json,jsonOut)
if (success == false)
    print pdf.lastErrorText() + "\n";
    exit
end

success = pdf.WriteFile("qa_output/watersense_incremental.pdf")
if (success == false)
    print pdf.lastErrorText() + "\n";
    exit
end

fac = Chilkat::CkFileAccess.new()
print "original: " + jsonOut.IntOf("fileSize").to_s() + "\n";
print "written:  " + fac.FileSize("qa_output/watersense_incremental.pdf").to_s() + "\n";

#  Everything the optimizer changed is in the appended part; the original bytes are the start of the
#  new file.  Any other combination of options -- dropOldRevisions, or generated object streams --
#  rewrites the document instead.
print "bytesSaved: " + jsonOut.IntOf("bytesSaved").to_s() + "\n";