Zum Hauptinhalt springen
Diese Methode verarbeitet die PDF-Eingabedatei “nur Bild” oder “Bild über Text” und erstellt eine durchsuchbare PDF-Datei, die dieselben Seitenbilder sowie die unsichtbare Textebene enthält, die aus dem erkannten Text des Dokuments erzeugt wurde. Bitte beachten Sie, dass eine in der Eingabedatei bereits vorhandene Textebene ersetzt wird. Sie können die Methode IsPdfWithTextualContent des Objekts Engine verwenden, um zu prüfen, ob die Eingabedatei eine Textebene enthält. Mit dieser Methode können nur PDF-Dateien verarbeitet werden. Um durchsuchbare PDFs aus anderen Bildformaten zu erstellen, können Sie Methoden des Objekts FRDocument verwenden (z. B. AddImageFile, Process und Export).
Unter Windows muss die COM-Bibliothek im aktuellen Thread initialisiert werden, bevor diese Methode aufgerufen wird.

Syntax

C++

HRESULT InjectTextLayer(
  BSTR                       SourcePdfFile,
  BSTR                       TargetPdfFile,
  IImagePasswordCallback*    PasswordCallback,
  IPrepareImageMode*         PrepareMode,
  IDocumentProcessingParams* DocumentProcessingParams,
  IIntsCollection*           PageIndices,
  IProcessingEvents*         ProcessingEvents,
  ITextLayerInjectionParams* TextLayerInjectionParams
);

C#

void InjectTextLayer(
  string                    SourcePdfFile,
  string                    TargetPdfFile,
  IImagePasswordCallback    PasswordCallback,
  IPrepareImageMode         PrepareMode,
  IDocumentProcessingParams DocumentProcessingParams,
  IIntsCollection           PageIndices,
  IProcessingEvents         ProcessingEvents,
  ITextLayerInjectionParams TextLayerInjectionParams
);

Visual Basic .NET

 Sub InjectTextLayer( _
  SourcePdfFile As String, _
  TargetPdfFile As String, _                
  [PasswordCallback As IImagePasswordCallback = Nothing], _
  [PrepareMode As IPrepareImageMode = Nothing], _         
  [DocumentProcessingParams As IDocumentProcessingParams = Nothing], _
  [PageIndices As IIntsCollection = Nothing], _
  [ProcessingEvents As IProcessingEvents = Nothing], _
  [TextLayerInjectionParams As ITextLayerInjectionParams = Nothing] _
)

Parameter

SourcePdfFile [in] Diese Variable enthält den vollständigen Pfad zur PDF-Quelldatei. Dateien in anderen Formaten können nicht verarbeitet werden. TargetPdfFile [in] Diese Variable enthält den vollständigen Pfad zur durchsuchbaren PDF-Datei, die als Ergebnis der Verarbeitung erstellt werden soll. Die Namen der Quell- und Zieldatei dürfen nicht identisch sein. PasswordCallback [in] Verweist auf die Schnittstelle des benutzerimplementierten Objekts vom Typ IImagePasswordCallback, die zur Verarbeitung möglicher Kennwortabfragen beim Zugriff auf PDF-Dateien verwendet wird. Dieser Parameter ist optional und kann 0 sein. In diesem Fall können kennwortgeschützte Dateien nicht verarbeitet werden. PrepareMode [in] Verweist auf das Objekt PrepareImageMode, das den Modus für die Konvertierung der Bilddatei in das interne Format von ABBYY FineReader Engine definiert. Dieser Parameter kann 0 sein. In diesem Fall werden die Standardparameter des Bildvorbereitungsmodus verwendet oder – falls ein Profil geladen wurde – die in diesem Profil festgelegten Parameter. Bitte beachten Sie, dass von den Parametern für die Geometriekorrektur nur die Parameter für Schieflagenkorrektur, Spiegelung und Rotation berücksichtigt werden. Seitentrennung und nichtlineare Geometriekorrektur werden nicht durchgeführt. DocumentProcessingParams [in] Verweist auf das Objekt DocumentProcessingParams, das alle Verarbeitungsparameter speichert. Dieser Parameter kann 0 sein. In diesem Fall wird das Dokument mit Standardparametern verarbeitet (alle Verarbeitungsparameter sind auf Standardwerte gesetzt) oder – falls ein Profil geladen wurde – mit den in diesem Profil festgelegten Parametern. Bitte beachten Sie, dass von den Parametern für die Geometriekorrektur nur die Parameter für Schieflagenkorrektur, Spiegelung und Rotation berücksichtigt werden. Seitentrennung und nichtlineare Geometriekorrektur werden nicht durchgeführt. PageIndices [in] Dieser Parameter verweist auf das Objekt IntsCollection, das die Indizes der Dokumentseiten angibt, in die der Text eingefügt werden soll. Dieser Parameter ist optional und kann 0 sein. In diesem Fall wird der Text in alle Seiten des Dokuments eingefügt. ProcessingEvents [in] Verweist auf die Schnittstelle IProcessingEvents des benutzerimplementierten Objekts, die zur Steuerung der Verarbeitung verwendet wird. Dieser Parameter kann 0 sein. In diesem Fall wird kein Callback angehängt. TextLayerInjectionParams [in] Diese Variable verweist auf das Objekt TextLayerInjectionParams, das die Parameter für die Dokumentverarbeitung bei der Texteinfügung speichert. Dieser Parameter kann 0 sein. In diesem Fall werden die Standardwerte der Objekteigenschaften verwendet.

Rückgabewerte

Diese Methode hat keine spezifischen Rückgabewerte. Sie gibt die Standardrückgabewerte von ABBYY FineReader Engine-Funktionen zurück.

Hinweise

Die Verarbeitungsparameter für die Schieflagenkorrektur, Spiegelung und Drehung von Bildern werden berücksichtigt. Seitentrennung und nichtlineare Geometriekorrektur werden nicht durchgeführt. Unter Linux und Windows: Je nach Wert der Eigenschaft IEngine::MultiProcessingParams kann ABBYY FineReader Engine die Verarbeitung mehrseitiger Dokumente auf die CPU-Kerne verteilen.

Siehe auch

Engine IImagePasswordCallback