Zum Hauptinhalt springen
Diese Methode öffnet die angegebene Bilddatei, führt deren Vorverarbeitung, Layout-Analyse, Erkennung sowie Seiten- und Dokumentensynthese durch und exportiert den erkannten Text in das ausgewählte Ausgabeformat. Die RecognizeImageFile-Methode kann mehrseitige Bilddateien verarbeiten und die Erkennungsergebnisse in eine einzelne Datei exportieren.

​
Syntax

​
C++

HRESULT RecognizeImageFile(
  BSTR                         ImageFileName,
  IPrepareImageMode            PrepareMode,
  IDocumentProcessingParams*   DocumentProcessingParams,
  FileExportFormatEnum         ExportFormat,
  IUnknown*                    ExportParams,
  IImagePasswordCallback*      PasswordCallback,
  BSTR                         OutputFileName
);

​
C#

void RecognizeImageFile(
  string                   ImageFileName,
  IPrepareImageMode         PrepareMode,
  IDocumentProcessingParams DocumentProcessingParams,
  FileExportFormatEnum     ExportFormat,
  object                   ExportParams,
  IImagePasswordCallback   PasswordCallback,
  string                   OutputFileName
);

​
Visual Basic .NET

Sub RecognizeImageFile( _
  ImageFileName As String, _
  PrepareMode As IPrepareImageMode, _
  DocumentProcessingParams As IDocumentProcessingParams, _
  ExportFormat As IFileExportFormatEnum, _
  ExportParams As Object, _
  PasswordCallback As IImagePasswordCallback, _
  OutputFileName As String _
)

​
Parameter

ImageFileName [in] Enthält den vollständigen Pfad zu einer Bilddatei, die erkannt werden soll. Wenn diese Datei nicht im internen Format von ABBYY FineReader Engine vorliegt, wird sie mit den Standardwerten der Eigenschaften von PrepareImageMode vorbereitet, oder, falls ein Profil geladen wurde, werden die in diesem Profil festgelegten Parameter verwendet. PrepareMode [in] Diese Variable verweist auf das Objekt PrepareImageMode, das die Parameter für die Bildkonvertierung in das interne Format speichert. Dieser Parameter kann 0 sein; in diesem Fall werden die Standardparameter des Bildvorbereitungsmodus verwendet, oder, falls ein Profil geladen wurde, werden die in diesem Profil festgelegten Parameter verwendet. DocumentProcessingParams [in] Verweist auf das Objekt DocumentProcessingParams, das alle Verarbeitungsparameter speichert. Dieser Parameter kann 0 sein. In diesem Fall wird das Dokument mit den Standardparametern verarbeitet (alle Verarbeitungsparameter sind auf ihre Standardwerte gesetzt, und die Erkennungssprache ist Englisch), oder, falls ein Profil geladen wurde, werden die in diesem Profil festgelegten Parameter verwendet. ExportFormat [in] Diese Variable vom Typ FileExportFormatEnum gibt das Format der Ausgabedatei an, in die der erkannte Text exportiert wird. ExportParams [in] Über diesen Eingabeparameter übergeben Sie das Objekt mit den Exportparametern des Typs, der Ihrem Dateiformat entspricht. Wenn Sie beispielsweise eine RTF-Datei erstellen, erstellen Sie das Objekt RTFExportParams, legen die erforderlichen Parameter darin fest und übergeben es als Eingabeparameter exporterParams an diese Methode. Dieser Parameter ist optional und kann 0 sein; in diesem Fall werden für die Exportparameter die Standardwerte verwendet, oder, falls ein Profil geladen wurde, werden die in diesem Profil festgelegten Parameter verwendet.
Unter Linux müssen Sie für diesen Parameter NULL übergeben, wenn Sie mit ABBYY FineReader Engine arbeiten, das out-of-process geladen wurde.
PasswordCallback [in] Verweist auf die Schnittstelle des benutzerimplementierten Objekts vom Typ ImagePasswordCallback, die zur Verarbeitung möglicher Passwortabfragen für den Zugriff auf Bilder im PDF-Format verwendet wird. Dieser Parameter ist optional und kann 0 sein; in diesem Fall können passwortgeschützte Dateien nicht verarbeitet werden. OutputFileName [in] Enthält den vollständigen Pfad zur Ausgabedatei, in die der erkannte Text exportiert werden soll. Wenn an diesem Speicherort bereits eine Datei vorhanden ist, wird sie je nach Exportmodus entweder ohne Rückfrage überschrieben oder der erkannte Text an ihr Ende angehängt.

​
Rückgabewerte

Wenn die Erkennung vom Benutzer abgebrochen wird, gibt diese Methode E_ABORT zurück. Wenn das Pattern-Training vom Benutzer abgebrochen wird, gibt diese Methode FREN_E_PATTERN_TRAINING_ABORTED zurück. Außerdem gibt sie die Standard-Rückgabecodes der Funktionen von ABBYY FineReader Engine zurück.

​
Hinweise

Für 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 Arbeiten mit Profilen