PrepareImageMode 物件 (IPrepareImageMode 介面)

此物件包含多種屬性，用來指定影像在轉換為內部格式時的準備方式。此型別新建立物件的所有屬性，都會設為合理的預設值。若要了解某個屬性的預設值，請參閱其說明。對已準備影像執行轉換操作的順序如下：先執行旋轉，接著再將影像鏡像翻轉。

PrepareImageMode 物件是持久性物件。這表示可將該物件的目前狀態寫入持久性儲存體。之後，可藉由從持久性儲存體讀取該物件的狀態來重新建立此物件。下列方法可提供該物件的持久化：

Linux: SaveToFile，以及 LoadFromFile

Windows SaveToFile、LoadFromFile、SaveToMemory，以及 LoadFromMemory。

​

屬性

名稱	型別	描述
Application	Engine, 唯讀的	回傳 Engine 物件。
CompressImageMode	CompressImageModeEnum	指定轉換為內部格式時是否要壓縮影像。僅適用於彩色與灰階影像；黑白影像一律使用無損壓縮。依預設，此屬性設為 CIM_Auto，目前表示原生數位影像 (例如從 PDF 檔案取得的影像) 會使用無損壓縮，而其他影像則使用最大壓縮。
DocumentType	DocumentTypeEnum	指定影像中的文件類型。如果您已確定文件類型，可以設定此屬性以略過文件分類器並節省時間。依預設，此屬性為 DT_Auto，表示 FineReader Engine 會執行文件分類器來判定文件類型。
ImageSourceType	ImageSourceTypeEnum	指定影像的來源。例如，含有文字的照片與螢幕截圖需要不同的預處理技術。依預設，此屬性為 IST_Auto，表示 FineReader Engine 會自動偵測影像來源。
OfficeConversionSettings	OfficeConversionSettings, 唯讀的	提供使用與開啟影像相同方法匯入數位文件時的設定。 僅限 Linux 和 Windows。
RasterizeFreeText	VARIANT_BOOL	指定是否保留輸入 PDF 文件中的 Free Text 註解。依預設，此屬性設為 TRUE。 僅限 Linux 和 Windows。 在 Linux 上，使用此屬性前，請確認您的工作站可使用 Arial 或 Liberation Sans 字型。

​

方法

名稱	描述
CopyFrom	使用另一個物件中對應屬性的值來初始化目前物件的屬性。
LoadFromFile	從磁碟上的檔案還原物件內容。
LoadFromMemory	從全域記憶體還原物件內容。 僅限 Windows。
SaveToFile	將物件內容儲存至磁碟上的檔案。
SaveToMemory	將物件內容儲存至全域記憶體。 僅限 Windows。

​

相關物件

​

Linux 與 Windows

物件圖

​

輸出參數

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

​

輸入參數

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

• FRDocument 物件的 AddImageFile、AddImageFileFromAttachment、AddImageFileWithPassword、AddImageFileWithPasswordCallback、AddImageFileFromMemory 方法
• Engine 物件的 CreateFRDocumentFromImage、PrepareBitmapBits、OpenImageFileFromMemory、OpenBitmapBits、OpenBitmap、OpenDib、PrepareBitmap、PrepareDib、InjectTextLayer 方法
• Linux 和 Windows 上的 BatchProcessor 物件之 Start 方法

​

範例

此物件可用於下列程式碼範例：

• Linux： CommandLineInterface
• Windows： CommandLineInterface；以及 Demo Tools：Engine 預設處理設定檔

​

另請參閱

使用影像物件

使用屬性