Passer au contenu principal
Cette méthode ouvre le fichier image spécifié, effectue son prétraitement, son analyse de la mise en page, sa reconnaissance, la synthèse des pages et du document, puis exporte le texte reconnu dans le format de sortie sélectionné. La méthode RecognizeImageFile peut traiter des images multipages et exporter les résultats de la reconnaissance dans un seul fichier.

​
Syntaxe

​
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 _
)

​
Paramètres

ImageFileName [in] Contient le chemin complet du fichier image à reconnaître. Si ce fichier n’est pas au format interne d’ABBYY FineReader Engine, il est préparé à l’aide des valeurs par défaut des propriétés PrepareImageMode ou, si un profil a été chargé, des paramètres définis dans ce profil. PrepareMode [in] Cette variable fait référence à l’objet PrepareImageMode, qui stocke les paramètres de conversion de l’image au format interne. Ce paramètre peut être 0 ; dans ce cas, les paramètres par défaut du mode de préparation de l’image sont utilisés ou, si un profil a été chargé, les paramètres définis dans ce profil. DocumentProcessingParams [in] Fait référence à l’objet DocumentProcessingParams, qui stocke tous les paramètres de traitement. Ce paramètre peut être 0. Dans ce cas, le document est traité avec les paramètres par défaut (tous les paramètres de traitement sont définis sur leurs valeurs par défaut et la langue de reconnaissance est l’anglais) ou, si un profil a été chargé, avec les paramètres définis dans ce profil. ExportFormat [in] Cette variable de type FileExportFormatEnum spécifie le format du fichier de sortie dans lequel le texte reconnu est exporté. ExportParams [in] Transmettez via ce paramètre d’entrée l’objet de paramètres d’exportation du type correspondant à votre format de fichier. Par exemple, si vous créez un fichier RTF, créez l’objet RTFExportParams, définissez-y les paramètres nécessaires, puis transmettez-le à cette méthode comme paramètre d’entrée exporterParams. Ce paramètre est facultatif et peut être 0 ; dans ce cas, les paramètres d’exportation prennent leurs valeurs par défaut ou, si un profil a été chargé, les paramètres définis dans ce profil sont utilisés.
Sous Linux, si vous utilisez ABBYY FineReader Engine chargé hors processus, vous devez transmettre NULL pour ce paramètre.
PasswordCallback [in] Fait référence à l’interface de l’objet implémenté par l’utilisateur de type ImagePasswordCallback, utilisée pour gérer d’éventuelles demandes de mot de passe lors de l’accès à des images au format PDF. Ce paramètre est facultatif et peut être 0 ; dans ce cas, les fichiers protégés par mot de passe ne peuvent pas être traités. OutputFileName [in] Contient le chemin complet vers le fichier de sortie dans lequel le texte reconnu doit être exporté. Si un fichier existe déjà à cet emplacement, il est écrasé sans confirmation, ou le texte reconnu est ajouté à la fin de celui-ci, selon le mode d’exportation.

​
Valeurs de retour

Si la reconnaissance est interrompue par l’utilisateur, cette méthode renvoie E_ABORT. Si l’apprentissage des modèles est interrompu par l’utilisateur, cette méthode renvoie FREN_E_PATTERN_TRAINING_ABORTED. Elle renvoie également les codes de retour standard des fonctions d’ABBYY FineReader Engine.

​
Remarques

Pour Linux et Windows : selon la valeur de la propriété IEngine::MultiProcessingParams, ABBYY FineReader Engine peut répartir le traitement des documents multipages entre les cœurs du processeur.

​
Voir aussi

Engine IImagePasswordCallback Utilisation des profils