Vai al contenuto principale
Questo metodo apre il file di immagine specificato, ne esegue la preelaborazione, l’analisi del layout, il riconoscimento, la sintesi di pagine e documenti ed esporta il testo riconosciuto nel formato di output selezionato. Il metodo RecognizeImageFile può elaborare immagini multipagina ed esportare i risultati del riconoscimento in un unico file.

​
Sintassi

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

​
Parametri

ImageFileName [in] Contiene il percorso completo del file immagine da riconoscere. Se questo file non è nel formato interno di ABBYY FineReader Engine, viene preparato utilizzando i valori predefiniti delle proprietà di PrepareImageMode oppure, se è stato caricato un profilo, i parametri impostati in tale profilo. PrepareMode [in] Questa variabile fa riferimento all’oggetto PrepareImageMode, che memorizza i parametri per la conversione dell’immagine nel formato interno. Questo parametro può essere 0; in tal caso vengono utilizzati i parametri predefiniti della modalità di preparazione dell’immagine oppure, se è stato caricato un profilo, i parametri impostati in tale profilo. DocumentProcessingParams [in] Fa riferimento all’oggetto DocumentProcessingParams, che memorizza tutti i parametri di elaborazione. Questo parametro può essere 0. In tal caso, il documento viene elaborato utilizzando i parametri predefiniti (tutti i parametri di elaborazione sono impostati sui valori predefiniti e la lingua di riconoscimento è l’inglese) oppure, se è stato caricato un profilo, i parametri impostati in tale profilo. ExportFormat [in] Questa variabile di tipo FileExportFormatEnum specifica il formato del file di output in cui viene esportato il testo riconosciuto. ExportParams [in] Tramite questo parametro di input, passare l’oggetto contenente i parametri di esportazione del tipo corrispondente al formato di file. Ad esempio, se si sta creando un file RTF, creare l’oggetto RTFExportParams, impostarvi i parametri necessari e passarlo a questo metodo come parametro di input exporterParams. Questo parametro è facoltativo e può essere 0; in tal caso i parametri di esportazione assumono i valori predefiniti oppure, se è stato caricato un profilo, vengono utilizzati i parametri impostati in tale profilo.
In Linux, se si utilizza ABBYY FineReader Engine caricato out-of-process, è necessario passare NULL per questo parametro.
PasswordCallback [in] Fa riferimento all’interfaccia dell’oggetto implementato dall’utente di tipo ImagePasswordCallback, utilizzata per gestire eventuali richieste di password per l’accesso a immagini in formato PDF. Questo parametro è facoltativo e può essere 0; in tal caso i file protetti da password non possono essere elaborati. OutputFileName [in] Contiene il percorso completo del file di output in cui deve essere esportato il testo riconosciuto. Se in questo percorso esiste già un file, viene sovrascritto senza richiesta di conferma oppure il testo riconosciuto viene aggiunto alla fine del file, a seconda della modalità di esportazione.

​
Valori di ritorno

Se il riconoscimento viene interrotto dall’utente, questo metodo restituisce E_ABORT. Se l’addestramento del pattern viene interrotto dall’utente, questo metodo restituisce FREN_E_PATTERN_TRAINING_ABORTED. Restituisce anche i codici di ritorno standard delle funzioni di ABBYY FineReader Engine.

​
Note

Per Linux e Windows: a seconda del valore della proprietà IEngine::MultiProcessingParams, ABBYY FineReader Engine può distribuire l’elaborazione dei documenti multipagina sui core della CPU.

​
Vedi anche

Engine IImagePasswordCallback Utilizzo dei profili