Oggetto FRPage (interfaccia IFRPage)

Proprietà
Metodi
Oggetti correlati
Parametro di output
Parametro di input
Visual Components associati
Esempi
Vedi anche

Questo oggetto corrisponde a una pagina.

In Linux e Windows, può trattarsi di una pagina di un documento oppure di una pagina prodotta da Batch Processor.

Fornisce un insieme di metodi per la preelaborazione della pagina, l’analisi, il riconoscimento, la sintesi della pagina e l’esportazione. I metodi di questo oggetto non eseguono la sintesi del documento (tranne il metodo Synthesize). Prima di esportare i risultati, è necessario chiamare esplicitamente un metodo che esegua la sintesi del documento. Per ulteriori dettagli, vedere Tuning Parameters of Preprocessing, Analysis, Recognition, and Synthesis. L’oggetto FRPage è un cosiddetto “oggetto connettibile.” In Visual Basic in FRE for Windows, può essere dichiarato con WithEvents. In C++ (in tutti i sistemi operativi supportati), questo significa che supporta l’interfaccia IConnectionPointContainer. Per ricevere notifiche di evento durante l’elaborazione, gli utenti C++ devono creare un oggetto derivato dall’interfaccia IFRPageEvents e…

In Linux e macOS, collegarlo all’oggetto FRPage chiamando la funzione globale AdviseFREngineObject.
In Windows: configurare la connessione tra tale oggetto e l’origine eventi implementata nell’oggetto FRPage tramite i meccanismi COM standard.

In Windows, i metodi dell’oggetto FRPage segnalano informazioni sull’avanzamento dell’elaborazione della pagina tramite speciali interfacce in uscita. Queste interfacce sono IFRPageEvents (per C++) e la dispinterface DIFRPageEvents (per Visual Basic). Va notato che gli utenti di Visual Basic non devono preoccuparsi dei dettagli di implementazione delle interfacce evento, poiché questa piattaforma di sviluppo fornisce strumenti semplici per gestirle.

Proprietà


	,read-only	Restituisce l’oggetto Engine.

	,read-only	Restituisce il documento che contiene la pagina.
	,read-only	Fornisce accesso all’immagine della pagina.
		Fornisce accesso al layout della pagina. Quando si assegna un oggetto Layout a questa proprietà (ad esempio, durante il trasferimento di dati da una pagina a un’altra), la struttura logica del documento corrispondente non è più valida. È necessario ripristinare la struttura del documento chiamando uno dei metodi di sintesi. Non è tuttavia necessario eseguire la sintesi dell’intero documento: è sufficiente sintetizzare solo le pagine modificate, ad esempio tramite il metodoSynthesize.
	,read-only	Restituisce il testo della pagina in uno speciale formato “plain text”.
	, read-only	Specifica il percorso completo dell’immagine sorgente della pagina.

	, read-only	Specifica la lingua principale della pagina riconosciuta. La proprietà contiene il nome interno della prima lingua nella raccolta delle lingue rilevate (proprietà DetectedLanguages). Questa proprietà ha un valore significativo solo se il riconoscimento è stato eseguito con il rilevamento automatico della lingua attivato (vedere la proprietàper i dettagli). Per impostazione predefinita, è una stringa vuota.
	,read-only	Fornisce accesso alla raccolta delle lingue di riconoscimento rilevate nella pagina riconosciuta. Le lingue nella raccolta sono ordinate per frequenza di occorrenza: dalla più frequente alla meno frequente. Questa proprietà ha un valore significativo solo se il riconoscimento è stato eseguito con il rilevamento automatico della lingua attivato (vedere la proprietàper i dettagli). L’elenco delle lingue viene aggiornato solo dopo il riconoscimento; pertanto, se si modifica manualmente il layout della pagina, la raccolta rimane invariata.

	, di sola lettura	Specifica se la struttura logica della pagina non è aggiornata. Se questa proprietà è TRUE, è necessario eseguire la sintesi del documento per la pagina prima dell’esportazione. In caso contrario, si verificherà un errore durante l’esportazione. Questa proprietà è utile quando si lavora con i Visual Components. La struttura logica di una pagina diventa non valida se un utente modifica il layout della pagina tramite l’interfaccia grafica dei Visual Components. Se l’esportazione di tale pagina viene eseguita tramite i comandi disponibili nei Visual Components, i Visual Components sintetizzano la pagina automaticamente. Se invece si utilizzano i metodi API di FineReader Engine per l’esportazione, è responsabilità dell’utente eseguire la sintesi del documento per la pagina prima dell’esportazione.
	, di sola lettura	Restituisce l’indice della pagina nel file sorgente.
	, di sola lettura	Indica se il file sorgente di questa pagina era un PDF con firma digitale.

	,di sola lettura	Fornisce accesso alla raccolta di biglietti da visita rilevati nella pagina.

		I Visual Components sono attualmente supportati solo per Windows. Specifica se i metodi Undo e Redo sono abilitati. Se il valore di questa proprietà è TRUE, tutti i comandi richiamati tramite i metodi che possono modificare la pagina (come i metodi di FRPage o dell’object) oppure dai Visual Components di Windows possono essere aggiunti a uno stack di annullamento. In questo caso, i comandi richiamati dai Visual Components vengono aggiunti allo stack automaticamente. Per aggiungere allo stack i comandi richiamati dall’API, utilizzare il metodo Update. La proprietà non può essere impostata su FALSE per una pagina aperta nei Visual Components.
	, read-only	I Visual Components sono attualmente supportati solo per Windows. Specifica se il metodo Redo può essere eseguito per l’ultimo comando annullato, richiamato tramite uno dei metodi che possono modificare la pagina (come i metodi di FRPage o dell’object) oppure da uno dei Visual Components.
	, read-only	I Visual Components sono attualmente supportati solo per Windows. Specifica se il metodo Undo può essere eseguito per l’ultimo comando richiamato tramite uno dei metodi che possono modificare la pagina (come i metodi di FRPage o dell’object) oppure da uno dei Visual Components.

Metodi

Nome	Descrizione
AddWordsToCacheDictionary	Questo metodo aggiunge un insieme di parole al dizionario cache.
AddWordToCacheDictionary	Questo metodo aggiunge una parola al dizionario cache.
Analyze	Analizza la pagina.
AnalyzeRegion	Analizza il layout dell’immagine nella regione specificata.
AnalyzeTable	Sostituisce il blocco specificato con un blocco di tabella e ne analizza la struttura.
CleanCacheDictionary	Questo metodo elimina tutte le parole dal dizionario cache.
DetectOrientation	Rileva l’orientamento della pagina.
DetectResolution	Seleziona la risoluzione ottimale nell’intervallo specificato.
Export	Salva una Pagina in un file in un formato esterno.
ExtractBarcodes	Trova e riconosce tutti i Block di barcode.
ExtractMrz	Estrae i dati da una zona leggibile meccanicamente (MRZ).
FindPageSplitPosition	Individua la posizione in cui l’immagine può essere divisa.
Flush	Scarica dalla memoria e, se necessario, salva su disco gli oggetti ImageDocument e Layout associati all’oggetto FRPage, se non vi sono riferimenti a essi. Il salvataggio su disco è facoltativo; è possibile omettere questa fase se i dati non sono stati modificati.
IsEmpty	Verifica se la pagina è vuota.
LearnCheckmarks	Addestra FineReader Engine a riconoscere segni di spunta di tipo personalizzato.
PreprocessAnalyzeRecognize	Esegue il pretrattamento, l’analisi del layout, il riconoscimento e la sintesi della pagina.
Preprocess	Esegue il pretrattamento della pagina: corregge l’orientamento della pagina, l’inversione e le distorsioni geometriche. Il pretrattamento della pagina viene eseguito prima dell’analisi della pagina.
Recognize	Riconosce la pagina e ne esegue la sintesi.
RecognizeBlocks	Riconosce il testo ed esegue la sintesi della pagina in un insieme di blocchi definito esplicitamente.
Redo	<Warning> I Visual Components sono attualmente supportati solo per Windows. </Warning> Riesegue l’ultimo comando annullato richiamato dall’API FineReader Engine.
Synthesize	Esegue la sintesi del documento per la singola pagina. In Linux e Windows, questo metodo può essere utile per l’elaborazione di documenti di una sola pagina con Batch Processor.
SynthesizeBusinessCard	Tenta di individuare i field del biglietto da visita nella regione riconosciuta indicata.
SynthesizeBusinessCardEx	Tenta di trovare i field del biglietto da visita nella regione riconosciuta specificata utilizzando i parametri di sintesi.
Undo	<Warning> Visual Components sono attualmente supportati solo in Windows. </Warning> Annulla l’ultimo comando richiamato tramite l’API di FineReader Engine.
Update	<Warning> Visual Components sono attualmente supportati solo in Windows. </Warning> In Linux e macOS: salva nello stack di annullamento le modifiche al layout di pagina. In Windows: trasferisce a Visual Components le modifiche al layout di pagina apportate tramite FineReader Engine API e salva tali modifiche nello stack di annullamento. <Note> Quando si chiama questo metodo, la struttura logica del documento corrispondente viene invalidata. È necessario ripristinare la struttura del documento chiamando uno dei metodi di sintesi. Tuttavia, non è necessario eseguire la sintesi per l’intero documento: è sufficiente sintetizzare solo le pagine modificate, ad esempio usando il metodo Synthesize. </Note>

Diagramma degli oggetti

Parametro di output

Questo oggetto è il parametro di output dei seguenti metodi:

metodo Item dell’oggetto FRPages
In Linux e in Windows: metodo GetNextProcessedPage dell’oggetto BatchProcessor

Parametro di input

Questo oggetto viene passato come parametro di input ai metodi seguenti:

metodo IndexOf dell’oggetto FRPages
metodo AddPage dell’oggetto FRDocument
metodo AddPage dell’oggetto ExportFileWriter
metodo CreateObjectFromPage dell’oggetto ClassificationEngine
metodi OnProgress, OnWarning, OnRegionProcessed, OnPageProcessed dell’interfaccia IFRPageEvents
metodo PageRemoved dell’interfaccia IFRPagesEvents
metodo ComparePages dell’oggetto Comparator
In Linux e in Windows: metodo ProcessPageAsync dell’oggetto BatchProcessor
In Windows, con Visual Components:
- metodi OnActivePageChanged, OnActivePageChanging dell’interfaccia DocumentViewerEvents
- metodi OnActivePageChanged, OnActivePageChanging dell’interfaccia IImageViewerEvents
- metodo OnActivePageChanged dell’interfaccia IZoomViewerEvents
- metodi OnActivePageChanged, OnActivePageChanging dell’interfaccia ITextEditorEvents
- metodo OnActivePageChanged dell’interfaccia ITextValidatorEvents

Esempi

Codice C#

FREngine.IEngine engine;
string fileName;
FREngine.IBatchProcessor batchProcessor;
// Si presume che Batch Processor sia stato creato e avviato
// Recupera le pagine riconosciute ed esportale in formato PDF
FREngine.IFRPage page = batchProcessor.GetNextProcessedPage();
while( page != null ) {
 // Esegui la sintesi della pagina prima dell'esportazione
 page.Synthesize(null);
 // Esporta la pagina in un file
 page.Export(fileName, FREngine.FileExportFormatEnum.FEF_PDF, null);
 page = batchProcessor.GetNextProcessedPage();
}

L’oggetto viene utilizzato nei seguenti esempi di codice:

macOS: Riconoscimento dei biglietti da visita e RecognizedTextProcessing
Linux: BCR, BatchProcessing, CustomLanguage, CommandLineInterface
Windows: BatchProcessing, CustomLanguage, CommandLineInterface, RecognizedTextProcessing, VisualComponents e strumenti demo: BatchProcessingRecognition, Profili di elaborazione predefiniti dell’Engine.

Vedi anche

FRPages Utilizzo degli oggetti connettibili Utilizzo delle proprietà

Metodo Swap dell'oggetto FRPages

Metodo AddWordsToCacheDictionary dell'oggetto FRPage

⌘I

Panoramica

Funzioni

Oggetto Engine (interfaccia IEngine)

Loader di Engine

Oggetti correlati alle immagini

Oggetti correlati al Layout

Oggetti relativi alla lingua

Oggetti relativi al testo

Oggetti relativi al documento

Batch Processor

Oggetti del meccanismo

Oggetti Parameter

Oggetti correlati alla classificazione

Oggetti correlati alle licenze

Oggetti per il confronto dei documenti

Oggetti e metodi di supporto

Enumerazioni

Oggetto FRPage (interfaccia IFRPage)

Proprietà

Metodi

Parametro di output

Parametro di input

Esempi

Vedi anche

Panoramica

Funzioni

Oggetto Engine (interfaccia IEngine)

Loader di Engine

Oggetti correlati alle immagini

Oggetti correlati al Layout

Oggetti relativi alla lingua

Oggetti relativi al testo

Oggetti relativi al documento

Batch Processor

Oggetti del meccanismo

Oggetti Parameter

Oggetti correlati alla classificazione

Oggetti correlati alle licenze

Oggetti per il confronto dei documenti

Oggetti e metodi di supporto

Enumerazioni

​Proprietà

​Metodi

​Oggetti correlati

​Parametro di output

​Parametro di input

​Visual Components associati

​Esempi

​Vedi anche

Proprietà

Metodi

Oggetti correlati

Parametro di output

Parametro di input

Visual Components associati

Esempi

Vedi anche