開發人員可以在其識別解決方案中結合多個 Engine。當多個 Engine 對某個字元或單字產生不同的識別變體時，開發人員可以透過對這些結果進行投票，選出最佳結果。為了啟用投票，ABBYY FineReader Engine 提供了專用的 Voting API，可存取字元或單字識別的不同假設及其對應的權重值。除了投票之外，開發人員也可以使用 Voting API，透過自己的資料庫和演算法檢查識別結果，並修正文字。例如，開發人員可以將字母組合成單字，或檢查所有產生的假設。
Voting API 不支援手寫／印刷體手寫文字識別。
- 將 RecognizerParams 物件的 SaveWordRecognitionVariants 和 SaveCharacterRecognitionVariants 屬性設為 TRUE。這會指示 FineReader Engine 在識別結果中儲存識別變體。
- 將 RecognizerParams 物件作為 PageProcessingParams 物件的子物件 (或作為包含它的 DocumentProcessingParams 物件的一部分) ，傳遞給 ABBYY FineReader Engine 的其中一個識別方法。
- 識別完成後，可透過 ICharParams::WordRecognitionVariants、ICharParams::CharacterRecognitionVariants 屬性，以及 IParagraph::GetWordRecognitionVariants 方法存取假設集合。
對於不可列印字元 (空格、換行等) ，以及未被識別但在編輯期間新增到文字中的字元，這些方法會回傳零。如果文字是由舊版 ABBYY FineReader Engine 識別，也會回傳零。假設集合中的識別變體會依品質從高到低排序。如果 RecognizerParams 物件的 SaveWordRecognitionVariants 或 SaveCharacterRecognitionVariants 屬性設為 FALSE，對應的集合將只包含一個元素。
FREngine::IEnginePtr Engine;
FREngine::IFRDocumentPtr frDocument;
...
// 建立 DocumentProcessingParams 物件、設定參數，
// 並在識別時使用
FREngine::IDocumentProcessingParamsPtr dpp = Engine->CreateDocumentProcessingParams();
dpp->PageProcessingParams->RecognizerParams->SaveCharacterRecognitionVariants = VARIANT_TRUE;
dpp->PageProcessingParams->RecognizerParams->SaveWordRecognitionVariants = VARIANT_TRUE;
frDocument->Process( dpp );
// 逐一處理版面區塊
FREngine::ILayoutPtr layout = frDocument->Pages->Item(0)->Layout;
for (int i = 0; i < layout->Blocks->Count; i++) {
if (layout->Blocks->Item(i)->Type == FREngine::BT_Text) {
getVariants (layout->Blocks->Item(i));
}
}
// 為文字區塊中的所有單字和字元產生假設的程序
void getVariants(FREngine::IBlockPtr& block)
{
FREngine::ICharParamsPtr charParams = Engine->CreateCharParams();
FREngine::IParagraphsPtr paragraphs = block->GetAsTextBlock()->Text->Paragraphs;
for (int i = 0; i < paragraphs->Count; i++) {
for (int j = 0; j < paragraphs->Item(i)->Length; j++) {
paragraphs->Item(i)->GetCharParams(j, charParams);
FREngine::ICharacterRecognitionVariantsPtr charVariants = charParams->CharacterRecognitionVariants;
FREngine::IWordRecognitionVariantsPtr wordVariants = charParams->WordRecognitionVariants;
if (wordVariants != 0) {
for (int k = 0; k < wordVariants->Count; k++) {
FREngine::IWordRecognitionVariantPtr wordVariant = wordVariants->Item(k);
}
}
if (charVariants != 0) {
for ( int k = 0; k < charVariants->Count; k++) {
FREngine::ICharacterRecognitionVariantPtr charVariant = charVariants->Item(k);
}
}
}
}
}
FREngine.IEngine engine;
FREngine.IFRDocument document;
...
// 建立 DocumentProcessingParams 物件、設定參數，
// 並在識別時使用
FREngine.IDocumentProcessingParams dpp = engine.CreateDocumentProcessingParams();
dpp.PageProcessingParams.RecognizerParams.SaveCharacterRecognitionVariants = true;
dpp.PageProcessingParams.RecognizerParams.SaveWordRecognitionVariants = true;
document.Process( dpp );
// 逐一處理版面區塊
FREngine.ILayout layout = document.Pages[0].Layout;
for (int i = 0; i < layout.Blocks.Count; i++) {
if (layout.Blocks[i].Type == FREngine.BlockTypeEnum.BT_Text) {
getVariants (layout.Blocks[i]);
}
}
// 為文字區塊中的所有單字和字元產生假設的程序
void getVariants(FREngine.IBlock block)
{
FREngine.ICharParams charParams = engine.CreateCharParams();
FREngine.IParagraphs paragraphs = block.GetAsTextBlock().Text.Paragraphs;
for (int i = 0; i < paragraphs.Count; i++) {
for (int j = 0; j < paragraphs[i].Length; j++) {
paragraphs[i].GetCharParams(j, charParams);
FREngine.ICharacterRecognitionVariants charVariants = charParams.CharacterRecognitionVariants;
FREngine.IWordRecognitionVariants wordVariants = charParams.WordRecognitionVariants;
if (wordVariants != null) {
for (int k = 0; k < wordVariants.Count; k++) {
FREngine.IWordRecognitionVariant wordVariant = wordVariants[k];
}
}
if (charVariants != null) {
for ( int k = 0; k < charVariants.Count; k++) {
FREngine.ICharacterRecognitionVariant charVariant = charVariants[k];
}
}
}
}
}
CharConfidence、ErrorProbability 與 IsSuspicious 之間有何差異
