Vai al contenuto principale
Questo metodo elabora il file PDF di input “solo immagine” o “immagine su testo” e crea un file PDF ricercabile che contiene le stesse immagini delle pagine e il livello di testo invisibile creato a partire dal testo riconosciuto nel documento. Si noti che, se il file di input contiene già un livello di testo, questo verrà sostituito. È possibile usare il metodo IsPdfWithTextualContent dell’oggetto Engine per verificare se il file di input contiene un livello di testo. Con questo metodo possono essere elaborati solo file PDF. Per creare PDF ricercabili da altri formati di immagine, è possibile usare i metodi dell’oggetto FRDocument (ad esempio AddImageFile, Process e Export).
In Windows, la libreria COM deve essere inizializzata nel thread corrente prima di chiamare questo metodo.

​
Sintassi

​
C++

HRESULT InjectTextLayer(
  BSTR                       SourcePdfFile,
  BSTR                       TargetPdfFile,
  IImagePasswordCallback*    PasswordCallback,
  IPrepareImageMode*         PrepareMode,
  IDocumentProcessingParams* DocumentProcessingParams,
  IIntsCollection*           PageIndices,
  IProcessingEvents*         ProcessingEvents,
  ITextLayerInjectionParams* TextLayerInjectionParams
);

​
C#

void InjectTextLayer(
  string                    SourcePdfFile,
  string                    TargetPdfFile,
  IImagePasswordCallback    PasswordCallback,
  IPrepareImageMode         PrepareMode,
  IDocumentProcessingParams DocumentProcessingParams,
  IIntsCollection           PageIndices,
  IProcessingEvents         ProcessingEvents,
  ITextLayerInjectionParams TextLayerInjectionParams
);

​
Visual Basic .NET

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

​
Parametri

SourcePdfFile [in] Questa variabile contiene il percorso completo del file PDF di origine. I file in altri formati non possono essere elaborati. TargetPdfFile [in] Questa variabile contiene il percorso completo del file PDF ricercabile da creare come risultato dell’elaborazione. I nomi dei file di origine e di destinazione non possono coincidere. PasswordCallback [in] Fa riferimento all’interfaccia dell’oggetto di tipo IImagePasswordCallback implementato dall’utente, utilizzata per gestire eventuali richieste di password per l’accesso ai file PDF. Questo parametro è facoltativo e può essere 0; in tal caso, i file protetti da password non possono essere elaborati. PrepareMode [in] Fa riferimento all’oggetto PrepareImageMode, che definisce la modalità di conversione del file immagine nel formato interno di ABBYY FineReader Engine. 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 da tale profilo. Si noti che, tra i parametri relativi alla correzione della geometria, vengono presi in considerazione solo quelli relativi al raddrizzamento, al rispecchiamento e alla rotazione. La suddivisione della pagina e la correzione geometrica non lineare non vengono eseguite. 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 con i parametri predefiniti (tutti i parametri di elaborazione sono impostati sui valori predefiniti) oppure, se è stato caricato un profilo, i parametri impostati da tale profilo. Si noti che, tra i parametri relativi alla correzione della geometria, vengono presi in considerazione solo quelli relativi al raddrizzamento dell’immagine, al rispecchiamento e alla rotazione. La suddivisione della pagina e la correzione geometrica non lineare non vengono eseguite. PageIndices [in] Questo parametro fa riferimento all’oggetto IntsCollection, che specifica gli indici delle pagine del documento in cui verrà inserito il testo. Questo parametro è facoltativo e può essere 0; in tal caso il testo verrà inserito in tutte le pagine del documento. ProcessingEvents [in] Fa riferimento all’interfaccia IProcessingEvents dell’oggetto implementato dall’utente, utilizzata per gestire l’elaborazione. Questo parametro può essere 0; in tal caso non verrà associato alcun callback. TextLayerInjectionParams [in] Questa variabile fa riferimento all’oggetto TextLayerInjectionParams, che memorizza i parametri di elaborazione del documento durante l’inserimento del testo. Questo parametro può essere 0. In tal caso, vengono utilizzati i valori predefiniti delle proprietà dell’oggetto.

​
Valori di ritorno

Questo metodo non prevede valori di ritorno specifici. Restituisce i valori di ritorno standard delle funzioni di ABBYY FineReader Engine.

​
Osservazioni

Vengono presi in considerazione i parametri di elaborazione relativi al raddrizzamento dell’immagine, al rispecchiamento e alla rotazione. La suddivisione della pagina e la correzione geometrica non lineare non vengono eseguite. In Linux e Windows: a seconda del valore della proprietà IEngine::MultiProcessingParams, ABBYY FineReader Engine può distribuire l’elaborazione dei documenti multipagina tra i core della CPU.

​
Vedi anche

Engine IImagePasswordCallback