Step 2: Recognition Keys

Below you can find the description of the recognition keys of the abbyyocr11 utility.


  • New CLI 11 R2
  • Manages automatic language detection. When language detection is on (Yes is passed to this option), the recognition language is detected for each word in the text. It is selected from the list of languages specified for the -rl option. Autodetection is intended to be used during recognition of documents the language of which is not known to you.
    If you know for certain that all the languages you specified are present in the document, autodetection is useless. Turn it off by passing No to this property.
    In Auto mode ABBYY FineReader Engine decides whether language detection should be performed or not.
Key Parameters Default
-rldm Yes
- -languageDetectionMode


  • The recognition will run in balanced mode (an intermediate mode between full and fast modes, which can be activated with the help of the -fm key).
Key Parameters Default
-rbm no
- -balancedMode


  • Specifies the mode of letter case recognition.
Key Parameters Default
-rcm AutoCase
- -caseRecognitionMode


  • Specifies the number of character cells for a recognised block. This key is valid only for the handprint recognition. It has a sense only for the field marking types (-rfmt key) that imply splitting the text in cells.
Key Parameters Default
-rcc the number of character cells for a recognised block 1
- -cellsCount


  • No second-stage recognition will be performed.
Key Parameters Default
-rdss no
- -disableSecondStageRecognizer


  • Specifies the level at which the ICharParams::IsSuspicious property is set to TRUE for a recognised character.
Key Parameters Default
-rehl None
- -errorHighlightLevel


  • Character confidence will be defined more accurately, but recognition speed may get slower.
Key Parameters Default
-recc no
- -exactConfidenceCalculation


  • Provides 2-2,5 times faster recognition speed at the cost of moderate increased error rate (1,5-2 times more errors). For text printed with good quality ABBYY FineReader Engine makes 1-2 errors per page on average. The increase of errors can be easily eliminated by using various scenarios, e.g. the full text indexing with “fuzzy” search, preliminary recognition, etc.
Key Parameters Default
-fm no
- -fastMode


  • This property specifies the type of marking around letters (for example, underline, frame, box and etc.).
Key Parameters Default
-rfmt SimpleText
- -fieldMarkingType


  • Presumes that the text in the block to which the current RecognizerParams object corresponds contains no more than one string.
Key Parameters Default
-tol no
- -oneLinePerTextCell


  • Presumes that no text line may contain more than one word, so the lines of text will be recognised as a single word.
Key Parameters Default
-rowl no
- -oneWordPerLine

-- --TextTypes

  • Update CLI 11 R1
  • Presumes that the text to recognize is of one of the types the collection contains..
  • The Handprinted constant is unavailable in FineReader Engine for Linux.
Key Parameters Default
-rtt Space-separated combination of the following constants:
Gothic 1)
- -TextTypes


  • Prohibits recognition of hyphenation from line to line.
Key Parameters Default
-rphp no
- -prohibitHyphenation


  • Presumes that text from one block can't be carried over to the next block.
Key Parameters Default
-rpihp no
- -prohibitInterblockHyphenation


  • Prohibits recognition of letters printed with italic-styled font.
Key Parameters Default
-rpi no
- -prohibitItalic


  • Prohibits recognition of subscript letters.
Key Parameters Default
-rpsub no
- -prohibitSubscript


  • Prohibits recognition of superscript letters.
Key Parameters Default
-rpsup no
- -prohibitSuperscript


  • Specifies whether the variants of a character's recognition are saved.
Key Parameters Default
-rscrv no
- -saveCharacterRecognitionVariants


  • Specifies whether the variants of a word's recognition are saved.
Key Parameters Default
-rswrv no
- -saveWordRecognitionVariants


  • Sets the recognition language(s) which should be present in the list of the predefined ABBYY FineReader Engine languages and/or in the /UserLanguages directory.
Key Parameters Default
-rl list of recognition languages
or and/or user languages (see blow)
- -recognitionLanguage


  • This key sets the path to the user patterns file used for recognition.
  • Note: User patterns can be created using ABBYY FineReader Engine 11 Windows.
Key Parameters Default
-upf user patterns file name
- -userPatternsFile


  • When -dnubp key is not used, the ABBYY OCR Engine will use its own built-in patterns for recognition. Patterns are files establishing relationship between character image and character itself.
  • You may want to use this key when you do not want to use standard built-in ABBYY FineReader Engine patterns for character recognition, but user patterns only. This may be useful for recognition of text typed with decorative or non-standard fonts. In this case it is better not to use ABBYY FineReader Engine built-in patterns, but use your own user-defined patterns trained for these fonts.
  • Please note that when -dnubp key is used, the path to the user-defined patterns file should be specified with the -upf key as only information stored in this file will be used. If the path to the user patterns file is not specified, used -dnubp key is ignored so built-in patterns are used for recognition.
Key Parameters Default
-dnubp no
- -doNotUseBuiltInPatterns
  • Note. Full keys are marked by italic.

1) not incl. in the license per default