Cette méthode traite le fichier PDF d’entrée “image only” ou “image on text” et crée un fichier PDF interrogeable contenant les mêmes images de page ainsi qu’une couche de texte invisible créée à partir du texte reconnu dans le document.
Veuillez noter que si le fichier d’entrée contient déjà une couche de texte, celle-ci sera remplacée. Vous pouvez utiliser la méthode IsPdfWithTextualContent de l’objet Engine pour vérifier si le fichier d’entrée contient une couche de texte.
Seuls les fichiers PDF peuvent être traités à l’aide de cette méthode. Pour créer des PDF interrogeables à partir d’autres types d’images, vous pouvez utiliser les méthodes de l’objet FRDocument (par exemple, AddImageFile, Process et Export).
Sous Windows, la bibliothèque COM doit être initialisée sur le thread courant avant l’appel de cette méthode.
HRESULT InjectTextLayer(
BSTR SourcePdfFile,
BSTR TargetPdfFile,
IImagePasswordCallback* PasswordCallback,
IPrepareImageMode* PrepareMode,
IDocumentProcessingParams* DocumentProcessingParams,
IIntsCollection* PageIndices,
IProcessingEvents* ProcessingEvents,
ITextLayerInjectionParams* TextLayerInjectionParams
);
void InjectTextLayer(
string SourcePdfFile,
string TargetPdfFile,
IImagePasswordCallback PasswordCallback,
IPrepareImageMode PrepareMode,
IDocumentProcessingParams DocumentProcessingParams,
IIntsCollection PageIndices,
IProcessingEvents ProcessingEvents,
ITextLayerInjectionParams TextLayerInjectionParams
);
Sub InjectTextLayer( _
SourcePdfFile As String, _
TargetPdfFile As String, _
[PasswordCallback As IImagePasswordCallback = Nothing], _
[PrepareMode As IPrepareImageMode = Nothing], _
[DocumentProcessingParams As IDocumentProcessingParams = Nothing], _
[PageIndices As IIntsCollection = Nothing], _
[ProcessingEvents As IProcessingEvents = Nothing], _
[TextLayerInjectionParams As ITextLayerInjectionParams = Nothing] _
)
SourcePdfFile
[in] Cette variable contient le chemin complet du fichier PDF source. Les fichiers dans d’autres formats ne peuvent pas être traités.
TargetPdfFile
[in] Cette variable contient le chemin complet du fichier PDF interrogeable à créer à l’issue du traitement. Les noms des fichiers source et cible ne peuvent pas être identiques.
PasswordCallback
[in] Fait référence à l’interface de l’objet implémenté par l’utilisateur de type IImagePasswordCallback, utilisée pour gérer les éventuelles demandes de mot de passe lors de l’accès aux fichiers PDF. Ce paramètre est facultatif et peut valoir 0, auquel cas les fichiers protégés par mot de passe ne peuvent pas être traités.
PrepareMode
[in] Fait référence à l’objet PrepareImageMode, qui définit le mode de conversion du fichier image vers le format interne d’ABBYY FineReader Engine. Ce paramètre peut valoir 0, auquel 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 par ce profil sont utilisés.
Veuillez noter que, parmi les paramètres de correction géométrique, seuls ceux relatifs au redressement, à la mise en miroir et à la rotation sont pris en compte. Le fractionnement des pages et la correction géométrique non linéaire ne sont pas effectués.
DocumentProcessingParams
[in] Fait référence à l’objet DocumentProcessingParams, qui stocke tous les paramètres de traitement. Ce paramètre peut valoir 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) ou, si un profil a été chargé, avec les paramètres définis par ce profil.
Veuillez noter que, parmi les paramètres de correction géométrique, seuls ceux relatifs au redressement de l’image, à la mise en miroir et à la rotation sont pris en compte. Le fractionnement des pages et la correction géométrique non linéaire ne sont pas effectués.
PageIndices
[in] Ce paramètre fait référence à l’objet IntsCollection, qui spécifie les indices des pages du document dans lesquelles le texte sera injecté. Ce paramètre est facultatif et peut valoir 0, auquel cas le texte sera injecté dans toutes les pages du document.
ProcessingEvents
[in] Fait référence à l’interface IProcessingEvents de l’objet implémenté par l’utilisateur, utilisée pour gérer le traitement. Ce paramètre peut valoir 0, auquel cas aucune fonction de rappel ne sera associée.
TextLayerInjectionParams
[in] Cette variable fait référence à l’objet TextLayerInjectionParams, qui stocke les paramètres de traitement du document lors de l’injection du texte. Ce paramètre peut valoir 0. Dans ce cas, les valeurs par défaut des propriétés de l’objet sont utilisées.
Cette méthode n’a pas de valeur de retour spécifique. Elle renvoie les valeurs de retour standard des fonctions ABBYY FineReader Engine.
Les paramètres de traitement correspondant au redressement de l’image, à la mise en miroir et à la rotation sont pris en compte. Le fractionnement des pages et la correction géométrique non linéaire ne sont pas effectués.
Sous Linux et Windows : selon la valeur de la propriété IEngine::MultiProcessingParams, ABBYY FineReader Engine peut répartir le traitement des documents multipages sur les cœurs du processeur.
Engine
IImagePasswordCallback