跳轉到主要內容
此物件可讓您調整辨識參數。版面配置中的每個文字區塊與表格儲存格,都有各自的 RecognizerParams 類型子物件。此外,此物件也會作為 PageProcessingParams 物件的子物件,傳遞至 ABBYY FineReader Engine 的版面分析與辨識函式。辨識函式會使用文字區塊與表格儲存格的 RecognizerParams 類型子物件中所定義的辨識參數。 每當在版面分析期間建立文字區塊或表格儲存格時,其 RecognizerParams 類型子物件的屬性都會以傳遞至分析函式的 RecognizedParams 物件屬性值初始化。使用 LayoutBlocks 物件的 AddNew 方法所建立之區塊,其子物件的屬性會設為合理的預設值。若要了解某個屬性的預設值,請參閱其說明。 RecognizerParams 物件是持久性物件。這表示物件的目前狀態可寫入持久性儲存體。之後,可藉由從持久性儲存體讀取物件狀態來重新建立該物件。下列方法可提供物件的持久化功能: Linux:SaveToFileLoadFromFile Windows:SaveToFileLoadFromFileSaveToMemoryLoadFromMemory

屬性

,read-only

傳回 Engine 物件。

指定用於辨識的語言。此屬性可透過方法輕鬆設定。

此屬性傳回一個常數物件。若要變更辨識語言,必須先使用適當的建立方法取得中間的 TextLanguage 物件,修改所需的參數,再將取得的物件指派給此屬性。

預設情況下,此參數以英語初始化。

管理自動語言偵測。

啟用語言自動偵測時,系統會針對文字中的每個單字偵測辨識語言,並從 TextLanguage 屬性指定的語言清單中選取。自動偵測適用於辨識語言未知的文件。

語言自動偵測僅適用於預定義語言 (完整清單請參閱ABBYY FineReader Engine 中的預定義語言)

若確定文件中包含所有已指定的語言,則無需使用自動偵測。請將此屬性設為 TSPV_No 以關閉自動偵測。

您可以使用物件的 DetectedLanguages 屬性,查看已辨識文件或頁面中偵測到的語言清單。

預設情況下,此屬性值為 TSPV_Auto。

此屬性的值是列舉常數的 OR 組合,用於指定辨識時可能使用的文字類型。例如,若設為 TT_Normal | TT_Index,ABBYY FineReader Engine 將假設文字僅包含一般印刷文字及以郵遞區號格式書寫的數字,並忽略所有其他變體。另請參閱Using Text Type Autodetection

注意事項:

  • 若此屬性等於 TT_Matrix、TT_Typewriter、TT_OCR_A 及 TT_OCR_B 的任意組合,則無論 ProhibitItalic ProhibitSubscript ProhibitSuperscript 屬性的值為何,斜體字型及上標/下標均不會被辨識。
  • 若此屬性為 TT_Handwritten,則無法校正影像方向。
  • 在 Windows 中:
    • 若此屬性設為 TT_Handwritten 或 TT_Index,則 TrainUserPatterns 屬性不能設為 TRUE。
    • TrainUserPatterns 屬性設為 TRUE,則 TextTypes 屬性只能包含一種文字類型。

預設情況下,此屬性設為 TT_Normal。

表示應分別為每個文字區塊判斷文字類型。當文件中包含多個文字類型各異的較小文字區塊時,此設定非常實用,但可能會略微降低處理速度。

此屬性的預設值為 FALSE。

指定要套用至目標文件的辨識模式。每種模式提供不同的辨識速度與精確度,以便在具有各種特性的影像和文件上取得令人滿意的結果。

預設情況下,此屬性設定為 RM_Normal。

精確模式下一律使用內建模式。若要停用內建模式,請切換至一般模式 (RM_Normal)。

指定是否辨識低解析度影像上的文字。此屬性在辨識傳真、小字印刷品、低解析度或列印品質不佳的影像時非常有用。

預設情況下,此屬性的值為 FALSE。

將此屬性設定為 TRUE 時,ABBYY FineReader Engine 會假設目前 RecognizerParams 物件所屬區塊中的文字不超過一行。

預設情況下,此屬性為 FALSE。

將此屬性設定為 TRUE 時,ABBYY FineReader Engine 會假設每行文字不超過一個單字,因此每行文字將被辨識為單一單字。

預設情況下,此屬性為 FALSE。

將此屬性設定為 TRUE 時,ABBYY FineReader Engine 不會辨識以斜體字型列印的字母。當辨識的文字中預計不含斜體字母時,此屬性非常有用,可加快辨識速度。若影像中存在斜體字母,且此屬性為 TRUE,則這些字母將被錯誤辨識。

預設情況下,此屬性為 FALSE。

將此屬性設定為 TRUE 時,ABBYY FineReader Engine 不會辨識下標字母。當辨識的文字中預計不含下標時,此屬性非常有用,可加快辨識速度。若影像中存在下標字母,且此屬性為 TRUE,則這些字母將被錯誤辨識。

預設情況下,此屬性為 FALSE。

將此屬性設定為 TRUE 時,ABBYY FineReader Engine 不會辨識上標字母。當辨識的文字中預計不含上標時,此屬性非常有用,可加快辨識速度。若影像中存在上標字母,且此屬性為 TRUE,則這些字母將被錯誤辨識。

預設情況下,此屬性為 FALSE。

將此屬性設定為 TRUE 時,將禁止辨識跨行連字符。當辨識的文字中預計不含連字符時,此屬性非常有用,可加快辨識速度。若辨識區塊中存在連字符,且此屬性為 TRUE,則含連字符的單字將被錯誤辨識。

預設情況下,此屬性為 FALSE。

將此屬性設定為 TRUE 時,ABBYY FineReader Engine 不會辨識小型大寫字母。

預設情況下,此屬性為 FALSE。

此屬性設為 TRUE 時,會告知 ABBYY FineReader Engine 假設一個區塊中的文字不會延續至下一個區塊。

此屬性的預設值為 FALSE。

此屬性指定字母大小寫的識別模式。

此屬性的預設值為 CRM_AutoCase,對應自動大小寫識別。

此屬性指定字母周圍標記的類型 (例如:底線、外框、方格等) 。

若標記類型為每個字母各佔一個獨立儲存格,請使用 CellsCount 屬性設定已識別區塊的字元儲存格數量。

此屬性的預設值為 FMT_SimpleText,表示無標記。

指定區塊中的字元儲存格數量。

此設定僅適用於每個字母各佔一個獨立儲存格的欄位標記類型 (即 FieldMarkingType 屬性) 。

此屬性的預設值為 1,但您應設定適當的值以確保文字識別正確。

僅限 Windows。

此屬性指定識別過程中是否應訓練使用者模式。識別期間將顯示模式訓練對話方塊。

若要讓模式訓練程序正確運作,必須:

  • 設定父視窗 HWND 控制代碼的值 (property)
  • UserPatternsFile 屬性中指定使用者模式檔案

另請參閱Recognizing with Training

若此屬性設為 TRUE:

  • TextTypes 屬性必須僅包含一種文字類型,且該類型不能為 TT_Handwritten 或 TT_Index
  • thePagePreprocessingParams 物件的此屬性不能設為 TRUE
模式訓練不支援中文、日文及韓文。

此屬性的預設值為 FALSE。

此屬性設為 TRUE 表示 ABBYY FineReader Engine 將使用其內建模式進行識別。模式是建立字元影像與字元本身對應關係的檔案。若您不希望使用標準 ABBYY FineReader Engine 模式進行字元識別,而只使用使用者模式,可將此屬性設為 FALSE。這在識別以裝飾性或非標準字型輸入的文字時可能很有用。在此情況下,建議不使用 ABBYY FineReader Engine 的內建模式,改用針對這些字型訓練的自訂使用者模式。

使用者自訂模式檔案的路徑儲存於 UserPatternsFile 屬性中。若 UserPatternsFile 屬性為空,則 UseBuiltInPatterns 屬性將被忽略。若為 Windows,另請參閱Recognizing with Training

此屬性的預設值為 TRUE。

使用一般或快速識別模式時,可將此屬性設為 FALSE。但在精確模式下,無法禁止使用內建模式 (請參閱Mode屬性的說明) 。

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.

IParagraph::GetWordRecognitionVariants方法與ICharParams::WordRecognitionVariants屬性會傳回某個單字的辨識候選結果集合。另請參閱Using Voting API

The default value is FALSE.

方法

名稱說明
CopyFrom使用另一個物件的對應屬性值,初始化目前物件的屬性。
LoadFromFile從磁碟上的檔案還原物件內容。
LoadFromMemory <Note> 僅限 Windows。 </Note>從全域記憶體還原物件內容。
SaveToFile將物件內容儲存至磁碟上的檔案。
SaveToMemory <Note> 僅限 Windows。 </Note>將物件內容儲存至全域記憶體。
SetPredefinedTextLanguage將辨識語言設為預先定義的 ABBYY FineReader Engine 語言之一。
RecognizerParams 物件關係圖

輸出參數

此物件是 Engine 物件的 CreateRecognizerParams 方法輸出參數。

輸入參數

此物件會作為輸入參數傳遞至下列方法:

範例

FREngine.IEngine engine;
string fileName;
// 在辨識期間訓練使用者樣式
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);
此物件會在下列程式碼範例中使用:

另請參閱

預處理、分析、辨識與合成的調整參數 辨識手寫文字 PageProcessingParams TextBlock 屬性的使用