Xbase++ 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. Xbase++

LOCAL nSuccess
LOCAL oPdf
LOCAL oJson
LOCAL oJsonOut
LOCAL i
LOCAL nNumSkipped

nSuccess := 0

//  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

oPdf := CreateObject("Chilkat.Pdf")
nSuccess := oPdf:LoadFile("qa_data/pdf/grand_canyon_hiking_guide.pdf")
IF (nSuccess == 0)
    ? oPdf:LastErrorText
    oPdf:destroy()
    RETURN
ENDIF

//  Ask for the two options that are reserved for a later release.
oJson := CreateObject("Chilkat.JsonObject")
oJson:UpdateBool("mergeFontSubsets", 1)
oJson:UpdateBool("compactType1Fonts", 1)

oJsonOut := CreateObject("Chilkat.JsonObject")
nSuccess := oPdf:Optimize("audit", oJson, oJsonOut)
IF (nSuccess == 0)
    ? oPdf:LastErrorText
    oPdf:destroy()
    oJson:destroy()
    oJsonOut:destroy()
    RETURN
ENDIF

i := 0
nNumSkipped := oJsonOut:SizeOfArray("skipped")
? "skipped: " + Str(nNumSkipped)
DO WHILE i < nNumSkipped
    oJsonOut:I := i
    ? "   " + oJsonOut:StringOf("skipped[i].option") + " - " + oJsonOut:StringOf("skipped[i].reason")
    i := i + 1
ENDDO

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

oPdf:destroy()
oJson:destroy()
oJsonOut:destroy()