Compatibilità tra ABBYY FineReader Engine 12 e 11

ABBYY FineReader Engine 12 non è binariamente compatibile con ABBYY FineReader Engine 11. Le applicazioni compilate con ABBYY FineReader Engine 11 devono essere ricompilate utilizzando gli header e la libreria di ABBYY FineReader Engine 12. Alcune modifiche al codice sorgente potrebbero essere necessarie a causa dei miglioramenti apportati all’API di ABBYY FineReader Engine. Questo articolo contiene un elenco completo delle modifiche, insieme a suggerimenti su come riscrivere il codice affinché funzioni con la nuova versione. Modifiche principali:

Gli oggetti obsoleti DocumentAnalyzer ed Exporter sono stati rimossi, insieme ai metodi di elaborazione dell’oggetto Engine. Utilizza i metodi più efficienti degli oggetti FRDocument e FRPage, che gestiscono tutte le informazioni necessarie per la completa elaborazione dei documenti. Non è più necessario gestire l’oggetto DocumentInfo in tutte le fasi di elaborazione, tenere traccia di tutti i documenti immagine con i relativi layout o implementare l’interfaccia IRecognizedPages.
L’API che forniva l’accesso alla struttura logica del documento (DocumentStructure, PageStructure e i rispettivi sotto-oggetti) è stata rimossa. La modifica delle proprietà e dei contenuti del documento tramite gli oggetti eliminati avrebbe potuto causare risultati imprevedibili durante l’esportazione. Se devi verificare o postelaborare i risultati del riconoscimento, lavora con i dati tramite il sotto-oggetto Layout di ogni FRPage e, al termine, richiama uno dei metodi che eseguono la sintesi del documento. La struttura logica del documento verrà quindi ricreata e utilizzata nella fase di esportazione, anche se non sarà più disponibile per la modifica tramite l’API di FineReader Engine. Le versioni future di ABBYY FineReader Engine potrebbero fornire un accesso di sola lettura ad alcuni elementi della struttura logica del documento.
L’API di classificazione è stata completamente sostituita con una nuova versione che utilizza algoritmi migliorati e offre tecniche integrate di validazione incrociata.

L’oggetto Engine ora deve essere caricato tramite la funzione InitializeEngine. Le funzioni GetEngineObject e GetEngineObjectEx per il caricamento dell’oggetto Engine sono state rimosse da ABBYY FineReader Engine.

Oggetto Engine

Proprietà/Metodo/Costante	Cosa è cambiato?	Commento
CreateDocumentAnalyzer CreateDocumentInfo CreateExporter	Rimosso	I metodi non sono più necessari, poiché gli oggetti che creavano sono stati rimossi.
CreateExportFileWriter	Firma aggiornata	Il parametro PagesCount, deprecato, è stato rimosso.
CreateImageDocumentsInMemory <Note> Solo per Windows </Note>	Rimosso	I documenti immagine vengono sempre creati in memoria. Se necessario, è possibile utilizzare i metodi SaveTo o SaveToFile per salvare il documento immagine su disco.
CreateLayout	Rimosso	L’oggetto Layout non può più essere utilizzato indipendentemente dalla pagina a cui corrisponde.
CreateMultipageImageWriter	Comportamento modificato	Questo metodo ora supporta parametri estesi per il salvataggio delle immagini nei formati JPEG e TIFF.
CreateMultipageImageWriterEx	Rinominato	Questo metodo ora si chiama CreateMultipageImageWriter. La precedente implementazione del metodo CreateMultipageImageWriter è stata rimossa.
ExportPage	Rimosso	Usare invece il metodo IFRPage::Export.
ExportPagesEx	Rimosso	Utilizzare invece il metodo IFRDocument::Export.
InjectTextLayer	Modifica del comportamento	Questo metodo ora offre parametri aggiuntivi per l’inserimento del livello di testo, nonché la possibilità di selezionare le pagine del file PDF da elaborare e un’interfaccia di callback per gestire avvisi ed errori.
InjectTextLayerEx InjectTextLayerEx2	Rimosso	La nuova versione del metodo InjectTextLayer include ora tutte le opzioni precedentemente disponibili in questi metodi.
OpenImageFile	Rimosso	Utilizza il metodo IFRDocument::AddImageFile per aprire un file immagine e aggiungerlo al documento da elaborare. All’oggetto ImageDocument sarà possibile accedere tramite il corrispondente FRPage.
PrepareImageFile	Rimosso	Utilizzare il metodo IFRDocument::AddImageFile per aprire un file immagine e aggiungerlo al documento per l’elaborazione. L’oggetto ImageDocument sarà accessibile tramite il corrispondente FRPage e potrà essere salvato successivamente su disco.
ProcessPage	Rimosso	Usare invece il metodo IFRDocument::Process.
ProcessPagesEx	Rimosso	Usare invece il metodo IFRDocument::Process.
SynthesizePagesEx	Rimosso	Utilizzare invece il metodo IFRDocument::Synthesize.
OpenMemoryImageFormat10	Rimosso	Questo metodo era disponibile solo per garantire la compatibilità con ABBYY FineReader Engine 10.
OpenBitmap OpenBitmapBits<br />OpenDib<br />PrepareBitmap<br />PrepareBitmapBits<br />PrepareDib	Obsoleto in Linux e macOS	Queste proprietà sono ora obsolete e verranno rimosse nelle versioni future.

Motore per Java

Metodo	Cosa è cambiato?	Commento
Load LoadEx	Rimossi	Metodi deprecati; utilizzare invece Engine.InitializeEngine.

Oggetti relativi alle immagini

Oggetto/Enumerazione	Proprietà/Metodo/Costante	Cosa è cambiato?	Commento
ImageDocument	SuppressColorObjects	Rimosso	Utilizzare invece il metodo RemoveColorObjectsEx, che consente di rimuovere in una sola volta oggetti di più tonalità specificate e di ottenere anche l’immagine degli oggetti rimossi.
	RemoveGarbage	Comportamento modificato	Questo metodo continua a cercare il rumore nel piano bianco e nero, ma lo rimuove da tutti i piani colore dell’immagine.
	RemoveGarbageEx	Rinominato	Questo metodo ora si chiama RemoveGarbage. La precedente implementazione di quel metodo è stata rimossa.
PrepareImageMode	ImageCompression	Rinominato, tipo modificato	Questa proprietà ora si chiama CompressImage ed è di tipo ThreeStatePropertyValueEnum. L’impostazione predefinita funziona come prima.
PrepareImageMode	KeepOriginalCoordinatesInfo	Deprecata	Questa proprietà è ora deprecata e verrà eliminata nelle versioni future.
ImageCompressionEnum		Rimosso	La proprietà che utilizzava questa enumerazione ora ha un tipo diverso.
Image	EstimateBitmapSize GetBitmap	Deprecati in Linux e macOS	Questi metodi sono ora deprecati e verranno rimossi nelle versioni future.
TrainingImage	SetBitmapBits	Deprecato in Linux e macOS	Questo metodo è ora deprecato e verrà rimosso nelle versioni future.

Oggetti relativi a Layout

Oggetto/Enumerazione	Proprietà/Metodo/Costante	Cosa è cambiato?	Commento
Block	BackgroundColor	Comportamento modificato	Questa proprietà è ora di sola lettura.
Block	BlockLayerType	Comportamento modificato	Questa proprietà è ora di sola lettura. Per RasterPictureBlock e VectorPictureBlock, il tipo di layer può essere modificato tramite il metodo SetBlockLayerType.
BlockLayerTypeEnum	BLT_Unknown	Rimosso	Questa costante non è più utilizzata.

Oggetti correlati al testo


	Rimosso	Queste proprietà non sono più supportate: non è più possibile rilevare la suddivisione del paragrafo su due pagine.
	Rimosso	Questa proprietà restituiva l’ID dell’oggetto PageElement corrispondente all’immagine e non è più utile perché l’oggetto PageElement è stato rimosso insieme al resto dell’API della struttura del documento.
	Comportamento modificato	Questo metodo richiede ora che il nome del segnalibro utente sia specificato nel formato “UserDefinedBookmark:<my_user_bookmark>”.
	Rimosso	Le proprietà del paragrafo sono ora accessibili solo tramite l’oggetto.
	Comportamento modificato	Queste proprietà sono ora di sola lettura. Nessuna proprietà dello stile di paragrafo può essere modificata.
	Rimosso	Nessuna proprietà dello stile di paragrafo può essere modificata o copiata da un altro oggetto.
	Rimosso	Lo stile di paragrafo è accessibile tramite l’oggetto.
	Rinominato	Questo metodo si chiama ora AddNew. La precedente implementazione del metodo AddNew è stata rimossa.
	Comportamento modificato	Questo metodo consente ora di impostare tutte le proprietà del tab leader al momento della creazione.
	Rimosso	Tutte le proprietà di un tab stop devono essere specificate al momento della creazione dell’oggetto tramite il metododell’oggetto. Non possono essere modificate né copiate da un altro oggetto.
	Comportamento modificato	Le proprietà sono ora di sola lettura. Devono essere specificate al momento della creazione dell’oggetto tramite il metodomethod of theobject and may not be changed or copied from another object.
	Removed	This property was deprecated in the previous version.
	Removed	This property has been removed due to the removal of document logical structure API, as it is no longer possible to access the parts of document by their role in the logical structure.
	Removed	The property that used this enumeration has been removed.
	Rimosso	Questa proprietà era deprecata ed era pianificata per la rimozione. È stata sostituita da due proprietà:, che specifica il primo carattere della parola se letta da sinistra a destra, e, che specifica il primo carattere in senso logico indipendentemente dalla direzione di lettura utilizzata nella lingua.
CFL_Picture	Removed	The property which used this constant has been removed.
	Deprecated	These properties are now deprecated and will be deleted in future versions.
	Behavior changed	This property now requires the specification of user bookmark name in the format “UserDefinedBookmark:<my_user_bookmark>” for creating a hyperlink.

Oggetti correlati ai documenti


		Rinominato	Questa interfaccia ora si chiama. La versione precedente di questa interfaccia è stata rimossa.
		Parametri modificati	Questo metodo dispone ora di un parametro aggiuntivo che specifica l’indice della pagina nel documento a cui si riferisce l’avviso.
		Rimosso	Questi oggetti rappresentavano la struttura logica del documento e le sue varie parti. La modifica della struttura del documento non è più supportata, poiché un utilizzo non corretto potrebbe influire sull’aspetto del documento esportato; qualsiasi verifica del testo o altra modifica può essere eseguita tramite le API del documento (,e i relativi oggetti secondari). Le versioni future di ABBYY FineReader Engine potranno fornire accesso di sola lettura ad alcune parti della struttura logica del documento.
		Rimosso	Queste enumerazioni erano utilizzate dagli oggetti della struttura del documento che non sono più disponibili.
		Comportamento modificato	Questo metodo fornisce ora parametri estesi per il rilevamento delle pagine vuote.
		Rinominato	Questo metodo è stato rinominato in. La precedente implementazione del metodo IsEmpty è stata rimossa.
		Rimosso	La classificazione delle pagine può ora essere eseguita tramite il metododell’oggetto. Il metodo richiede come parametro di input un, che può essere creato tramite il metodo.
		Deprecato	Questa proprietà è deprecata e verrà rimossa nelle versioni future. Utilizzare il metodoper verificare se un file contiene contenuto testuale.

Batch Processor

Oggetto/Enumerazione	Proprietà/Metodo/Costante	Cosa è cambiato?	Commento
BatchProcessor	StartEx	Rimosso	Il metodo Start ora usa l’interfaccia avanzata della sorgente immagini, che a sua volta è stata rinominata IImageSource.
IImageSourceEx	<br />	Rinominato	Questa interfaccia ora si chiama IImageSource.
IImageSource	<br />	Comportamento modificato	Questa interfaccia ora consente di aggiungere alla coda, oltre ai file immagine, anche documenti immagine.

Oggetti del motore


	Rimosso	L’oggetto è obsoleto. I suoi metodi sono stati sostituiti da metodi più efficienti degli oggettie, che non richiedono di mantenere l’oggetto DocumentInfo in tutte le fasi di elaborazione né di implementare l’interfaccia IRecognizedPages.
	Rimosso	Utilizzare i metodi,,per utilizzare i dizionari cache.
	Rimosso	Utilizzare il metodoin sostituzione.
	Rimosso	Utilizzare il metodoin sostituzione.
	Rimosso	Utilizzare il metodoin sostituzione.
	Rimosso	Utilizzare il metodoin sostituzione.
	Rimosso	Utilizzare la proprietà, che funziona esattamente allo stesso modo.
	Rimosso	Utilizzare il metodo, che funziona esattamente allo stesso modo.
	Rimosso	Utilizzare il metodo IImageDocument::RemoveGeometricalDistortions in sostituzione.
	Rimosso	Utilizzare il metodoin sostituzione.
	Rimosso	Utilizzare il metodoin sostituzione.
	Rimosso	Utilizzare il metodoal suo posto.
	Rimosso	Utilizzare il metodoal suo posto.
	Rimosso	Utilizzare il metodoal suo posto.
	Rimosso	Utilizzare il metodoal suo posto. Esegue l’elaborazione completa del documento, inclusa la sintesi del documento.
	Rimosso	Utilizzare il metodoal suo posto.
	Rimosso	Utilizzare il metodoal suo posto.
	Rimosso	Utilizzare il metodoal suo posto.
	Rimosso	Per riconoscere un’immagine come testo normale, creare l’oggettodall’immagine tramite il metodo, utilizzare il metodoper riconoscere il documento, quindi accedere alla proprietà.
	Rimosso	Per riconoscere la pagina come testo normale, utilizzare il metodo, quindi accedere alla proprietà.
	Rimosso	Utilizzare il metodoal suo posto.
	Rimosso	Utilizzare il metodoal suo posto.
	Rimosso	L’oggetto è obsoleto. I suoi metodi sono stati sostituiti da metodi più efficienti degli oggettie, che non richiedono di mantenere l’oggetto DocumentInfo in tutte le fasi di elaborazione né di implementare l’interfaccia IRecognizedPages.
	Rimosso	Utilizzare il metodoal suo posto.
	Rimosso	Utilizzare invece il metodo.
	Rimosso	Questa interfaccia non è più necessaria perché l’oggetto che segnalava gli eventi è stato rimosso. Le interfacceeforniscono informazioni analoghe su avanzamento ed errori per gli oggetti che hanno sostituito DocumentAnalyzer.
	Rimosso	Questa interfaccia non è più necessaria perché l’oggetto che segnalava gli eventi è stato rimosso. Le interfacceeforniscono informazioni analoghe su avanzamento ed errori per gli oggetti che hanno sostituito Exporter.
	Rimosso	I metodi che richiedevano un oggetto di questo tipo sono stati rimossi.
FREM_DocumentAnalyzer	Rimosso	Questa costante non è più in uso.

oggetti Parameter


	Rimosso	Questa proprietà è obsoleta a partire da FineReader Engine 11. Utilizzare la proprietàin sostituzione.
	Rimosso	Questa proprietà è obsoleta a partire da FineReader Engine 11. Utilizzare la proprietàdell’oggettoin sostituzione.
	Rimosso	Utilizzare la proprietàper emulare il layout del testo originale tramite spazi.
WS_Default	Rimosso	Windows Si consiglia di utilizzare WS_Auto per garantire la migliore qualità di riconoscimento. Se si desidera selezionare lo stile di scrittura corrispondente alla lingua del sistema operativo corrente, utilizzare WS_DetectByLocale.
	Rimosso	Utilizzare la proprietà KeepPageBreaks in sostituzione.
PEM_SingleLineParagraphsWithSpaceFormatting	Rimosso	Utilizzare la proprietàper emulare l’aspetto del testo originale tramite spazi durante l’esportazione in formato TXT.
	Rimosso	Utilizzare la proprietàper selezionare il tipo di crittografia.
	Rimosso	Utilizzare la proprietà LanguageDetectionMode per gestire il rilevamento automatico delle lingue di riconoscimento.
	Rimosso	Utilizzare la nuova proprietà, che elimina i vari livelli di affidabilità e offre una scelta semplice: evidenziare o meno i caratteri riconosciuti con incertezza. Se è necessaria una distinzione più granulare, utilizzare la proprietàdell’oggetto, sebbene il confronto delle affidabilità di riconoscimento per caratteri diversi rispetto alla stessa soglia non fornisca sempre risultati coerenti.
	Deprecato	Utilizzare la proprietàper impostare la modalità di riconoscimento tramite le costanti(RM_Normal corrisponde a BalancedMode = TRUE e RM_Fast corrisponde a FastMode = TRUE).
AEM_FastMode AEM_BalancedMode	Deprecato	I moduli che utilizzavano queste costanti sono deprecati.
	Rimosso	La proprietà che utilizzava questa enumerazione è stata rimossa.
	Rinominato, tipo modificato	Queste proprietà ora si chiamanoe CorrectResolution, e sono di tipo. I valori predefiniti funzionano come in precedenza.
	Rinominato, tipo modificato	Queste proprietà ora si chiamano,, e sono di tipo. I valori predefiniti funzionano come in precedenza.
	Rinominato, tipo modificato	Questa proprietà ora si chiamaed è di tipo. Per impostazione predefinita, le immagini non vengono trattate come parte dello sfondo.
	Rimosso	Le proprietà che utilizzavano queste enumerazioni ora hanno un tipo diverso.
	Deprecato	Questa proprietà è ora deprecata e verrà eliminata nelle versioni future. Gli stessi risultati si ottengono impostando la proprietàsu TXTLRM_ExactCopy.
	Rimosso	Questa proprietà era già deprecata.
	Deprecato	Questa proprietà è ora deprecata e verrà rimossa nelle versioni future.
	Deprecato	Queste proprietà sono ora deprecate e verranno rimosse nelle versioni future.
	Deprecato in Windows e Linux	Questa proprietà è ora deprecata e verrà rimossa nelle versioni future.

Oggetti relativi alla classificazione

Oggetto/Enumerazione	Proprietà/Metodo/Costante	Cosa è cambiato?	Commento
ClassificationEtalon ClassificationParams ClassificationClass ClassificationClasses ClassificationTrainer ClassificationTrainerError ClassificationTrainerErrors ClassificationTrainerErrorTypeEnum ClassificationModeEnum	<br />	Rimosso	La vecchia API di classificazione è stata rimossa. L’addestramento del modello di classificazione viene ora eseguito tramite l’oggetto Trainer, con le impostazioni specificate in TrainingParams e ValidationParams, e con i dati di input forniti tramite TrainingData. È possibile classificare documenti o pagine tramite l’oggetto Model. Sia l’addestramento sia la classificazione richiedono innanzitutto di trasformare un documento o una pagina in un ClassificationObject, operazione che può essere eseguita con i metodi dell’oggetto ClassificationEngine. Vedi anche Classification-Related Objects e la descrizione dello scenario Classification.

Oggetti supplementari

Oggetto/Enumerazione	Proprietà/Metodo/Costante	Cosa è cambiato?	Commento
DocumentInfo		Rimosso	I metodi che richiedevano un oggetto di questo tipo sono stati rimossi.
DocumentInfo	DocumentContentInfo	Rimosso	L’oggetto che contiene informazioni su autore, parole chiave, soggetto e titolo del documento può essere ottenuto tramite la proprietà DocumentContentInfo dell’oggetto FRDocument.

Panoramica

Formati di esportazione

Problemi di compatibilità con le versioni precedenti

Compatibilità tra ABBYY FineReader Engine 12 e 11