Objeto FRPage (interfaz IFRPage)

Este objeto corresponde a una página.

En Linux y Windows, puede tratarse de una página de un documento o de una página generada por Batch Processor.

Proporciona un conjunto de métodos para el preprocesamiento, el análisis, el reconocimiento, la síntesis de páginas y la exportación. Los métodos de este objeto no realizan la síntesis de documentos (excepto el método Synthesize). Antes de exportar los resultados, debe llamar explícitamente a algún método que realice la síntesis del documento. Consulte Parámetros de ajuste del preprocesamiento, análisis, reconocimiento y síntesis para obtener más información.

El objeto FRPage es un denominado “objeto conectable.” En Visual Basic para FRE en Windows, puede declararse con WithEvents. Para C++ (en todos los sistemas operativos compatibles), esto significa que admite la interfaz IConnectionPointContainer. Para recibir eventos de notificación durante el procesamiento, los usuarios de C++ deben crear un objeto derivado de la interfaz IFRPageEvents y…

• En Linux y macOS, asociarlo al objeto FRPage mediante una llamada a la función global AdviseFREngineObject.
• En Windows: configurar la conexión entre dicho objeto y el origen de eventos implementado en el objeto FRPage mediante mecanismos COM estándar.

En Windows: Los métodos del objeto FRPage informan sobre el progreso del procesamiento de la página a través de interfaces salientes especiales. Estas interfaces son IFRPageEvents (para C++) y la dispinterface DIFRPageEvents (para Visual Basic). Cabe señalar que los usuarios de Visual Basic no deben preocuparse por los detalles de la implementación de interfaces de eventos, ya que esta plataforma de desarrollo proporciona mecanismos sencillos para controlarlas.

​

Propiedades

	, de solo lectura	Devuelve el objeto Engine.
	, de solo lectura	Devuelve el documento que contiene la página.
	, de solo lectura	Proporciona acceso a la imagen de la Página.
		Proporciona acceso al layout de la página. Al asignar un objeto Layout a esta propiedad (por ejemplo, al transferir datos de una página a otra), la estructura lógica del documento correspondiente deja de ser válida. Es necesario restaurar la estructura del documento invocando uno de los métodos de síntesis. Sin embargo, no es necesario realizar la síntesis de todo el documento; solo hay que sintetizar las páginas modificadas, por ejemplo, mediante el método Synthesize.
	, de solo lectura	Devuelve el texto de la página en un formato especial de “texto sin formato”.
	, de solo lectura	Especifica la ruta completa de la imagen de origen de la página.
	, de solo lectura	Especifica el idioma principal de la página reconocida. La propiedad contiene el nombre interno del primer idioma de la colección de idiomas detectados (propiedad DetectedLanguages ). Esta propiedad solo tiene un valor válido si el reconocimiento se realizó con la detección automática de idioma activada (consulte la propiedad para más información). De forma predeterminada, es una cadena vacía.
	, de solo lectura	Proporciona acceso a la colección de idiomas de reconocimiento detectados en la página reconocida. Los idiomas de la colección se ordenan por frecuencia de aparición: del más frecuente al menos frecuente. Esta propiedad solo tiene un valor significativo si el reconocimiento se realizó con la detección automática de idioma activada (consulte la property para obtener más información). La lista de idiomas se actualiza solo después del reconocimiento; es decir, si edita manualmente la disposición de la página, la colección permanece igual.
	, de solo lectura	Especifica si la estructura lógica de la página no está actualizada. Si esta propiedad es TRUE, debe realizar la síntesis del documento de la página antes de exportarla. De lo contrario, se producirá un error durante la exportación. Esta propiedad resulta útil al trabajar con Visual Components. La estructura lógica de una página deja de ser válida si un usuario cambia el layout de esa página a través de la interfaz gráfica de usuario de Visual Components. Si la exportación de esa página se realiza mediante los comandos disponibles en Visual Components, Visual Components sintetizan la página automáticamente. Sin embargo, si utiliza métodos de la API de FineReader Engine para exportarla, usted es responsable de realizar la síntesis del documento de la página antes de la exportación.
	, de solo lectura	Devuelve el índice de la página en el archivo fuente.
	, de solo lectura	Indica si el archivo de origen de esta página era un PDF con firma digital.
	, de solo lectura	Permite acceder a la colección de tarjetas de visita detectadas en la página.
		Actualmente, Visual Components solo es compatible con Windows. Especifica si se permiten los métodos Undo y Redo . Si el valor de esta propiedad es TRUE, todos los comandos invocados mediante métodos que pueden modificar la página (como los métodos del FRPage o del objeto) o desde Visual Components para Windows pueden añadirse a una pila de deshacer. En este caso, los comandos invocados desde Visual Components se agregan a la pila automáticamente. Para agregar a la pila los comandos invocados desde la API, use el método Update. La propiedad no se puede establecer en FALSE para una página que se haya abierto en Visual Components.
	, de solo lectura	Actualmente, Visual Components solo son compatibles con Windows. Especifica si el método Redo puede ejecutarse para el último comando deshecho, invocado mediante uno de los métodos que pueden modificar la página (como los métodos del objeto FRPage o del objeto) o desde uno de los Visual Components.
	, de solo lectura	Actualmente, Visual Components solo son compatibles con Windows. Especifica si el método Undo puede ejecutarse para el último comando que se haya invocado, ya sea mediante uno de los métodos que pueden modificar la página (como los métodos de FRPage o el objeto) o desde uno de los Visual Components.

​

Métodos

Nombre	Descripción
AddWordsToCacheDictionary	Este método añade un grupo de palabras al diccionario de caché.
AddWordToCacheDictionary	Este método añade una palabra al diccionario de la caché.
Analyze	Analiza la página.
AnalyzeRegion	Analiza la disposición de la imagen dentro de la región especificada.
AnalyzeTable	Reemplaza un bloque especificado por un bloque de tabla y analiza la estructura de la tabla.
CleanCacheDictionary	Este método elimina todas las palabras del diccionario de la caché.
DetectOrientation	Detecta la orientación de la página.
DetectResolution	Selecciona la resolución óptima dentro del intervalo especificado.
Export	Guarda una página en un archivo en un formato externo.
ExtractBarcodes	Detecta y reconoce todos los bloques de códigos de barras.
ExtractMrz	Extrae datos de una zona legible por máquina (MRZ).
FindPageSplitPosition	Determina la posición en la que se puede dividir la imagen.
Flush	Descarga y, si es necesario, guarda en disco los objetos ImageDocument y Layout correspondientes al objeto FRPage si no hay referencias a ellos. Guardar en disco es opcional; puede omitir esta etapa si los datos no han cambiado.
IsEmpty	Comprueba si la página está vacía.
LearnCheckmarks	Entrena FineReader Engine para que reconozca marcas de verificación de un tipo personalizado.
PreprocessAnalyzeRecognize	Realiza el preprocesamiento, el análisis de la disposición, el reconocimiento y la síntesis de la página.
Preprocess	Preprocesa la página: corrige su orientación, la inversión y las distorsiones geométricas. El preprocesamiento se realiza antes del análisis de la página.
Recognize	Reconoce la página y realiza la síntesis de la página.
RecognizeBlocks	Reconoce texto y realiza la síntesis de la página en un conjunto de bloques especificado explícitamente.
Redo	Nota: Visual Components actualmente solo son compatibles con Windows. Vuelve a ejecutar el último comando deshecho que se llamó desde la API de FineReader Engine.
Synthesize	Realiza la síntesis del documento para la página individual. En Linux y Windows, este método puede ser útil al procesar documentos de una sola página con Batch Processor.
SynthesizeBusinessCard	Intenta encontrar los campos de una tarjeta de presentación en la región reconocida especificada.
SynthesizeBusinessCardEx	Intenta encontrar los campos de una tarjeta de presentación en la región reconocida especificada mediante los parámetros de síntesis.
Deshacer	Nota: Visual Components actualmente solo está disponible para Windows. Deshace el último comando ejecutado desde la API de FineReader Engine.
Update	Nota: Visual Components actualmente solo es compatible con Windows. Transfiere los cambios en el diseño de la página realizados mediante la API de FineReader Engine a Visual Components y guarda estos cambios en la pila de deshacer. Nota: Al llamar a este método, la estructura lógica del documento correspondiente queda invalidada. Es necesario restaurar la estructura del documento llamando a uno de los métodos de síntesis. Sin embargo, no es necesario realizar la síntesis de todo el documento; solo es necesario sintetizar las páginas modificadas, por ejemplo, mediante el método Synthesize.

​

Objetos relacionados

Diagrama de objetos

​

Parámetro de salida

Este objeto es el parámetro de salida de los siguientes métodos:

• método Item del objeto FRPages
• En Linux y Windows: método GetNextProcessedPage del objeto BatchProcessor

​

Parámetro de entrada

Este objeto se pasa como parámetro de entrada a los siguientes métodos:

• método IndexOf del objeto FRPages
• método AddPage del objeto FRDocument
• método AddPage del objeto ExportFileWriter
• método CreateObjectFromPage del objeto ClassificationEngine
• métodos OnProgress, OnWarning, OnRegionProcessed, OnPageProcessed de la interfaz IFRPageEvents
• método PageRemoved de la interfaz IFRPagesEvents
• método ComparePages del objeto Comparator
• En Linux y Windows: método ProcessPageAsync del objeto BatchProcessor
• En Windows, con Visual Components:
  • métodos OnActivePageChanged, OnActivePageChanging de la interfaz DocumentViewerEvents
  • métodos OnActivePageChanged, OnActivePageChanging de la interfaz IImageViewerEvents
  • método OnActivePageChanged de la interfaz IZoomViewerEvents
  • métodos OnActivePageChanged, OnActivePageChanging de la interfaz ITextEditorEvents
  • método OnActivePageChanged de la interfaz ITextValidatorEvents

​

Visual Components relacionados

​

Ejemplos

Código C#

FREngine.IEngine engine;
string fileName;
FREngine.IBatchProcessor batchProcessor;
// Suponemos que Batch Processor ya se ha creado e iniciado
// Obtener las páginas reconocidas y exportarlas en formato PDF
FREngine.IFRPage page = batchProcessor.GetNextProcessedPage();
while( page != null ) {
 // Sintetizar la página antes de exportarla
 page.Synthesize(null);
 // Exportar la página a un archivo
 page.Export(fileName, FREngine.FileExportFormatEnum.FEF_PDF, null);
 page = batchProcessor.GetNextProcessedPage();
}

El objeto se utiliza en los siguientes ejemplos de código:

• macOS: Business Card Recognition y RecognizedTextProcessing
• Linux: BCR, BatchProcessing, CustomLanguage, CommandLineInterface
• Windows: BatchProcessing, CustomLanguage, CommandLineInterface, RecognizedTextProcessing, VisualComponents y herramientas de demostración: BatchProcessingRecognition, Engine Predefined Processing Profiles.

​

Consulte también

FRPages

Trabajar con objetos conectables

Trabajar con propiedades