Compatibilidad entre ABBYY FineReader Engine 12 y 11

ABBYY FineReader Engine 12 no es compatible a nivel binario con ABBYY FineReader Engine 11. Las aplicaciones compiladas con ABBYY FineReader Engine 11 deben recompilarse con los archivos de encabezado y la biblioteca de ABBYY FineReader Engine 12. Es posible que sea necesario realizar algunos cambios en el código fuente debido a las mejoras introducidas en la API de ABBYY FineReader Engine. Este artículo contiene una lista completa de los cambios, junto con sugerencias para reescribir el código de modo que funcione con la nueva versión. Cambios principales:

Se han eliminado los objetos obsoletos DocumentAnalyzer y Exporter, junto con los métodos de procesamiento del objeto Engine. Utilice los métodos más eficaces de los objetos FRDocument y FRPage, que gestionan toda la información necesaria para el procesamiento completo de documentos. Ya no es necesario mantener el objeto DocumentInfo en todas las etapas del procesamiento, llevar un seguimiento de todos los documentos de imagen con sus layouts correspondientes ni implementar la interfaz IRecognizedPages.
Se ha eliminado la API que proporcionaba acceso a la estructura lógica del documento (DocumentStructure, PageStructure y sus subobjetos). La edición de las propiedades y el contenido del documento mediante los objetos eliminados podía dar lugar a resultados imprevisibles durante la exportación. Si necesita verificar o posprocesar los resultados del reconocimiento, trabaje con los datos mediante el subobjeto Layout de cada FRPage y, cuando haya terminado, llame a cualquiera de los métodos que realizan la síntesis del documento. La estructura lógica del documento se volverá a crear y se usará en la fase de exportación, aunque ya no estará disponible para su edición mediante la API de FineReader Engine. Las versiones futuras de ABBYY FineReader Engine pueden proporcionar acceso de solo lectura a parte de la estructura lógica del documento.
La API de clasificación se ha sustituido por completo por una nueva versión que utiliza algoritmos mejorados y ofrece técnicas integradas de validación cruzada.

El objeto Motor ahora debe cargarse mediante la función InitializeEngine. Las funciones GetEngineObject y GetEngineObjectEx, destinadas a cargar el Motor, se eliminaron de ABBYY FineReader Engine.

objeto Engine

Propiedad/Método/Constante	¿Qué ha ocurrido?	Comentario
CreateDocumentAnalyzer CreateDocumentInfo CreateExporter	Eliminado	Los métodos ya no son necesarios porque se han eliminado los objetos que creaban.
CreateExportFileWriter	Se ha cambiado la firma	Se ha eliminado el parámetro obsoleto PagesCount.
CreateImageDocumentsInMemory <Note> Solo para Windows </Note>	Eliminado	Los documentos de imagen siempre se crean en memoria. Puede usar los métodos SaveTo o SaveToFile cuando necesite guardar el documento de imagen en disco.
CreateLayout	Eliminado	El objeto Layout ya no se puede usar de forma independiente de la página a la que corresponde.
CreateMultipageImageWriter	El comportamiento ha cambiado	Este método ahora admite parámetros ampliados para guardar imágenes en los formatos JPEG y TIFF.
CreateMultipageImageWriterEx	Renombrado	Este método ahora se llama CreateMultipageImageWriter. Se eliminó la implementación anterior del método CreateMultipageImageWriter.
ExportPage	Eliminado	Use el método IFRPage::Export en su lugar.
ExportPagesEx	Eliminado	Utilice el método IFRDocument::Export en su lugar.
InjectTextLayer	El comportamiento ha cambiado	Este método ahora ofrece parámetros adicionales para la inyección de la capa de texto, así como la opción de seleccionar las páginas del archivo PDF que se van a procesar y una interfaz de callback para gestionar advertencias y errores.
InjectTextLayerEx InjectTextLayerEx2	Eliminado	La nueva versión del método InjectTextLayer ahora incluye todas las opciones que antes ofrecían estos métodos.
OpenImageFile	Eliminado	Utilice el método IFRDocument::AddImageFile para abrir un archivo de imagen y añadirlo al documento para su procesamiento. Podrá acceder al objeto ImageDocument a través de la FRPage correspondiente.
PrepareImageFile	Eliminado	Utilice el método IFRDocument::AddImageFile para abrir un archivo de imagen y añadirlo al documento para su procesamiento. Se podrá acceder al objeto ImageDocument a través de la FRPage correspondiente y guardarlo en disco más adelante.
ProcessPage	Eliminado	Use el método IFRDocument::Process en su lugar.
ProcessPagesEx	Eliminado	Utilice el método IFRDocument::Process en su lugar.
SynthesizePagesEx	Eliminado	Use el método IFRDocument::Synthesize en su lugar.
OpenMemoryImageFormat10	Eliminado	Este método se ofrecía únicamente para mantener la compatibilidad con ABBYY FineReader Engine 10.
OpenBitmap OpenBitmapBits<br />OpenDib<br />PrepareBitmap<br />PrepareBitmapBits<br />PrepareDib	En desuso en Linux y macOS	Estas propiedades ya están en desuso y se eliminarán en futuras versiones.

Motor para Java

Método	¿Qué ha ocurrido?	Comentario
Load LoadEx	Eliminado	Métodos obsoletos; use Engine.InitializeEngine en su lugar.

Objetos relacionados con imágenes

Objeto/Enumeración	Propiedad/Método/Constante	¿Qué ha ocurrido?	Comentario
ImageDocument	SuppressColorObjects	Eliminado	En su lugar, use el método RemoveColorObjectsEx, que permite eliminar de una sola vez objetos de varios tonos especificados y también obtener la imagen de los objetos eliminados.
	RemoveGarbage	El comportamiento ha cambiado	Este método sigue buscando ruido en el plano de blanco y negro, pero lo elimina de todos los planos de color de la imagen.
	RemoveGarbageEx	Renombrado	Este método ahora se llama RemoveGarbage. La implementación anterior de ese método se ha eliminado.
PrepareImageMode	ImageCompression	Renombrado, tipo cambiado	Esta propiedad ahora se llama CompressImage y es del tipo ThreeStatePropertyValueEnum. El valor predeterminado funciona igual que antes.
PrepareImageMode	KeepOriginalCoordinatesInfo	Obsoleto	Esta propiedad ahora está obsoleta y se eliminará en futuras versiones.
ImageCompressionEnum		Eliminado	La propiedad que usaba esta enumeración ahora tiene otro tipo.
Image	EstimateBitmapSize GetBitmap	Obsoleto en Linux y macOS	Estos métodos ahora están obsoletos y se eliminarán en futuras versiones.
TrainingImage	SetBitmapBits	Obsoleto en Linux y macOS	Este método ahora está obsoleto y se eliminará en futuras versiones.

Objetos relacionados con el diseño

Objeto/Enumeración	Propiedad/Método/Constante	¿Qué ha ocurrido?	Comentario
Block	BackgroundColor	El comportamiento ha cambiado	Esta propiedad ahora es de solo lectura.
Block	BlockLayerType	El comportamiento ha cambiado	Esta propiedad ahora es de solo lectura. En RasterPictureBlock y VectorPictureBlock, el tipo de capa se puede cambiar mediante el método SetBlockLayerType.
BlockLayerTypeEnum	BLT_Unknown	Eliminado	Esta constante ya no se usa.

Objetos relacionados con el texto


	Eliminado	Estas propiedades ya no son compatibles: ya no es posible detectar la división de un párrafo entre dos páginas.
	Eliminado	Esta propiedad devolvía el ID del objeto PageElement correspondiente a la imagen y ya no es útil, ya que el objeto PageElement se ha eliminado junto con el resto de la API de estructura de documentos.
	El comportamiento ha cambiado	Este método ahora requiere especificar el nombre del marcador de usuario con el formato “UserDefinedBookmark:<my_user_bookmark>”.
	Eliminado	Ahora solo se puede acceder a las propiedades del párrafo a través del objeto.
	El comportamiento ha cambiado	Estas propiedades son ahora de solo lectura. No es posible editar ninguna propiedad del estilo de párrafo.
	Eliminado	No es posible editar ni copiar ninguna propiedad del estilo de párrafo desde otro objeto.
	Eliminado	El estilo de párrafo es accesible a través del objeto.
	Renombrado	Este método ahora se denomina AddNew. La implementación anterior del método AddNew ha sido eliminada.
	El comportamiento ha cambiado	Este método ahora permite definir todas las propiedades del relleno de tabulación en el momento de su creación.
	Eliminado	Todas las propiedades de una tabulación deben especificarse al crear el objeto mediante el métododel objeto. No es posible modificarlas ni copiarlas desde otro objeto.
	El comportamiento ha cambiado	Las propiedades son ahora de solo lectura. Deben especificarse al crear el objeto mediante elmethod 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.
	Eliminado	Esta propiedad quedó obsoleta y estaba programada para su eliminación. Fue reemplazada por dos propiedades:, que especifica el primer carácter de la palabra al leerla de izquierda a derecha, y, que especifica el primer carácter en sentido lógico según la dirección de lectura del idioma.
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.

Objetos relacionados con documentos


		Renombrado	Esta interfaz ahora se denomina. La versión anterior de dicha interfaz ha sido eliminada.
		Parámetros modificados	Este método ahora cuenta con un parámetro adicional que especifica el índice de la página del documento a la que hace referencia la advertencia.
		Eliminado	Estos objetos representaban la estructura lógica del documento y sus distintas partes. La edición de la estructura del documento ya no está disponible, ya que un uso incorrecto podría afectar la apariencia del documento exportado; cualquier verificación de texto u otras modificaciones pueden realizarse a través de la API del documento (,y subobjetos). Las versiones futuras de ABBYY FineReader Engine podrían ofrecer acceso de solo lectura a parte de la estructura lógica del documento.
		Eliminado	Estas enumeraciones eran utilizadas por los objetos de estructura del documento que ya no están disponibles.
		El comportamiento ha cambiado	Este método ahora ofrece parámetros ampliados para la detección de páginas vacías.
		Renombrado	Este método ahora se denomina. La implementación anterior del método IsEmpty ha sido eliminada.
		Eliminado	La clasificación de páginas ahora puede realizarse con elmétodo del objeto. Requiere como parámetro de entrada un, que puede crearse con elmétodo.
		Obsoleto	Esta propiedad está obsoleta y se eliminará en versiones futuras. Utilice elmétodo para determinar si un archivo tiene contenido textual.

Batch Processor

Objeto/Enumeración	Propiedad/Método/Constante	¿Qué ha ocurrido?	Comentario
BatchProcessor	StartEx	Eliminado	El método Start ahora usa la interfaz avanzada de origen de imágenes, que a su vez ha pasado a llamarse IImageSource.
IImageSourceEx	<br />	Renombrado	Esta interfaz ahora se llama IImageSource.
IImageSource	<br />	El comportamiento ha cambiado	Esta interfaz ahora permite añadir documentos de imagen, además de archivos de imagen, a la cola.

Objetos del mecanismo


	Eliminado	El objeto ha quedado obsoleto. Sus métodos fueron sustituidos por métodos más eficientes de los objetosy, que no requieren mantener el objeto DocumentInfo en todas las etapas del procesamiento ni implementar la interfaz IRecognizedPages.
	Eliminado	Use los métodos,,para trabajar con diccionarios en caché.
	Eliminado	Use el métodoen su lugar.
	Eliminado	Use el métodoen su lugar.
	Eliminado	Use el métodoen su lugar.
	Eliminado	Use el métodoen su lugar.
	Eliminado	Use la propiedad, que funciona exactamente igual.
	Eliminado	Use el método, que funciona exactamente igual.
	Eliminado	Use el método IImageDocument::RemoveGeometricalDistortions en su lugar.
	Eliminado	Use el métodoen su lugar.
	Eliminado	Use el métodoen su lugar.
	Eliminado	Use el métodoen su lugar.
	Eliminado	Utilice en su lugar el método.
	Eliminado	Utilice en su lugar el método.
	Eliminado	Utilice en su lugar el método. Realiza el procesamiento completo del documento, incluida la síntesis del documento.
	Eliminado	Utilice en su lugar el método.
	Eliminado	Utilice en su lugar el método.
	Eliminado	Utilice en su lugar el método.
	Eliminado	Para reconocer una imagen como texto sin formato, cree el objetoa partir de la imagen mediante el método, utilice el métodopara reconocer el documento y, a continuación, acceda a la propiedad.
	Eliminado	Para reconocer la página como texto sin formato, utilice el métodoy, a continuación, acceda a la propiedad.
	Eliminado	Utilice en su lugar el método.
	Eliminado	Utilice en su lugar el método.
	Eliminado	El objeto está obsoleto. Sus métodos fueron reemplazados por métodos más eficientes de los objetosy, que no requieren mantener el objeto DocumentInfo en todas las etapas de procesamiento ni implementar la interfaz IRecognizedPages.
	Eliminado	Utilice en su lugar el método.
	Eliminado	Use el métodoen su lugar.
	Eliminado	Esta interfaz ya no es necesaria porque el objeto que notificaba eventos ha sido eliminado. Las interfaceseproporcionan información similar sobre el progreso y los errores para los objetos que reemplazaron a DocumentAnalyzer.
	Eliminado	Esta interfaz ya no es necesaria porque el objeto que notificaba eventos ha sido eliminado. Las interfaceseproporcionan información similar sobre el progreso y los errores para los objetos que reemplazaron a Exporter.
	Eliminado	Los métodos que requerían un objeto de este tipo han sido eliminados.
FREM_DocumentAnalyzer	Eliminado	Esta constante ya no está en uso.

objetos Parameter


	Eliminado	Esta propiedad está obsoleta desde FineReader Engine 11. Utilice en su lugar la propiedad
	Eliminado	Esta propiedad está obsoleta desde FineReader Engine 11. Utilice en su lugar la propiedaddel objeto
	Eliminado	Utilice la propiedadpara emular el diseño original del texto mediante espacios.
WS_Default	Eliminado	Windows Se recomienda utilizar WS_Auto para garantizar la mejor calidad de reconocimiento. Si necesita seleccionar el estilo de escritura correspondiente al idioma del sistema operativo actual, utilice WS_DetectByLocale.
	Eliminado	Utilice en su lugar la propiedad KeepPageBreaks.
PEM_SingleLineParagraphsWithSpaceFormatting	Eliminado	Utilice la propiedadpara emular la apariencia original del texto mediante espacios al exportar al formato TXT.
	Eliminado	Utilice la propiedadpara seleccionar el tipo de cifrado.
	Eliminado	Utilice la propiedad LanguageDetectionMode para gestionar la detección automática de idiomas de reconocimiento.
	Eliminado	Utilice la nueva propiedadque prescinde de los distintos niveles de confianza y ofrece una elección sencilla: resaltar o no los caracteres reconocidos con incertidumbre. Si necesita una distinción más precisa, utilice la propiedaddel, aunque comparar las puntuaciones de confianza de reconocimiento de distintos caracteres con el mismo umbral puede no siempre ofrecer resultados coherentes.
	Obsoleto	Utilice la propiedadpara establecer el modo de reconocimiento mediante las constantes de(RM_Normal corresponde a BalancedMode = TRUE y RM_Fast corresponde a FastMode = TRUE).
AEM_FastMode AEM_BalancedMode	Obsoleto	Los módulos que utilizaban estas constantes están obsoletos.
	Eliminado	La propiedad que utilizaba esta enumeración ha sido eliminada.
	Renombrado, tipo modificado	Estas propiedades ahora se denominany CorrectResolution, y son de tipo. Los valores predeterminados funcionan igual que antes.
	Renombrado, tipo modificado	Estas propiedades ahora se denominan,, y son de tipo. Los valores predeterminados funcionan igual que antes.
	Renombrado, tipo modificado	Esta propiedad ahora se denominay es de tipo. De forma predeterminada, las imágenes no se tratan como parte del fondo.
	Eliminado	Las propiedades que utilizaban estas enumeraciones ahora son de otro tipo.
	Obsoleto	Esta propiedad está obsoleta y se eliminará en versiones futuras. Los mismos resultados se pueden obtener estableciendo la propiedaden TXTLRM_ExactCopy.
	Eliminado	Esta propiedad ya estaba en desuso.
	En desuso	Esta propiedad está en desuso y se eliminará en versiones futuras.
	En desuso	Estas propiedades están en desuso y se eliminarán en versiones futuras.
	En desuso en Windows y Linux	Esta propiedad está en desuso y se eliminará en versiones futuras.

Objetos relacionados con la clasificación

Objeto/Enumeración	Propiedad/Método/Constante	¿Qué ha ocurrido?	Comentario
ClassificationEtalon ClassificationParams ClassificationClass ClassificationClasses ClassificationTrainer ClassificationTrainerError ClassificationTrainerErrors ClassificationTrainerErrorTypeEnum ClassificationModeEnum	<br />	Eliminado	Se ha eliminado la antigua API de clasificación. El entrenamiento del modelo de clasificación ahora se realiza mediante el objeto Trainer, con la configuración especificada en TrainingParams y ValidationParams, y los datos de entrada proporcionados como TrainingData. La clasificación de documentos o páginas puede realizarse mediante el objeto Model. Tanto el entrenamiento como la clasificación requieren convertir previamente un documento o una página en un ClassificationObject, lo que puede hacerse con los métodos del objeto ClassificationEngine. Consulte también Objetos relacionados con la clasificación y la descripción del escenario Clasificación.

Objetos complementarios

Objeto/Enumeración	Propiedad/Método/Constante	¿Qué ha ocurrido?	Comentario
DocumentInfo		Eliminado	Se han eliminado los métodos que requerían un objeto de este tipo.
DocumentInfo	DocumentContentInfo	Eliminado	El objeto que contiene información sobre el autor, las palabras clave, el asunto y el título del documento puede obtenerse mediante la propiedad DocumentContentInfo del objeto FRDocument.

Información general

Formatos de exportación

Problemas de compatibilidad con versiones anteriores

Compatibilidad entre ABBYY FineReader Engine 12 y 11