跳轉到主要內容
此方法不支援 Linux 或 macOS
此方法會以 FineReader Engine 內部影像格式 建立指定的 點陣圖資料 副本，並支援下列影像格式：
  • 1 位元黑白 (每個像素以 1 位元表示) 。
  • 8 位元灰階 (每個像素以 8 位元表示) 。
  • 24 位元彩色 (每 24 位元由 R、G、B 各色彩分量的 8 位元組成) 。
之後可使用 IEngine::LoadImageDoc 方法開啟此方法產生的輸出影像。

​
語法

​
C++

HRESULT PrepareBitmapBits(
  BitmapBitsFormatEnum Format,
  int                  Width,
  int                  Height,
  int                  ByteWidth,
  int                  XResolution,
  int                  YResolution,
  __int64              RawDataPtr,
  BSTR                 DestinationFolderName,
  IPrepareImageMode*   PrepareMode
);

​
C#

void PrepareBitmapBits(
  BitmapBitsFormatEnum Format,
  int                  Width,
  int                  Height,
  int                  ByteWidth,
  int                  XResolution,
  int                  YResolution,
  Int64                RawDataPtr,
  string               DestinationFolderName,
  IPrepareImageMode     PrepareMode
);

​
Visual Basic .NET

Sub PrepareBitmapBits( _
  Format As BitmapBitsFormatEnum, _
  Width As Integer, _
  Height As Integer, _
  ByteWidth As Integer_
  XResolution As Integer, _
  YResolution As Integer, _
  RawDataPtr As Int64, _
  DestinationFolderName As String, _
  [PrepareMode As IPrepareImageMode = Nothing] _
)

​
參數

Format [in] 此參數的類型為 BitmapBitsFormatEnum，用於指定要準備的點陣圖資料格式。 Width [in] 指定點陣圖的寬度 (以像素為單位) 。此參數不得為 0。 Height [in] 指定點陣圖的高度 (以像素為單位) 。此參數不得為 0。 ByteWidth [in] 指定點陣圖每一列的寬度 (以位元組為單位) 。其值應考慮位元組對齊。此參數不得為 0。 XResolution [in] 指定點陣圖的水平解析度 (以每英吋點數為單位) 。 YResolution [in] 指定點陣圖的垂直解析度 (以每英吋點數為單位) 。 RawDataPtr [in] 此參數會視為指向包含點陣圖資料之記憶體緩衝區的控制代碼。此控制代碼會以 __int64 傳遞。資料格式的詳細資訊，請參閱 BitmapBitsFormatEnum 常數的說明。 DestinationFolderName [in] 指定用來儲存內部格式影像之資料夾的完整路徑。此資料夾必須存在；否則會傳回錯誤碼。 PrepareMode [in] 指向定義影像準備模式的 PrepareImageMode object。其值可為 0，此時會使用 PrepareImageMode Properties 的預設值；或者，如果已載入 profile，則會使用該設定檔所設定的參數。

​
傳回值

Windows：此方法沒有特定的傳回值。它會傳回 ABBYY FineReader Engine 函式的標準傳回值。 Linux 和 macOS：此方法會傳回 E_NOTIMPL。

​
備註

  • 如果您需要在這些已準備好的影像檔不再需要時將其刪除，請在您的應用程式中實作這項程序。ABBYY FineReader Engine 不會自動將這些檔案從磁碟移除。
  • 如果在 Linux 中將 Engine 載入為處理序外伺服器，或在 Windows 中使用 OutprocLoader 物件建立該物件，則此方法無法運作。

​
另請參閱

Engine OpenBitmapBits LoadImageDoc BitmapBitsFormatEnum 使用設定檔