Méthode CleanRecognizerSession de l'objet Engine

Cette méthode nettoie la session de reconnaissance en cours. Lors du traitement de documents, FineReader Engine s’ajuste automatiquement à la reconnaissance du type de document en cours (luminosité, types de texte, polices, etc.). Ces informations sont utilisées pendant une session de reconnaissance et contribuent à améliorer la qualité de la reconnaissance. Lorsque vous appelez la méthode CleanRecognizerSession, toutes les informations obtenues lors de cet auto-ajustement sont supprimées.

Par défaut, FineReader Engine nettoie la session de reconnaissance après la reconnaissance de chaque page (la propriété IEngine::AutoCleanRecognizerSession a la valeur TRUE) et, dans la plupart des cas, vous n’avez pas besoin d’appeler manuellement la méthode CleanRecognizerSession.

Voici les situations dans lesquelles vous pouvez avoir besoin d’appeler cette méthode :

• Si vous devez conserver la session de reconnaissance d’une page à l’autre, par exemple si vous utilisez le cache dictionary. Dans ce cas, vous devez définir la propriété AutoCleanRecognizerSession sur FALSE et nettoyer manuellement la session de reconnaissance en appelant la méthode CleanRecognizerSession lorsque nécessaire (lorsque vous n’avez plus besoin du cache dictionary ou si vous allez traiter une page dont les paramètres (luminosité, types de texte, polices, etc.) sont extrêmement différents de ceux des pages précédentes).
• Si vous devez nettoyer la session de reconnaissance au cours de la reconnaissance d’une page, par exemple si la page contient des blocs de texte dont certains paramètres (types de texte, polices, etc.) diffèrent sensiblement de ceux des autres blocs de texte.

Si la propriété AutoCleanRecognizerSession a la valeur FALSE, FineReader Engine nettoie néanmoins automatiquement sa session de reconnaissance dans les cas suivants :

Windows et Linux

• Si les pages sont reconnues séquentiellement dans un même processus et qu’il n’y a plus de pages à traiter (par exemple, la méthode IFRDocument::Close a été appelée ou le document a été libéré et qu’il n’y a pas d’autres documents).
• S’il n’y a plus de pages à traiter (par exemple, la méthode IFRDocument::Close a été appelée ou le document a été libéré et qu’il n’y a pas d’autres documents).
• Si les pages sont reconnues dans des processus parallèles, à la fin de chaque processus parallèle.
• Si les pages sont reconnues dans des processus parallèles à l’aide de BatchProcessor et qu’il n’y a plus de pages à traiter (IBatchProcessor::GetNextProcessedPage renvoie 0).
• Si la méthode LoadPredefinedProfile ou LoadProfile de l’objet Engine est appelée.

macOS

• S’il n’y a plus de pages à traiter (par exemple, la méthode IFRDocument::Close a été appelée ou le document a été libéré et qu’il n’y a pas d’autres documents).

• Si la méthode LoadPredefinedProfile ou LoadProfile de l’objet Engine est appelée.

​

Syntaxe

​

C++

HRESULT CleanRecognizerSession();

​

C#

void CleanRecognizerSession();

​

Visual Basic .NET

Sub CleanRecognizerSession()

​

Valeurs de retour

Cette méthode n’a pas de valeur de retour spécifique. Elle renvoie les valeurs de retour standard des fonctions d’ABBYY FineReader Engine.

​

Remarques

Cet appel de méthode vide automatiquement le cache dictionary.

​

Voir aussi

Engine