跳转到主要内容
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 对象。该值可以为 0，此时将使用 PrepareImageMode 属性的默认值；或者，如果已加载 profile，则使用该 profile 设置的参数。

​
返回值

Windows：此方法没有特定的返回值，而是返回 ABBYY FineReader Engine 函数的标准返回值。 Linux 和 macOS：此方法返回 E_NOTIMPL。

​
说明

  • 如果您需要在不再需要这些文件时删除准备图像文件，请在应用程序中实现相应的流程。ABBYY FineReader Engine 不会自动从磁盘中删除这些文件。
  • 如果 Engine 在 Linux 中作为进程外服务器加载，或者在 Windows 中使用 OutprocLoader 对象创建此对象，则此方法不起作用。

​
另请参见

Engine OpenBitmapBits LoadImageDoc BitmapBitsFormatEnum 配置文件的使用