Java 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. Chilkat2 Java

import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.JsonObject;
import com.chilkatsoft.chilkat2.Pdf;

public class ChilkatExample {

    public static void main(String[] args) {
        // 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

        Pdf pdf = new Pdf();
        try {
            pdf.loadFile("qa_data/pdf/grand_canyon_hiking_guide.pdf");
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

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

        JsonObject jsonOut = new JsonObject();
        try {
            pdf.optimize("audit", json, jsonOut);
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }

        int i = 0;
        int numSkipped = jsonOut.sizeOfArray("skipped");
        System.out.println("skipped: " + numSkipped);
        while (i < numSkipped) {
            jsonOut.setI(i);
            System.out.println("   " + jsonOut.stringOf("skipped[i].option") + " - " + jsonOut.stringOf("skipped[i].reason"));
            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.
    }
}