Oggetto RecognizerParams (interfaccia IRecognizerParams)

Questo oggetto consente di configurare i parametri di riconoscimento. Ogni blocco di testo e ogni cella di tabella nel layout ha un proprio oggetto figlio di tipo RecognizerParams. Inoltre, questo oggetto viene passato come sottooggetto dell’oggetto PageProcessingParams alle funzioni di analisi del layout e riconoscimento di ABBYY FineReader Engine. Le funzioni di riconoscimento utilizzano i parametri di riconoscimento definiti negli oggetti figlio di tipo RecognizerParams dei blocchi di testo e delle celle di tabella. Ogni volta che un blocco di testo o una cella di tabella viene creato durante l’analisi del layout, le proprietà del relativo oggetto figlio di tipo RecognizerParams vengono inizializzate con i valori delle proprietà dell’oggetto RecognizedParams passato alla funzione di analisi. Le proprietà di un sottooggetto del blocco creato con il metodo AddNew dell’oggetto LayoutBlocks vengono impostate su valori predefiniti adeguati. Per conoscere il valore predefinito di una determinata proprietà, vedere la relativa descrizione. L’oggetto RecognizerParams è un oggetto persistente. Ciò significa che lo stato corrente dell’oggetto può essere scritto in un’archiviazione persistente. In seguito, l’oggetto può essere ricreato leggendo il suo stato dall’archiviazione persistente. I seguenti metodi consentono di mantenere la persistenza dell’oggetto: Linux: SaveToFile e LoadFromFile Windows SaveToFile, LoadFromFile, SaveToMemory e LoadFromMemory.

Proprietà


	,read-only	Restituisce l’oggetto Engine.

		Specifica la lingua da utilizzare per il riconoscimento. Questa proprietà può essere impostata facilmente tramite il metodomethod. La proprietà restituisce un oggetto costante. Per modificare la lingua di riconoscimento, è necessario prima ottenere un oggetto TextLanguage intermedio tramite un apposito metodo di creazione, modificare i parametri necessari e quindi assegnare l’oggetto ottenuto alla proprietà. Per impostazione predefinita, questo parametro è inizializzato con la lingua inglese.
		Gestisce il rilevamento automatico della lingua. Quando il rilevamento automatico della lingua è attivo, la lingua di riconoscimento viene rilevata per ogni parola nel testo. Viene selezionata dall’elenco delle lingue specificate nella proprietà TextLanguage. Il rilevamento automatico è destinato all’uso durante il riconoscimento di documenti di cui non si conosce la lingua. Il rilevamento automatico della lingua funziona solo con le lingue predefinite (vedere l’elenco completo inLingue predefinite in ABBYY FineReader Engine). Se si è certi che tutte le lingue specificate siano presenti nel documento, il rilevamento automatico è superfluo. Disattivarlo impostando questa proprietà su TSPV_No. È possibile visualizzare l’elenco delle lingue rilevate nel documento riconosciuto o nella pagina riconosciuta tramite la proprietà DetectedLanguages dell’oggettoorobject. Per impostazione predefinita, il valore di questa proprietà è TSPV_Auto.
		Il valore di questa proprietà è una combinazione OR delle costanti dell’enumerazioneche indicano i possibili tipi di testo utilizzati per il riconoscimento. Ad esempio, se impostato su TT_Normal \| TT_Index, ABBYY FineReader Engine presupporrà che il testo contenga solo testo tipografico comune e cifre scritte in stile codice postale, ignorando tutte le altre varianti. Vedere ancheUsing Text Type Autodetection. Note: Se questa proprietà è uguale a qualsiasi combinazione di TT_Matrix, TT_Typewriter, TT_OCR_A e TT_OCR_B, i caratteri in corsivo e apice/pedice non verranno riconosciuti, indipendentemente dai valori delle proprietà ProhibitItalic, ProhibitSubscript e ProhibitSuperscript. Se questa proprietà è TT_Handwritten, l’orientamento dell’immagine non può essere corretto. In Windows: se questa proprietà è impostata su TT_Handwritten o TT_Index, la proprietà TrainUserPatterns non può essere impostata su TRUE. se la proprietà TrainUserPatterns è impostata su TRUE, la proprietà TextTypes deve contenere un solo tipo di testo. Per impostazione predefinita, questa proprietà è impostata su TT_Normal.
		Indica che il tipo di testo deve essere determinato separatamente per ogni blocco di testo. Questa impostazione è utile quando si dispone di blocchi di testo relativamente piccoli con tipi di testo diversi, anche se potrebbe rallentare leggermente l’elaborazione. Il valore predefinito di questa proprietà è FALSE.

		Specifica la modalità di riconoscimento da applicare ai documenti di destinazione. Ogni modalità offre un proprio equilibrio tra velocità e accuratezza del riconoscimento, per ottenere risultati soddisfacenti su immagini e documenti con caratteristiche diverse. Per impostazione predefinita, questa proprietà è impostata su RM_Normal. I pattern incorporati vengono sempre utilizzati in modalità accurata. Per disattivarne l’uso, passa alla modalità normale (RM_Normal).

		Specifica se il testo in un’immagine a bassa risoluzione deve essere riconosciuto. Questa proprietà è utile per il riconoscimento di fax, testi stampati in piccolo, immagini a bassa risoluzione o con scarsa qualità di stampa. Per impostazione predefinita, il valore di questa proprietà è FALSE.
		Se impostata su TRUE, questa proprietà indica ad ABBYY FineReader Engine di presumere che il testo nel blocco a cui appartiene l’oggetto RecognizerParams corrente non contenga più di una stringa. Per impostazione predefinita, questa proprietà è FALSE.
		Se impostata su TRUE, questa proprietà indica ad ABBYY FineReader Engine di presumere che nessuna riga di testo possa contenere più di una parola, pertanto ogni riga di testo verrà riconosciuta come un’unica parola. Per impostazione predefinita, questa proprietà è FALSE.
		Se impostata su TRUE, questa proprietà indica ad ABBYY FineReader Engine di non riconoscere le lettere stampate in corsivo. È utile quando si riconosce un testo presumibilmente privo di lettere in corsivo, nel qual caso può accelerare il riconoscimento. Se nell’immagine sono presenti lettere in corsivo e questa proprietà è TRUE, tali lettere verranno riconosciute in modo errato. Per impostazione predefinita, questa proprietà è FALSE.
		Se impostata su TRUE, questa proprietà indica ad ABBYY FineReader Engine di non riconoscere i caratteri in pedice. È utile quando si riconosce un testo presumibilmente privo di pedici, nel qual caso può accelerare il riconoscimento. Se nell’immagine sono presenti caratteri in pedice e questa proprietà è TRUE, tali caratteri verranno riconosciuti in modo errato. Per impostazione predefinita, questa proprietà è FALSE.
		Se impostata su TRUE, questa proprietà indica ad ABBYY FineReader Engine di non riconoscere i caratteri in apice. È utile quando si riconosce un testo presumibilmente privo di apici, nel qual caso può accelerare il riconoscimento. Se nell’immagine sono presenti caratteri in apice e questa proprietà è TRUE, tali caratteri verranno riconosciuti in modo errato. Per impostazione predefinita, questa proprietà è FALSE.
		Se impostata su TRUE, questa proprietà impedisce il riconoscimento delle sillabazioni da una riga all’altra. È utile quando si riconosce un testo presumibilmente privo di sillabazioni, nel qual caso può accelerare il riconoscimento. Se nel blocco riconosciuto sono presenti sillabazioni e questa proprietà è TRUE, le parole sillabate verranno riconosciute in modo errato. Per impostazione predefinita, questa proprietà è FALSE.
		Se impostata su TRUE, questa proprietà indica ad ABBYY FineReader Engine di non riconoscere le maiuscolette. Per impostazione predefinita, questa proprietà è FALSE.
		Questa proprietà impostata su TRUE indica ad ABBYY FineReader Engine di considerare che il testo di un blocco non possa continuare nel blocco successivo. Per impostazione predefinita, questa proprietà è FALSE.
		Questa proprietà specifica la modalità di riconoscimento del tipo di carattere (maiuscolo/minuscolo). Per impostazione predefinita, il valore di questa proprietà è CRM_AutoCase, che corrisponde al riconoscimento automatico del tipo di carattere.
		Questa proprietà specifica il tipo di delimitazione attorno alle lettere (ad esempio, sottolineatura, cornice, riquadro, ecc.). Per i tipi di delimitazione in cui ogni lettera si trova in una cella separata, utilizzare la proprietà CellsCount per impostare il numero di celle di carattere per un blocco riconosciuto. Per impostazione predefinita, il valore di questa proprietà è FMT_SimpleText, che indica l’assenza di delimitazione.
		Specifica il numero di celle di carattere nel blocco. È rilevante solo per i tipi di delimitazione del field (proprietà FieldMarkingType) in cui ogni lettera è scritta in una cella separata. Il valore predefinito di questa proprietà è 1, ma è necessario impostare il valore appropriato per riconoscere correttamente il testo.

Solo Windows.		Questa proprietà specifica se i pattern utente devono essere sottoposti ad addestramento durante il riconoscimento. La finestra di dialogoPattern Trainingverrà visualizzata durante il riconoscimento. Per il corretto funzionamento del processo di addestramento dei pattern è necessario: impostare il valore dell’handle HWND della finestra padre (proprietà) specificare un file di pattern utente nella proprietà UserPatternsFile Vedere ancheRecognizing with Training. Se questa proprietà è impostata su TRUE: la proprietà TextTypes deve contenere un solo tipo di testo, e tale tipo non può essere TT_Handwritten o TT_Index la proprietàdell’oggetto PagePreprocessingParams non può essere impostata su TRUE L’addestramento dei pattern non è supportato per le lingue cinese, giapponese e coreana. Per impostazione predefinita, questa proprietà è FALSE.
		Questa proprietà impostata su TRUE indica che ABBYY FineReader Engine utilizzerà i propri pattern integrati per il riconoscimento. I pattern sono file che definiscono la corrispondenza tra l’immagine di un carattere e il carattere stesso. È possibile impostare questa proprietà su FALSE quando non si desidera utilizzare i pattern standard di ABBYY FineReader Engine per il riconoscimento dei caratteri, ma solo i pattern utente. Ciò può essere utile per il riconoscimento di testo scritto con font decorativi o non standard. In questo caso, è preferibile non utilizzare i pattern integrati di ABBYY FineReader Engine, ma i propri pattern utente addestrati per tali font. Il percorso del file di pattern definito dall’utente è memorizzato nella proprietà UserPatternsFile. Se la proprietà UserPatternsFile è vuota, la proprietà UseBuiltInPatterns viene ignorata. Per Windows, vedere ancheRecognizing with Training. Per impostazione predefinita, questa proprietà è TRUE. È possibile impostare questa proprietà su FALSE quando si utilizzano le modalità di riconoscimento normale e veloce. Non è possibile disabilitare l’utilizzo dei pattern integrati per la modalità accurata (vedere la descrizione della proprietàMode).
		Contiene il percorso completo del file del pattern utente utilizzato per il riconoscimento. Se il valore di questa proprietà non è vuoto, le informazioni contenute nel file del pattern utente verranno utilizzate durante il riconoscimento. Se la proprietà UseBuiltInPatterns è FALSE, ovvero i pattern standard di ABBYY FineReader Engine non vengono utilizzati durante il riconoscimento, questa proprietà deve contenere il percorso di un file di pattern definito dall’utente, poiché verranno utilizzate solo le informazioni in esso memorizzate. Per Windows, vedere ancheRecognizing with Training. Per impostazione predefinita, questa proprietà contiene una stringa vuota. I file di pattern utente creati in ABBYY FineReader Engine 10 o versioni precedenti non possono essere aperti in FineReader Engine 12 Release 6 o versioni successive. Per continuare a utilizzarli, salvare i file di pattern utente precedenti nel nuovo formato: Utilizzare FineReader Engine 11 o FineReader Engine 12 Release 5 o versioni precedenti. Chiamare il metododell’oggetto, passando una raccolta di stringhe con il nome del file di pattern precedente e il percorso completo del nuovo file.

		Specifica se i caratteri riconosciuti con incertezza devono avere la proprietà IsSuspicious impostata su TRUE. Il nome della proprietà riflette il fatto che ABBYY FineReader evidenzia i caratteri sospetti nel testo con un colore di sfondo, semplificando così la verifica manuale da parte dell’operatore. Per impostazione predefinita, questa proprietà è TRUE.
		Questa proprietà è obsoleta e verrà rimossa nelle versioni future.
		Specifica se le regioni esatte dei caratteri () vengono salvate. Il valore predefinito è FALSE.
		Specifica se le varianti di riconoscimento dei caratteri vengono salvate. La proprietàICharParams::CharacterRecognitionVariantsrestituisce una raccolta di varianti di riconoscimento per un carattere. Vedere ancheUsing Voting API. Il valore predefinito è FALSE.
		Specifica se le varianti di riconoscimento di una parola vengono salvate. Il metodoIParagraph::GetWordRecognitionVariantse la proprietàICharParams::WordRecognitionVariantsrestituiscono una raccolta di varianti di riconoscimento per una parola. Vedere ancheUsing Voting API. Il valore predefinito è FALSE.

Metodi

Nome	Descrizione
CopyFrom	Inizializza le proprietà dell’oggetto corrente con i valori delle proprietà corrispondenti di un altro oggetto.
LoadFromFile	Ripristina il contenuto dell’oggetto da un file su disco.
LoadFromMemory <Note> Solo Windows. </Note>	Ripristina il contenuto dell’oggetto dalla memoria globale.
SaveToFile	Salva il contenuto dell’oggetto in un file su disco.
SaveToMemory <Note> Solo Windows. </Note>	Salva il contenuto dell’oggetto nella memoria globale.
SetPredefinedTextLanguage	Imposta la lingua di riconoscimento su una delle lingue predefinite di ABBYY FineReader Engine.

Diagramma degli oggetti

Parametro di output

Questo oggetto è il parametro di output del metodo CreateRecognizerParams dell’oggetto Engine.

Parametro di input

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

metodi Preprocess, PreprocessPages, Analyze, AnalyzePages dell’oggetto FRDocument
metodi Preprocess, Analyze, AnalyzeRegion, AnalyzeTable, IsEmpty dell’oggetto FRPage

Esempi

Codice C#

FREngine.IEngine engine;
string fileName;
// Esegue l'addestramento del pattern utente durante il riconoscimento
FREngine.IDocumentProcessingParams processingParams = Engine.CreateDocumentProcessingParams();
FREngine.IRecognizerParams recognizerParams = processingParams.PageProcessingParams.RecognizerParams;
Engine.CreateEmptyUserPattern( fileName );
Engine.MultiProcessingParams.MultiProcessingMode = FREngine.MultiProcessingModeEnum.MPM_Sequential;
recognizerParams.UserPatternsFile = fileName;
recognizerParams.TrainUserPatterns = true;
Document.Process(processingParams);

Questo oggetto viene utilizzato nei seguenti esempi di codice:

Linux: CustomLanguage, CommandLineInterface
Windows: CustomLanguage, CommandLineInterface; e negli strumenti demo: BatchProcessingRecognition, Classification, MultiProcessingRecognition, PDFExportProfiles, User Pattern Training Utility

Vedi anche

Regolazione dei parametri di pre-elaborazione, analisi, riconoscimento e sintesi Riconoscimento del testo scritto a mano PageProcessingParams TextBlock Lavorare con le proprietà

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 RecognizerParams (interfaccia IRecognizerParams)

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

​Esempi

​Vedi anche

Proprietà

Metodi

Oggetti correlati

Parametro di output

Parametro di input

Esempi

Vedi anche