Ruby Requires Chilkat v11.7.0+

Optimizing an Encrypted PDF

See more PDF Optimization Examples

Demonstrates optimizing a PDF that is encrypted. Set the password before loading, exactly as for any other operation; the optimized PDF keeps the security it had, so the output still needs the same password. Because Chilkat honours the permissions recorded in the document, optimizing requires owner rights or the "modify" permission: a PDF opened with a user password that forbids modification can be audited but not optimized. 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 encrypted_user_password.pdf

pdf = Chilkat::CkPdf.new()

#  The password must be set before loading.
pdf.put_UserPassword("secret")
success = pdf.LoadFile("qa_data/pdf/encrypted_user_password.pdf")
if (success == false)
    print pdf.lastErrorText() + "\n";
    exit
end

#  What security does the file have, and may it be modified?
json = Chilkat::CkJsonObject.new()
jsonOut = Chilkat::CkJsonObject.new()
success = pdf.Protection("getInfo",json,jsonOut)
if (success == false)
    print pdf.lastErrorText() + "\n";
    exit
end

print "encrypted: " + jsonOut.BoolOf("loaded.encrypted").to_s() + "\n";
print "method:    " + jsonOut.stringOf("loaded.method") + "\n";
print "openedWith: " + jsonOut.stringOf("loaded.openedWith") + "\n";
print "may modify: " + jsonOut.BoolOf("loaded.permissions.modify").to_s() + "\n";

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

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

print "bytesSaved: " + jsonOut.IntOf("bytesSaved").to_s() + "\n";

#  The output is still encrypted with the same security: loading it without the password fails.
noPassword = Chilkat::CkPdf.new()
success = noPassword.LoadFile("qa_output/encrypted_optimized.pdf")
q = Chilkat::CkJsonObject.new()
qOut = Chilkat::CkJsonObject.new()
success = noPassword.ExtractText("assess",q,qOut)
print "passwordRequired without the password: " + qOut.BoolOf("quality.passwordRequired").to_s() + "\n";

#  With the password it reads normally.
withPassword = Chilkat::CkPdf.new()
withPassword.put_UserPassword("secret")
success = withPassword.LoadFile("qa_output/encrypted_optimized.pdf")
if (success == false)
    print withPassword.lastErrorText() + "\n";
    exit
end

print "pages: " + withPassword.get_NumPages().to_s() + "\n";