Dart 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. Dart

import 'package:chilkat/chilkat.dart';

void main() {
  // 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

  final pdf = CkPdf();
  try {
    pdf.loadFile('qa_data/pdf/grand_canyon_hiking_guide.pdf');
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // Ask for the two options that are reserved for a later release.
  final json = CkJsonObject();
  json.updateBool('mergeFontSubsets', true);
  json.updateBool('compactType1Fonts', true);

  final jsonOut = CkJsonObject();
  try {
    pdf.optimize('audit', json, jsonOut);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  var i = 0;
  final numSkipped = jsonOut.sizeOfArray('skipped');
  print('skipped: $numSkipped');
  while (i < numSkipped) {
    jsonOut.i = i;
    print('   ${jsonOut.stringOf('skipped[i].option')} - ${jsonOut.stringOf('skipped[i].reason')}');
    i++;
  }

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