跳轉到主要內容
此物件對應於一個已開啟的影像,即「影像文件」。其屬性反映了影像的各項屬性。ImageDocument 物件是 Image 物件 (即「影像平面」) 集合的根節點。每個影像文件包含 4 個「影像平面」:black-and-whitegraycolorpreview,可透過對應的屬性存取。 此物件包含多種影像預處理方法。其中部分方法僅適用於照片,其他方法則可用於所有類型的文件。部分方法可提升識別品質,其他方法則僅改善影像的視覺呈現效果,但可能降低識別品質,因此後者應僅在識別完成後使用。請仔細閱讀每種方法的說明,以確認該方法是否適用於您的情境。以下為建議的影像預處理方法使用順序 (請僅使用清單中適合您情境的方法) :
  • 提升識別品質:
    1. 裁切影像
    2. 增強局部對比度
    3. 校正方向 (使用 Transform 方法並搭配必要的參數)
    4. 反轉或鏡像影像 (使用 Transform 方法並搭配必要的參數)
    5. 校正 skew
    6. 分割跨頁 (使用 FRDocument 物件的 SplitPages 方法)
    7. 移除幾何失真
    8. 移除 garbage
    9. 移除 noise
    10. 移除 motion blur
    11. 抑制 color objects
    12. 移除 color objects
  • 改善影像外觀:
    1. 均衡亮度並將 background 設為白色
    2. 平滑影像紋理
    3. 對影像進行抖動處理
請注意,所有這些預處理方法都必須套用於已開啟的影像。部分影像修改可在開啟影像的過程中提前套用。請參閱 PrepareImageModePagePreprocessingParams 物件的說明,以進一步了解開啟影像時的預處理方式。 ImageDocument 物件是所謂的「可連接物件」。在 FRE for Windows 的 Visual Basic 中,可使用 WithEvents 宣告。在 C++ (所有支援的作業系統) 中,這表示它支援 IConnectionPointContainer 介面。若要在處理過程中接收通知事件,C++ 使用者應建立一個衍生自 IImageDocumentEvents 介面的物件,並執行下列操作:
  • 在 Linux 和 macOS 上:透過呼叫 AdviseFREngineObject 全域函式,將物件與 ImageDocument 物件建立關聯。
  • 在 Windows 上:透過標準 COM 方式,在物件與 ImageDocument 物件中實作的事件來源之間建立連接。
在 Windows 上:ImageDocument 物件的方法會透過特殊的傳出介面回報頁面處理進度資訊。這些介面分別為 IImageDocumentEvents (適用於 C++) 和 dispinterface DIImageDocumentEvents (適用於 Visual Basic) 。值得注意的是,Visual Basic 使用者無需關注實作事件介面的細節,因為此開發平台提供了便捷的事件處理機制。

屬性

,read-only

回傳物件。

,read-only

提供對目前 ImageDocument 物件之黑白影像平面的存取。

,read-only

提供對目前 ImageDocument 物件之彩色影像平面的存取。

,read-only

提供對目前 ImageDocument 物件之灰階影像平面的存取。

, read-only

儲存影像文件的 ID。

, read-only

影像文件的每個色彩平面均有各自的色彩型別。此屬性將整個影像文件的色彩型別指定為其各色彩平面 (黑白、灰階、彩色) 對應值中的最大值。

, read-only

指定影像文件是否僅儲存於記憶體中,或同時以磁碟上資料夾的形式存在。

呼叫SaveTo方法後,此屬性的值不會變更。您需要透過呼叫LoadImageDoc方法重新載入影像文件。

, read-only

儲存磁碟上物件內部表示資料夾的路徑。若 IsInMemory 屬性的值為 TRUE,則此屬性包含空字串。

呼叫SaveTo方法後,此屬性的值不會變更。您需要透過呼叫LoadImageDoc方法重新載入影像文件。

,唯讀

回傳物件,其中包含目前修改狀態下像素座標的相關資訊。

當您需要在影像處理過程中於兩個狀態之間轉換座標時,此屬性非常實用。

, 唯讀

指定 ImageDocument 物件自載入記憶體後,或自上次呼叫方法後,是否有任何修改。

, 唯讀

指定影像自開啟後所套用的旋轉操作。

, 唯讀

此屬性設為 TRUE 時,表示影像色彩自開啟後已被反轉。

, 唯讀

此屬性設為 TRUE 時,表示影像自開啟後已沿垂直軸進行鏡像翻轉。

, 唯讀

此屬性指出影像傾斜是否已在開啟、預處理或呼叫方法期間完全校正。

已校正的傾斜角正切值儲存於 SkewAngle 屬性中。

, 唯讀

儲存針對影像偵測到的傾斜角正切值,該值已在開啟、預處理或呼叫方法期間完成校正。若傾斜角為負值,影像為順時針旋轉;若角度為正值,影像為逆時針旋轉。影像可繞任意點旋轉。已校正傾斜的影像尺寸一律大於原始影像尺寸。

對影像執行進一步修改時,此屬性值將重設為 0。如有需要,請在呼叫任何其他影像編輯方法之前,先儲存已校正傾斜角的值。

, 唯讀

指出 ImageDocument 物件是否由包含文字的檔案建立。例如,PDF 檔案可包含文字圖層。

, 唯讀

指出 ImageDocument 物件是否由相片檔案建立。

,唯讀

提供目前 ImageDocument 物件之來源影像檔案格式的相關資訊。若此資訊無法取得,或影像來自掃描器,則此屬性的值為 IFF_UnknownFormat。

,唯讀

提供用於擷取影像之掃描器的相關資訊。若來源影像參數的資訊無法取得,或影像來自檔案,則此屬性的值為空字串。

,唯讀

提供目前 ImageDocument 物件之掃描強度閾值的相關資訊。若來源影像參數的資訊無法取得,或影像來自檔案,則此屬性的值為 -1。

,唯讀

提供目前 ImageDocument 物件之來源影像水平解析度的相關資訊。若來源影像參數的資訊無法取得,則此屬性的值為 0。

,唯讀

提供目前 ImageDocument 物件之來源影像垂直解析度的相關資訊。若來源影像參數的資訊無法取得,則此屬性的值為 0。

方法

名稱描述
ApplySigmaFilter此方法對影像套用降噪濾鏡,主要適用於照片。
ChangeResolution變更影像的解析度。
CorrectShadowsAndHighlights修正影像中過度的陰影與高光。
CorrectSkew校正影像的偏斜。
CropImage偵測影像中文件的邊緣,並裁剪影像。
DitherImage使用 Floyd–Steinberg 或 Bayer (有序) 抖動演算法對影像進行抖動處理。
EnhanceLocalContrast提高影像的局部對比度。
EqualizeBrightness均衡影像亮度。此方法僅適用於灰階和彩色影像。
FindBlackSquares在影像上尋找黑色方塊。
GetPreviewImage提供對當前 ImageDocument object 的 94 * 60 預覽影像平面的存取。若此大小的預覽尚未建立,將於此次呼叫期間建立,這可能需要一些時間。
GetPreviewImageSpecificSize提供對當前 ImageDocument object 的預覽影像平面的存取,並可讓您指定大小。如果此大小的預覽尚未建立,將於此次呼叫期間建立,可能需要一些時間。
GetTextBackgroundColor偵測影像上指定 Rectangle 中文字與背景的顏色。
Modify允許您修改影像。與 Transform 方法相比,此方法提供更進階的修改功能。
RemoveColorObjects從整個影像或其部分移除指定的色彩物件。此方法僅適用於彩色影像。
RemoveColorObjectsEx從影像中移除所有指定色調的色彩物件,並以指定顏色取代。已移除的物件可儲存至獨立影像中。
RemoveGarbage從圖像中移除雜點 (小於特定尺寸的多餘斑點) 。
RemoveGeometricalDistortions移除影像的幾何失真 (例如頁面邊緣附近的彎曲線條) 。
RemoveMotionBlur從影像中移除運動模糊。
RemoveNoise減少影像中的雜訊。
SaveImageRegionTo將影像的各部分儲存至磁碟上的資料夾。儲存的影像採用 ABBYY FineReader Engine 內部格式。
SaveModified將對目前 ImageDocument 物件執行的所有修改儲存至磁碟上的資料夾中。
SaveTo將 ImageDocument 物件的內容儲存至磁碟上的資料夾。影像以 ABBYY FineReader Engine 內部格式儲存。
SaveToFile將 ImageDocument 物件的內容儲存至檔案。
SaveToMemory <Note> 僅限 Windows。 </Note>將 ImageDocument 物件的內容儲存至全域記憶體。
SmoothImage可對影像執行平滑化處理。此方法僅適用於灰階影像和彩色影像。
SmoothTexture使用非線性濾波器對影像進行平滑處理。適用於含有紋理的影像。此方法僅適用於每個維度不少於 3 個像素的灰階和彩色影像。
Transform對影像套用有限的轉換操作集合。
ImageDocument 物件圖

輸出 Parameter

此 物件 是 Engine 物件 下列 方法 的輸出 Parameter:LoadImageDocFromFileLoadImageDocFromMemory (僅限 Windows) 、LoadImageDocOpenBitmapOpenDibOpenBitmapBitsOpenImageFileFromMemory

輸入參數

此物件作為輸入Parameter傳遞至以下方法:

範例

此物件用於以下程式碼範例: Linux:CommandLineInterfaceBCR macOS:名片辨識 Windows:CommandLineInterface;以及 Demo Tools:Engine Predefined Processing Profiles

另請參閱

IImageDocumentEvents 使用影像 使用可連接物件 使用屬性