Pular para o conteúdo principal
Este objeto permite ajustar os parâmetros de reconhecimento. Cada bloco de texto e célula de tabela no layout tem seu próprio objeto filho do tipo RecognizerParams. Além disso, esse objeto é passado como um subobjeto do objeto PageProcessingParams para as funções de análise de layout e reconhecimento do ABBYY FineReader Engine. As funções de reconhecimento usam parâmetros de reconhecimento definidos pelos objetos filho dos blocos de texto e das células da tabela do tipo RecognizerParams. Sempre que um bloco de texto ou uma célula de tabela é criado durante a análise de layout, as propriedades de seu objeto filho do tipo RecognizerParams são inicializadas com os valores das propriedades do objeto RecognizedParams que foi passado para a função de análise. As propriedades de um subobjeto do bloco criado com o método AddNew do objeto LayoutBlocks são definidas com valores padrão apropriados. Para saber o valor padrão de uma determinada propriedade, consulte sua descrição. O objeto RecognizerParams é um objeto persistente. Isso significa que o estado atual do objeto pode ser gravado em armazenamento persistente. Mais tarde, o objeto pode ser recriado pela leitura de seu estado desse armazenamento persistente. Os métodos a seguir fornecem persistência ao objeto: Linux: SaveToFile e LoadFromFile Windows: SaveToFile, LoadFromFile, SaveToMemory e LoadFromMemory.

​
Properties

,read-only

Retorna o objeto Engine.

Especifica o idioma a ser usado para reconhecimento. Esta propriedade pode ser facilmente definida por meio do métodomethod.

A propriedade retorna um objeto constante. Para alterar o idioma de reconhecimento, é necessário primeiro obter um objeto TextLanguage intermediário usando um método de criação adequado, alterar os parâmetros necessários e, em seguida, atribuir o objeto obtido à propriedade.

Por padrão, este parâmetro é inicializado com o idioma inglês.

Gerencia a detecção automática de idioma.

Quando a detecção automática de idioma está ativada, o idioma de reconhecimento é detectado para cada palavra no texto. Ele é selecionado a partir da lista de idiomas especificados na propriedade TextLanguage. A detecção automática é indicada para o reconhecimento de documentos cujo idioma não é conhecido pelo usuário.

A detecção automática de idioma funciona apenas com os idiomas predefinidos (consulte a lista completa emIdiomas predefinidos no ABBYY FineReader Engine).

Se você tiver certeza de que todos os idiomas especificados estão presentes no documento, a detecção automática é desnecessária. Desative-a definindo esta propriedade como TSPV_No.

É possível visualizar a lista de idiomas detectados no documento reconhecido ou na página reconhecida usando a propriedade DetectedLanguages do objetoorobject.

Por padrão, o valor desta propriedade é TSPV_Auto.

O valor desta propriedade é uma superposição OR dasconstantes de enumeração que indicam os possíveis tipos de texto usados para reconhecimento. Por exemplo, se definido como TT_Normal | TT_Index, o ABBYY FineReader Engine presumirá que o texto contém apenas texto tipográfico comum e dígitos escritos no estilo de código postal, ignorando todas as outras variantes. Consulte tambémUsando a detecção automática de tipo de texto.

Observações:

  • Se esta propriedade for igual a qualquer combinação de TT_Matrix, TT_Typewriter, TT_OCR_A e TT_OCR_B, fontes em itálico e sobrescrito/subscrito não serão reconhecidos, independentemente dos valores das propriedades ProhibitItalic, ProhibitSubscript e ProhibitSuperscript.
  • Se esta propriedade for TT_Handwritten, a orientação da imagem não poderá ser corrigida.
  • No Windows:
    • se esta propriedade for definida como TT_Handwritten ou TT_Index, a propriedade TrainUserPatterns não poderá ser definida como TRUE.
    • se a propriedade TrainUserPatterns for definida como TRUE, a propriedade TextTypes deverá conter apenas um tipo de texto.

Por padrão, esta propriedade é definida como TT_Normal.

Indica que o tipo de texto deve ser determinado para cada bloco de texto separadamente. Esta configuração é útil quando há blocos de texto relativamente pequenos com tipos de texto diferentes, embora possa desacelerar ligeiramente o processamento.

O valor padrão desta propriedade é FALSE.

Specifies the recognition mode to be applied to the target documents. Each mode provides its own level of recognition speed and accuracy to get satisfying results on images and documents with various peculiarities.

By default, this property is set to RM_Normal.

Built-in patterns are always used for the accurate mode. To disable using the built-in patterns, switch to the normal mode (RM_Normal).

Specifies whether a text on an image with low resolution is recognized. This property is useful when recognizing faxes, small prints, images with low resolution or bad print quality.

By default, the value of this property is FALSE.

This property set to TRUE tells ABBYY FineReader Engine to presume that the text in block to which the current RecognizerParams object belongs contains no more than one string.

By default, this property is FALSE.

This property set to TRUE tells ABBYY FineReader Engine to presume that no text line may contain more than one word, so the lines of text will be recognized as a single word.

By default, this property is FALSE.

Quando definida como TRUE, esta propriedade instrui o ABBYY FineReader Engine a não reconhecer letras impressas em fonte itálica. É útil quando se reconhece um texto que presumivelmente não contém letras em itálico, pois nesse caso pode acelerar o reconhecimento. Se houver letras em itálico na imagem e esta propriedade estiver definida como TRUE, essas letras serão reconhecidas incorretamente.

Por padrão, esta propriedade é FALSE.

This property set to TRUE tells ABBYY FineReader Engine not to recognize subscript letters. It is useful when a text with presumably no subscripts is recognized, in which case it may speed up the recognition. If there exist any subscript letters on the image, and this property is TRUE, these letters will be recognized incorrectly.

By default, this property is FALSE.

This property set to TRUE tells ABBYY FineReader Engine not to recognize superscript letters. It is useful when a text with presumably no superscripts is recognized, in which case it may speed up the recognition. If there exist any superscript letters on the image, and this property is TRUE, these letters will be recognized incorrectly.

By default, this property is FALSE.

This property set to TRUE prohibits recognition of hyphenation from line to line. It is useful when a text with presumably no hyphenations is recognized, in which case it may speed up the recognition. If there exist any hyphenations in the recognized block, and this property is TRUE, the hyphenated words will be recognized incorrectly.

By default, this property is FALSE.

This property set to TRUE tells ABBYY FineReader Engine not to recognize small capitals.

By default, this property is FALSE.

Esta propriedade definida como TRUE instrui o ABBYY FineReader Engine a considerar que o texto de um bloco não pode continuar no bloco seguinte.

Por padrão, esta propriedade é FALSE.

Esta propriedade especifica o modo de reconhecimento de capitalização de letras.

Por padrão, o valor desta propriedade é CRM_AutoCase, que corresponde ao reconhecimento automático de capitalização.

Esta propriedade especifica o tipo de marcação ao redor das letras (por exemplo, sublinhado, moldura, caixa etc.).

Para tipos de marcação em que cada letra está em uma célula separada, use a propriedade CellsCount para definir o número de células de caracteres de um bloco reconhecido.

Por padrão, o valor desta propriedade é FMT_SimpleText, que indica ausência de marcação.

Especifica o número de células de caracteres no bloco.

Aplica-se apenas aos tipos de marcação de campo (propriedade FieldMarkingType) nos quais cada letra é escrita em uma célula separada.

O valor padrão desta propriedade é 1, mas você deve definir o valor adequado para que o texto seja reconhecido corretamente.

Somente Windows.

Esta propriedade especifica se os padrões do usuário devem ser treinados durante o reconhecimento. A caixa de diálogoTreinamento de Padrõesserá exibida durante o reconhecimento.

Para o funcionamento correto do processo de treinamento de padrões, é necessário:

  • definir o valor do identificador HWND da janela pai (propriedade)
  • especificar um arquivo de padrões do usuário na propriedade UserPatternsFile

Consulte tambémReconhecimento usando treinamento.

Se esta propriedade for definida como TRUE:

  • a propriedade TextTypes deve conter apenas um tipo de texto, e esse tipo de texto não pode ser TT_Handwritten ou TT_Index
  • a propriedadedo objeto PagePreprocessingParams não pode ser definida como TRUE
O treinamento de padrões não é compatível com os idiomas chinês, japonês e coreano.

Por padrão, esta propriedade é FALSE.

Esta propriedade definida como TRUE indica que o ABBYY FineReader Engine usará seus próprios padrões integrados para o reconhecimento. Padrões são arquivos que estabelecem a relação entre a imagem de um caractere e o próprio caractere. Defina esta propriedade como FALSE quando não quiser usar os padrões padrão do ABBYY FineReader Engine para reconhecimento de caracteres, utilizando apenas os padrões do usuário. Isso pode ser útil para o reconhecimento de texto digitado com fontes decorativas ou não padrão. Nesses casos, é preferível não usar os padrões integrados do ABBYY FineReader Engine, mas sim padrões personalizados treinados para essas fontes.

O caminho para o arquivo de padrões personalizado é armazenado na propriedade UserPatternsFile. Se a propriedade UserPatternsFile estiver vazia, a propriedade UseBuiltInPatterns será ignorada. Para Windows, consulte tambémReconhecimento usando treinamento.

Por padrão, esta propriedade é TRUE.

É possível definir esta propriedade como FALSE ao usar os modos de reconhecimento normal e rápido. Não é possível desativar o uso dos padrões integrados no modo preciso (consulte a descrição da propriedadeMode).

Contains the full path to a file of the user pattern used for recognition. If the value of this property is not empty, information from the user pattern file will be used during recognition.

If the UseBuiltInPatterns property is FALSE, which means that standard ABBYY FineReader Engine patterns are not used during recognition, this property should contain a path to user-defined pattern file, as only information stored in it will be used. For Windows, see alsoRecognizing with Training.

By default, this property stores an empty string.

User pattern files created in ABBYY FineReader Engine 10 or earlier cannot be opened in FineReader Engine 12 Release 6 or later. To continue using them, save older user pattern files in the new format:
  • Use FineReader Engine 11 or FineReader Engine 12 Release 5 or earlier.
  • Call themethod of theobject, passing in a string collection with the name of older pattern file and a full path to new file.

Specifies if uncertainly recognized characters should be have the IsSuspicious property set to TRUE.

The name of the property reflects the fact that ABBYY FineReader highlights suspicious characters in text with background color, which makes manual verification easier for the operator.

By default, this property is TRUE.

This property is deprecated and will be deleted in future versions.

Specifies whether the exact characters regions () are saved.

The default value is FALSE.

Specifies whether the variants of characters recognition are saved.

TheICharParams::CharacterRecognitionVariantsproperty returns a collection of recognition variants for a character. See alsoUsing Voting API.

The default value is FALSE.

Specifies whether the variants of recognition of a word are saved.

O métodoIParagraph::GetWordRecognitionVariantse a propriedadeICharParams::WordRecognitionVariantsretornam uma coleção de variantes de reconhecimento para uma palavra. Veja tambémUsing Voting API.

The default value is FALSE.

​
Métodos

NomeDescrição
CopyFromInicializa as propriedades do objeto atual com os valores das propriedades correspondentes de outro objeto.
LoadFromFileRestaura o conteúdo do objeto de um arquivo em disco.
LoadFromMemory <Note> Somente no Windows. </Note>Restaura o conteúdo do objeto da memória global.
SaveToFileSalva o conteúdo do objeto em um arquivo em disco.
SaveToMemory <Note> Somente no Windows. </Note>Salva o conteúdo do objeto na memória global.
SetPredefinedTextLanguageDefine o idioma de reconhecimento como um dos idiomas predefinidos do ABBYY FineReader Engine.
RecognizerParams Diagrama de objetos

​
Parâmetro de saída

Este objeto é o parâmetro de saída do método CreateRecognizerParams do objeto Engine.

​
Parâmetro de entrada

Este objeto é usado como parâmetro de entrada nos seguintes métodos:

​
Exemplos

FREngine.IEngine engine;
string fileName;
// Treinar o padrão do usuário durante o reconhecimento
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);
O objeto é usado nos seguintes exemplos de código:

​
Veja também

Ajuste dos parâmetros de pré-processamento, análise, reconhecimento e síntese Reconhecendo textos manuscritos PageProcessingParams TextBlock Trabalhando com Properties