ABBYY FineReader Engine 12 與 11 的相容性

ABBYY FineReader Engine 12 與 ABBYY FineReader Engine 11 並不具備二進位相容性。使用 ABBYY FineReader Engine 11 編譯的應用程式，應改用 ABBYY FineReader Engine 12 的標頭檔和程式庫重新編譯。由於 ABBYY FineReader Engine API 已有所改進，原始程式碼可能也需要進行一些調整。本文提供完整的變更清單，並附上建議，說明如何重寫程式碼，使其可在新版本中運作。主要變更：

已淘汰的 DocumentAnalyzer 和 Exporter 物件，以及 Engine 物件中的處理方法，均已移除。請改用效率更高的 FRDocument 和 FRPage 物件中的方法，這些方法會處理完整文件處理所需的所有資訊。您不再需要在所有處理階段維護 DocumentInfo 物件、追蹤所有影像文件及其對應的版面配置，或實作 IRecognizedPages 介面。
已移除可存取文件邏輯結構的 API (DocumentStructure、PageStructure 及其子物件) 。透過這些已刪除的物件編輯文件的屬性和內容，可能會在匯出時導致不可預期的結果。如果您需要驗證或後處理識別結果，請透過每個 FRPage 的 Layout 子物件來處理資料，並在完成後呼叫任一會執行文件合成的方法。之後，系統會重新建立文件的邏輯結構，並在匯出階段使用，但將無法再透過 FineReader Engine API 進行編輯。ABBYY FineReader Engine 未來的版本可能會提供對部分文件邏輯結構的唯讀存取。
Classification API 已全面更新，採用全新且更優化的演算法，並提供內建的交叉驗證技術。

現在必須使用 InitializeEngine 函式來載入 Engine 物件。原先用於載入 Engine 的 GetEngineObject 和 GetEngineObjectEx 函式已從 ABBYY FineReader Engine 中移除。

Engine 物件

屬性/方法/常數	發生了哪些變更？	備註
CreateDocumentAnalyzer CreateDocumentInfo CreateExporter	已移除	由於這些方法建立的物件已移除，因此這些方法已無需保留。
CreateExportFileWriter	方法簽名已變更	已移除已淘汰的 PagesCount 參數。
CreateImageDocumentsInMemory <Note> 僅限 Windows </Note>	已移除	影像文件一律會在記憶體中建立。若需要將影像文件儲存至磁碟，您可以使用 SaveTo 或 SaveToFile 方法。
CreateLayout	已移除	Layout 物件已無法再脫離其對應的頁面而單獨使用。
CreateMultipageImageWriter	行為已變更	此方法現在支援適用於 JPEG 與 TIFF 格式的延伸影像儲存參數。
CreateMultipageImageWriterEx	已重新命名	此方法現已改稱為 CreateMultipageImageWriter。舊版的 CreateMultipageImageWriter 方法實作已移除。
ExportPage	已移除	請改為使用 IFRPage::Export 方法。
ExportPagesEx	已移除	請改用 IFRDocument::Export 方法。
InjectTextLayer	行為已變更	此方法現在提供額外的文字層注入參數，並可選擇 PDF 檔中要處理的頁面，以及用於處理警告和錯誤的回呼介面。
InjectTextLayerEx InjectTextLayerEx2	已移除	新版的 InjectTextLayer 方法現在已提供這些方法先前具備的所有選項。
OpenImageFile	已移除	使用 IFRDocument::AddImageFile 方法開啟影像檔案，並將其新增至文件中進行處理。之後即可透過對應的 FRPage 存取 ImageDocument 物件。
PrepareImageFile	已移除	使用 IFRDocument::AddImageFile 方法開啟影像檔案，並將其新增至文件以供處理。之後可透過對應的 FRPage 存取 ImageDocument 物件，且之後也可將其儲存至磁碟。
ProcessPage	已移除	請改為使用 IFRDocument::Process 方法。
ProcessPagesEx	已移除	請改用 IFRDocument::Process 方法。
SynthesizePagesEx	已移除	請改用 IFRDocument::Synthesize 方法。
OpenMemoryImageFormat10	已移除	提供此 method 僅為了與 ABBYY FineReader Engine 10 相容。
OpenBitmap OpenBitmapBits<br />OpenDib<br />PrepareBitmap<br />PrepareBitmapBits<br />PrepareDib	在 Linux 和 macOS 上已淘汰	這些屬性現已棄用，並將在未來版本中刪除。

Java 的 Engine

方法	發生了哪些變更？	備註
Load LoadEx	已移除	此方法已淘汰，請改用 Engine.InitializeEngine。

影像相關物件

物件/列舉	屬性/方法/常數	發生了哪些變更？	備註
ImageDocument	SuppressColorObjects	已移除	請改用 RemoveColorObjectsEx 方法，您可以一次移除多個指定色相的物件，並取得已移除物件的影像。
	RemoveGarbage	行為已變更	此方法仍會在黑白平面上搜尋雜點，但會從影像的所有彩色平面中將其移除。
	RemoveGarbageEx	已重新命名	此方法現已更名為 RemoveGarbage。原有的實作已移除。
PrepareImageMode	ImageCompression	已重新命名，型別已變更	此屬性現名為 CompressImage，其型別為 ThreeStatePropertyValueEnum。預設行為與先前相同。
PrepareImageMode	KeepOriginalCoordinatesInfo	已棄用	此屬性現已棄用，並將在未來版本中刪除。
ImageCompressionEnum		已移除	原本使用此列舉的屬性現在已改為其他型別。
Image	EstimateBitmapSize GetBitmap	在 Linux 和 macOS 中已棄用	這些方法現已棄用，並將在未來版本中刪除。
TrainingImage	SetBitmapBits	在 Linux 和 macOS 中已棄用	此方法現已棄用，並將在未來版本中刪除。

Layout 相關物件

物件/列舉	屬性/方法/常數	發生了哪些變更？	備註
Block	BackgroundColor	行為已變更	此屬性現在為唯讀。
Block	BlockLayerType	行為已變更	此屬性現在為唯讀。對於 RasterPictureBlock 和 VectorPictureBlock，可使用 SetBlockLayerType 方法變更圖層型別。
BlockLayerTypeEnum	BLT_Unknown	已移除	此常數已不再使用。

文字相關物件


	已移除	這些屬性已不再受支援：系統無法再偵測段落跨兩頁分割的情況。
	已移除	此屬性原本會傳回對應圖片的 PageElement ID，由於 PageElement 物件已連同其餘文件結構 API 一併移除，此屬性已無實際用途。
	行為已變更	此方法現在需要以 “UserDefinedBookmark:<my_user_bookmark>” 格式指定使用者書籤名稱。
	已移除	段落屬性現在只能透過物件存取。
	行為已變更	這些屬性現在為唯讀的。段落樣式的所有屬性均無法編輯。
	已移除	段落樣式的所有屬性均無法編輯，也無法從其他物件複製。
	已移除	段落樣式可透過物件存取。
	已重新命名	此方法現在稱為 AddNew。舊版 AddNew 方法的實作已移除。
	行為已變更	此方法現在允許您在建立時設定定位前導字元的所有屬性。
	已移除	定位停駐點的所有屬性應在建立物件時，透過物件的方法加以指定。這些屬性無法變更，也無法從其他物件複製。
	行為已變更	這些屬性現在為唯讀的。應在建立物件時透過method of theobject and may not be changed or copied from another object.
	Removed	This property was deprecated in the previous version.
	Removed	This property has been removed due to the removal of document logical structure API, as it is no longer possible to access the parts of document by their role in the logical structure.
	Removed	The property that used this enumeration has been removed.
	已移除	此屬性已棄用並排定移除，已由兩個屬性取代：，用於指定由左至右閱讀時單字中的第一個字元；以及，用於指定在該語言所採用的閱讀方向下，邏輯上的第一個字元。
CFL_Picture	Removed	The property which used this constant has been removed.
	Deprecated	These properties are now deprecated and will be deleted in future versions.
	Behavior changed	This property now requires the specification of user bookmark name in the format “UserDefinedBookmark:<my_user_bookmark>” for creating a hyperlink.

文件相關物件


		已重新命名	此介面現已更名為。舊版介面已移除。
		參數已變更	此方法新增了一個參數，用於指定文件中警告所對應頁面的索引。
		已移除	這些物件代表文件的邏輯結構及其各個組成部分。由於不當使用可能影響匯出文件的外觀，編輯文件結構的功能已不再受支援。任何文字驗證或其他修改操作均可透過文件 API (、及子物件) 執行。ABBYY FineReader Engine 的未來版本可能會提供對部分文件邏輯結構的唯讀存取。
		已移除	這些列舉曾用於現已不再可用的文件結構物件。
		行為已變更	此方法現提供空白頁偵測的延伸參數。
		已重新命名	此方法現已更名為。原有的 IsEmpty 方法實作已移除。
		已移除	頁面分類現可透過物件的方法執行。此方法需要傳入一個作為輸入參數，可使用方法建立。
		已棄用	此屬性現已棄用，將於未來版本中移除。請使用方法來確認檔案是否包含文字內容。

Batch Processor

物件/列舉	屬性/方法/常數	發生了哪些變更？	備註
BatchProcessor	StartEx	已移除	Start 方法現在改用進階影像來源介面，而該介面現已更名為 IImageSource。
IImageSourceEx	<br />	已重新命名	此介面現在名為 IImageSource。
IImageSource	<br />	行為已變更	此介面現在可讓您將影像文件和影像檔案加入佇列。

機制物件


	已移除	此物件已過時。其方法已由和物件中更高效的方法取代，使用這些方法無需在所有處理階段維護 DocumentInfo 物件，也無需實作 IRecognizedPages 介面。
	已移除	請使用、、方法來操作快取字典。
	已移除	請改用方法。
	已移除	請改用方法。
	已移除	請改用方法。
	已移除	請改用方法。
	已移除	請使用屬性，其運作方式完全相同。
	已移除	請使用方法，其運作方式完全相同。
	已移除	請改用 IImageDocument::RemoveGeometricalDistortions 方法。
	已移除	請改用方法。
	已移除	請改用方法。
	已移除	請改用方法代替。
	已移除	請改用方法。
	已移除	請改用方法。
	已移除	請改用方法。此方法可對文件執行完整處理，包括文件合成。
	已移除	請改用方法。
	已移除	請改用方法。
	已移除	請改用方法。
	已移除	若要將影像識別為純文字，請使用方法從影像建立，再使用方法識別文件，然後存取屬性。
	已移除	若要將頁面識別為純文字，請使用方法，然後存取屬性。
	已移除	請改用方法。
	已移除	請改用方法。
	已移除	此物件已過時。其方法已由和物件的更高效方法所取代，無需在所有處理階段維護 DocumentInfo 物件，也無需實作 IRecognizedPages 介面。
	已移除	請改用方法。
	已移除	請改用方法。
	已移除	由於回報事件的物件已被移除，此介面已不再需要。和介面可為取代 DocumentAnalyzer 的物件提供類似的進度與錯誤資訊。
	已移除	由於回報事件的物件已被移除，此介面已不再需要。和介面可為取代 Exporter 的物件提供類似的進度與錯誤資訊。
	已移除	需要此型別物件的方法已被移除。
FREM_DocumentAnalyzer	已移除	此常數已不再使用。

Parameter 物件


	已移除	此屬性自 FineReader Engine 11 起已過時，請改用屬性。
	已移除	此屬性自 FineReader Engine 11 起已過時，請改用屬性 (屬於物件) 。
	已移除	請使用屬性，透過空格模擬原始文字的版面配置。
WS_Default	已移除	Windows 建議使用 WS_Auto 以確保最佳識別品質。若需要選取與目前作業系統語言相對應的書寫風格，請使用 WS_DetectByLocale。
	已移除	請改用 KeepPageBreaks 屬性。
PEM_SingleLineParagraphsWithSpaceFormatting	已移除	請使用屬性，在匯出為 TXT 格式時透過空格模擬原始文字的外觀。
	已移除	請使用屬性選取加密類型。
	已移除	請使用 LanguageDetectionMode 屬性管理識別語言的自動偵測。
	已移除	請使用新的屬性。此屬性不再區分不同的信賴度等級，僅提供簡單的選擇：是否標示識別結果不確定的字元。若需要更精細的區分，請使用所選的屬性，但針對不同字元將識別信賴度與相同 Threshold 進行比對，不一定能提供一致的結果。
	已棄用	請使用屬性搭配常數來設定識別模式 (RM_Normal 對應 BalancedMode = TRUE，RM_Fast 對應 FastMode = TRUE) 。
AEM_FastMode AEM_BalancedMode	已棄用	使用這些常數的模組已棄用。
	已移除	使用此列舉的屬性已移除。
	已重新命名，型別已變更	這些屬性現已分別更名為和 CorrectResolution，型別為。預設值的行為與先前相同。
	已重新命名，型別已變更	這些屬性現已分別更名為、，型別為。預設值的行為與先前相同。
	已重新命名，型別已變更	此屬性現已更名為，型別為。預設情況下，圖片不會被視為背景的一部分。
	已移除	使用這些列舉的屬性現已變更為其他型別。
	已棄用	此屬性現已棄用，將於未來版本中移除。可透過將屬性設為 TXTLRM_ExactCopy 來達到相同的效果。
	已移除	此屬性先前已標記為棄用。
	已棄用	此屬性現已棄用，將於未來版本中移除。
	已棄用	這些屬性現已棄用，將於未來版本中移除。
	已在 Windows 和 Linux 中棄用	此屬性現已棄用，將於未來版本中移除。

分類相關物件

物件/列舉	屬性/方法/常數	發生了哪些變更？	備註
ClassificationEtalon ClassificationParams ClassificationClass ClassificationClasses ClassificationTrainer ClassificationTrainerError ClassificationTrainerErrors ClassificationTrainerErrorTypeEnum ClassificationModeEnum	<br />	已移除	舊版 Classification API 已移除。分類模型訓練現在是透過 Trainer 物件執行，相關設定在 TrainingParams 和 ValidationParams 中指定，輸入資料則由 TrainingData 提供。您也可以透過 Model 物件對文件或頁面進行分類。無論是訓練還是分類，都必須先將文件或頁面轉換為 ClassificationObject，這可透過 ClassificationEngine 物件的方法完成。另請參閱 Classification-Related Objects 及 Classification 情境說明。

輔助物件

物件/列舉	屬性/方法/常數	發生了哪些變更？	備註
DocumentInfo		已移除	需要此型別物件的方法已移除。
DocumentInfo	DocumentContentInfo	已移除	這個物件包含文件的作者、關鍵字、主題和標題等資訊，可透過 DocumentContentInfo 屬性從 FRDocument 物件取得。

概觀

匯出格式

回溯相容性問題

ABBYY FineReader Engine 12 與 11 的相容性