Objective-C Requires Chilkat v11.7.0+

Extract the OCR Text Layer of a Scanned PDF

See more PDF Text Extraction Examples

Demonstrates a scanned page that carries an invisible OCR text layer over the page image. The quality report identifies the page's textSource as "ocrLayer". The "invisibleText" filter is "auto" by default, which uses the invisible text only on pages that have no visible text; "exclude" ignores it. 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 (a page image with an invisible text layer, as an OCR program produces) is available at scanned_with_ocr.pdf

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

CkoJsonObject *json = [[CkoJsonObject alloc] init];
CkoJsonObject *jsonOut = [[CkoJsonObject alloc] init];

//  The page is a picture of a handwritten log with the OCR'd words drawn invisibly over it.
//  "auto" (the default) includes invisible text exactly in this case: on a page with no visible text.
success = [pdf ExtractText: @"text" jsonIn: json jsonOut: jsonOut];
if (success == NO) {
    NSLog(@"%@",pdf.LastErrorText);
    return;
}

NSLog(@"%@%@",@"textSource: ",[jsonOut StringOf: @"quality.pages[0].textSource"]);
NSLog(@"%@%@",@"rating: ",[jsonOut StringOf: @"quality.pages[0].rating"]);
NSLog(@"%@",[jsonOut StringOf: @"text"]);

//  The quality report flags the page, because OCR text is only as good as the OCR was.
NSLog(@"%@%@%@%@",@"issue: ",[jsonOut StringOf: @"quality.pages[0].issues[0].code"],@" - ",[jsonOut StringOf: @"quality.pages[0].issues[0].message"]);

//  "exclude" ignores invisible text altogether: the page then has no text at all.
[json UpdateString: @"invisibleText" value: @"exclude"];
success = [pdf ExtractText: @"text" jsonIn: json jsonOut: jsonOut];
if (success == NO) {
    NSLog(@"%@",pdf.LastErrorText);
    return;
}

NSLog(@"%@%@%@%@%@",@"With invisibleText excluded, textSource: ",[jsonOut StringOf: @"quality.pages[0].textSource"],@", text: [",[jsonOut StringOf: @"text"],@"]");

//  Sample output:

//  textSource: ocrLayer
//  rating: good
//  Keeper's Log, 12 October 1902
//  
//  Wind north-west, fresh. Lamp lit at 5.40 p.m. and burning well all night.
//  
//  Schooner Mary Ann passed inbound at 9 p.m. showing proper lights.
//  
//  Oil on hand: forty-one gallons. Cleaned the lens at dawn.
//  issue: ocrLayer - The text is an invisible OCR layer over an image
//  With invisibleText excluded, textSource: ocrLayer, text: []