Package com.extractpdf4j.helpers

Class Ocr

java.lang.Object

com.extractpdf4j.helpers.Ocr

public final class Ocr
extends Object

OCR helper utilities. (Javadocs of class and methods updated to reflect new heuristic functionality.)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Ocr.OcrWord

Method Summary

Modifier and Type	Method	Description
static String	ocrPng(String pngPath)	Runs OCR on a PNG file and returns plain text.
static List<Ocr.OcrWord>	ocrTsv(String pngPath)
static List<Ocr.OcrWord>	ocrTsv(String pngPath, String lang, String psm)
static List<Ocr.OcrWord>	ocrTsvHeuristically(String pngPath, String lang)	Runs OCR on a PNG image using a heuristic to find the best Page Segmentation Mode (PSM).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

ocrTsvHeuristically

public static List<Ocr.OcrWord> ocrTsvHeuristically(String pngPath,
 String lang)

Runs OCR on a PNG image using a heuristic to find the best Page Segmentation Mode (PSM). It tries a predefined list of PSMs, finds the one with the best word coverage, and prints a summary of the best combination found.

Parameters:

pngPath - Path to the PNG image.

lang - Language string for Tesseract (e.g., "eng", "por", "eng+fra").

Returns:

A list of OCR words (possibly empty).

ocrPng

public static String ocrPng(String pngPath)

Runs OCR on a PNG file and returns plain text. (Legacy method) NOTE: This method does not use the new heuristic.

ocrTsv

public static List<Ocr.OcrWord> ocrTsv(String pngPath)

ocrTsv

public static List<Ocr.OcrWord> ocrTsv(String pngPath,
 String lang,
 String psm)