ApplyOcrSearchLayer - TPdf

Component: TPdf · Unit: PDFium

Voegt een onzichtbare doorzoekbare tekstlaag toe aan gescande pagina's via een OCR-provider van de toepassing

Syntax

function ApplyOcrSearchLayer(
  const Provider: IPdfOcrProvider;
  const Options: TPdfOcrOptions;
  out Report: TPdfOcrReport;
  const CancellationToken: IPdfCancellationToken = nil): Boolean;

Provider contract

De library rendert elke geselecteerde pagina via PDFium en geeft een compacte top-down popfBgra32-afbeelding door aan IPdfOcrProvider.RecognizePage

De provider geeft TPdfOcrWord-waarden terug waarvan de Quad-coördinaten pixeleenheden gebruiken met de oorsprong linksboven in de afbeelding

Tekstconfidence moet in het bereik 0 tot 1 liggen en de punten van de vierhoek moeten binnen de aangeleverde afbeelding blijven

Output behaviour

Native FPDF_DeviceToPage-mapping behoudt paginaboxen en intrinsieke rotatie
Geaccepteerde woorden worden native tekstobjecten met FPDF_TEXTRENDERMODE_INVISIBLE
Bestaande pagina-afbeeldingen en vectorinhoud worden niet gedecodeerd of hercodeerd
Elke pagina wordt één keer vastgelegd en mislukte invoegingen worden verwijderd voordat de methode doorgaat
De teruggegeven TPdfOcrReport telt ProcessedPageCount, FailedPageCount, DetectedWordCount, InsertedWordCount, RejectedWordCount en TotalRenderedPixels op, terwijl elke TPdfOcrPageReport-invoeging per pagina ImageWidth, ImageHeight, DetectedWordCount, InsertedWordCount en RejectedWordCount toevoegt
De eerder actieve pagina wordt hersteld voordat de methode terugkeert

Options and budgets

FirstPage en LastPage selecteren een inclusief bereik, waarbij nul de documentgrens kiest

SkipPagesWithText voorkomt het dupliceren van een bestaande doorzoekbare laag en ContinueOnError stuurt herstel op paginaniveau

Budgetten die fail-closed worden gehandhaafd vóór paginamutatie omvatten MaxPixelsPerPage en MaxTotalPixels pixels, MaxWordsPerPage en MaxTotalWords woorden, MaxWordCharacters tekens per woord, plus confidence en DPI

Example

var
  Options: TPdfOcrOptions;
  Report: TPdfOcrReport;
begin
  Options := TPdfOcrOptions.Default;
  Options.Dpi := 300;
  Options.MinConfidence := 0.75;
  if Pdf1.ApplyOcrSearchLayer(OcrProvider, Options, Report) then
    Pdf1.SaveAs('searchable.pdf');
end;

ApplyOcrSearchLayer methode