Objective-C 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. Objective-C

#import <CkoPdf.h>
#import <CkoJsonObject.h>

BOOL success = NO;

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

CkoPdf *pdf = [[CkoPdf alloc] init];
success = [pdf LoadFile: @"qa_data/pdf/grand_canyon_hiking_guide.pdf"];
if (success == NO) {
    NSLog(@"%@",pdf.LastErrorText);
    return;
}

//  Ask for the two options that are reserved for a later release.
CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateBool: @"mergeFontSubsets" value: YES];
[json UpdateBool: @"compactType1Fonts" value: YES];

CkoJsonObject *jsonOut = [[CkoJsonObject alloc] init];
success = [pdf Optimize: @"audit" jsonIn: json jsonOut: jsonOut];
if (success == NO) {
    NSLog(@"%@",pdf.LastErrorText);
    return;
}

int i = 0;
int numSkipped = [[jsonOut SizeOfArray: @"skipped"] intValue];
NSLog(@"%@%d",@"skipped: ",numSkipped);
while (i < numSkipped) {
    jsonOut.I = [NSNumber numberWithInt: i];
    NSLog(@"%@%@%@%@",@"   ",[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.