OCRPageEx

OCR、描繪、文件編輯

描述

先檢查既有文字政策，必要時把單頁描繪成 PNG，呼叫所選的 OCR 供應商，並把結果套用為自有隱形文字圖層

語法

Delphi

Function TPDFlib.OCRPageEx(Page: Integer; DPI: Double; Const Language,
  FontName: WideString; MinConfidence: Double; Options: Integer): Integer;

ActiveX

Function PDFlib::OCRPageEx(Page As Long, DPI As Double, Language As String,
  FontName As String, MinConfidence As Double, Options As Long) As Long

DLL

int DLOCRPageEx(int InstanceID, int Page, double DPI, const wchar_t* Language,
  const wchar_t* FontName, double MinConfidence, int Options);
int DLOCRPageExA(int InstanceID, int Page, double DPI, const char* Language,
  const char* FontName, double MinConfidence, int Options);

參數

Page	目標頁碼（1 起算）
DPI	送給供應商的有限正數點陣解析度
Language	供應商定義的語言提示；已設定的 Tesseract 供應商使用 trained-data 名稱，例如 `eng`
FontName	可內嵌的 TrueType 字型，或空字串表示改用後備選擇
MinConfidence	字組信賴度閾值，0 到 1（含端點）
Options	ApplyOCRTextLayerEx 定義的圖層政策位元；0 附加新圖層、1 略過既有的非自有文字、2 取代自有 OCR 圖層

傳回值

1	結果已套用、頁面被略過，或沒有任何字組達到閾值
0	描繪、供應商執行、結果驗證、圖層寫入或取消作業使操作無法完成

備註

要使用隨附的引擎配接器請用 ConfigureTesseractOCR，或指派應用程式自有的 OnOCRPage 回呼

既有文字檢查在描繪與供應商執行之前進行，因此被略過的頁面不需要 OCR 引擎

該檢查只會忽略自有的舊 OCR 串流；外來的隱形文字圖層或被呼叫 Form XObject 中的隱藏文字仍算既有文字

掃描件需要經驗證的 90 度旋轉修正時，請明確啟用方向偵測；方向信賴度過低會直接失敗，不會更動 OCR 圖層

圖層動作以及已設定引擎最新的辨識與方向報告，請讀取 GetOCRDiagnosticsJSON

另請參閱

OCRPage, OCRDocumentEx, ApplyOCRTextLayerEx, ConfigureTesseractOCR, LastOCRError