Passer au contenu principal
Cette méthode effectue la synthèse de documents pour une page donnée.
Sous Linux et Windows, cette méthode peut être utile lors du traitement de documents d’une seule page avec Batch Processor. Dans ce cas, il n’est pas nécessaire de créer un objet FRDocument pour chaque page ; vous pouvez à la place utiliser les méthodes de synthèse et d’exportation de l’objet FRPage.
Si vous travaillez avec un document de plusieurs pages, il ne suffit pas d’appeler cette méthode pour chacune d’elles. Vous devrez effectuer la synthèse de documents pour l’ensemble du document au moins une fois (en utilisant, par exemple, la méthode IFRDocument::Synthesize). En revanche, si après la synthèse complète du document vous devez apporter quelques modifications à une page, vous pouvez ensuite appeler Synthesize pour cette seule page, ce qui vous fera gagner du temps. Lorsque vous effectuez la synthèse de documents pour une page d’un document à l’aide de cette méthode, toutes les autres pages du document restent inchangées. Cet appel de méthode est similaire à un appel de la méthode IFRDocument::SynthesizePages, avec l’indice de la page comme premier paramètre. Vous trouverez ci-dessous la liste de quelques cas dans lesquels la synthèse de documents peut être omise.

​
Syntaxe

​
C++

HRESULT Synthesize( ISynthesisParamsForDocument* SynthesisParamsForDocument );

​
C#

void Synthesize( ISynthesisParamsForDocument SynthesisParamsForDocument );

​
Visual Basic .NET

Sub Synthesize([SynthesisParamsForDocument As ISynthesisParamsForDocument = Nothing])

​
Paramètres

SynthesisParamsForDocument [in] L’objet SynthesisParamsForDocument qui contient les paramètres de synthèse de documents. Ce paramètre peut être égal à 0. Dans ce cas, la page est synthétisée avec les paramètres par défaut ou, si un profil a été chargé, avec les paramètres définis par ce profil.

​
Valeurs de retour

Si la synthèse est interrompue par l’utilisateur, cette méthode renvoie E_ABORT. Elle renvoie également les codes de retour standard des fonctions ABBYY FineReader Engine.

​
Remarques

  • Vous pouvez omettre l’étape de synthèse de documents dans les cas suivants :
    • Si vous souhaitez exporter le texte reconnu au format TXT. Lors de l’exportation vers ce format, les informations de synthèse ne sont pas utilisées.
    • Si vous souhaitez exporter le document au format PDF ImageOnly. Dans ce mode, les informations de texte reconnu et de mise en page ne sont pas utilisées.
Dans tous les autres cas, la synthèse de documents doit être effectuée. Omettre la synthèse de documents entraînera des erreurs.
  • Les méthodes dont le nom contient le mot « Process » (par exemple, IFRDocument::Process) incluent l’étape de synthèse de documents. Les méthodes de traitement de l’objet FRPage ne l’incluent pas ; après les avoir utilisées, vous devez donc appeler explicitement une méthode qui effectue la synthèse de documents.
  • Vous pouvez accélérer l’étape de synthèse de documents et réduire l’utilisation de la mémoire. Si vous définissez la propriété ISynthesisParamsForPage::DetectFontFormattingAtPageLevel sur TRUE pendant la synthèse de page, vous pourrez ensuite désactiver la détection des paramètres de police et de la structure du document pendant la synthèse de documents (ISynthesisParamsForDocument::DetectFontFormatting et ISynthesisParamsForDocument::DetectDocumentStructure). Toutefois, la qualité peut s’en trouver dégradée.
  • Cette méthode peut signaler des événements aux écouteurs rattachés à l’interface IConnectionPointContainer de l’objet FRPage.

​
Voir aussi

FRPage Utilisation des profils Réglage des paramètres de prétraitement, d’analyse, de reconnaissance et de synthèse