Rust Requires Chilkat v11.7.0+

Why a PDF Optimization Was Skipped

See more PDF Optimization Examples

Demonstrates the "skipped" array, which lists the options that were asked for but not applied, each with a reason and, where it is page-specific, the pages. An option is skipped when it is reserved for a later release (mergeFontSubsets, compactType1Fonts), when the rules of the file forbid it (objectStreams in a PDF/A-1 file), or when the content could not be parsed safely (tidyContent and coalesceContent on a page whose content stream the parser does not understand). Nothing is ever changed on a guess: an option that cannot be applied safely is skipped and reported. Rust

// 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 grand_canyon_hiking_guide.pdf

let pdf = chilkat::Pdf::new();
if pdf.load_file("qa_data/pdf/grand_canyon_hiking_guide.pdf").is_err() {
    println!("{}", pdf.last_error_text());
    return;
}

// Ask for the two options that are reserved for a later release.
let json = chilkat::JsonObject::new();
let _ = json.update_bool("mergeFontSubsets", true);
let _ = json.update_bool("compactType1Fonts", true);

let json_out = chilkat::JsonObject::new();
if pdf.optimize("audit", &json, &json_out).is_err() {
    println!("{}", pdf.last_error_text());
    return;
}

let mut i = 0;
let num_skipped = json_out.size_of_array("skipped");
println!("skipped: {}", num_skipped);
while i < num_skipped {
    json_out.set_i(i);
    println!("   {} - {}", json_out.string_of("skipped[i].option").unwrap_or_default(), json_out.string_of("skipped[i].reason").unwrap_or_default());
    i = i + 1;
}

// A skipped option is not a failure: Optimize returns true, the other options are applied, and the
// report says exactly what was left undone.