Zum Hauptinhalt springen
Diese Methode führt die Dokumentsynthese für eine einzelne Seite durch.
Unter Linux und Windows kann diese Methode bei der Verarbeitung einseitiger Dokumente mit Batch Processor nützlich sein. In diesem Fall müssen Sie nicht für jede Seite ein FRDocument-Objekt erstellen, sondern können stattdessen die Synthese- und Exportmethoden des FRPage-Objekts verwenden.
Wenn Sie mit einem mehrseitigen Dokument arbeiten, reicht es nicht aus, diese Methode für jede Seite aufzurufen. Sie müssen die Dokumentsynthese für das gesamte Dokument mindestens einmal durchführen (beispielsweise mit der Methode IFRDocument::Synthesize). Wenn Sie nach der vollständigen Dokumentsynthese jedoch einige Änderungen an einer Seite vornehmen müssen, können Sie anschließend Synthesize nur für diese Seite aufrufen und so Zeit sparen. Wenn Sie mit dieser Methode die Dokumentsynthese für eine Seite eines Dokuments durchführen, bleiben alle anderen Seiten des Dokuments unverändert. Dieser Methodenaufruf ähnelt dem Aufruf der Methode IFRDocument::SynthesizePages, wobei der Index der Seite als erster Parameter verwendet wird. Nachfolgend finden Sie einige Fälle, in denen die Dokumentsynthese ausgelassen werden kann.

​
Syntax

​
C++

HRESULT Synthesize( ISynthesisParamsForDocument* SynthesisParamsForDocument );

​
C#

void Synthesize( ISynthesisParamsForDocument SynthesisParamsForDocument );

​
Visual Basic .NET

Sub Synthesize([SynthesisParamsForDocument As ISynthesisParamsForDocument = Nothing])

​
Parameter

SynthesisParamsForDocument [in] Das SynthesisParamsForDocument-Objekt, das die Parameter der Dokumentensynthese speichert. Dieser Parameter kann 0 sein. In diesem Fall wird die Seite mit den Standardparametern synthetisiert, oder wenn ein Profil geladen wurde, werden die in diesem Profil festgelegten Parameter verwendet.

​
Rückgabewerte

Wenn die Synthese vom Benutzer unterbrochen wird, gibt diese Methode E_ABORT zurück. Sie gibt auch die Standard-Rückgabecodes der ABBYY FineReader Engine-Funktionen zurück.

​
Bemerkungen

  • Sie können die Stufe der Dokumentensynthese in den folgenden Fällen weglassen:
    • Wenn Sie den erkannten Text in das TXT-Format exportieren. Beim Export in dieses Format werden Syntheseinformationen nicht verwendet.
    • Wenn Sie das Dokument in das PDF ImageOnly-Format exportieren. In diesem Modus werden der erkannte Text und die Layoutinformationen nicht verwendet.
In allen anderen Fällen muss die Dokumentensynthese durchgeführt werden. Das Weglassen der Dokumentensynthese führt zu Fehlern.
  • Methoden, die das Wort „Process“ in ihren Namen enthalten (z. B. IFRDocument::Process), umfassen die Stufe der Dokumentensynthese. Verarbeitungsmethoden des FRPage-Objekts enthalten sie nicht, daher müssen Sie nach deren Verwendung explizit eine Methode aufrufen, die die Dokumentensynthese durchführt.
  • Sie können die Stufe der Dokumentensynthese beschleunigen und den Speicherverbrauch verringern. Wenn Sie während der Seitensynthese die Eigenschaft ISynthesisParamsForPage::DetectFontFormattingAtPageLevel auf TRUE setzen, können Sie anschließend die Erkennung von Schriftparametern und Dokumentstruktur während der Dokumentensynthese deaktivieren (ISynthesisParamsForDocument::DetectFontFormatting und ISynthesisParamsForDocument::DetectDocumentStructure). Dennoch kann die Qualität darunter leiden.
  • Diese Methode kann Ereignisse an die Listener melden, die an der IConnectionPointContainer-Schnittstelle des FRPage-Objekts angehängt sind.

​
Siehe auch

FRPage Arbeiten mit Profilen Parameter für Vorverarbeitung, Analyse, Erkennung und Synthese optimieren