このメソッドは Linux または macOS では実装されていません。
このメソッドは、指定されたビットマップデータのコピーを FineReader Engine の内部画像形式 で作成します。サポートされる画像形式は次のとおりです。
- 1 ビット モノクロ (各ピクセルは 1 ビットで表されます) 。
- 8 ビット グレースケール (各ピクセルは 8 ビットで表されます) 。
- 24 ビット カラー (各ピクセルは 24 ビットで表され、R、G、B の各成分に 8 ビットずつ使用します) 。
このメソッドで取得した出力画像は、IEngine::LoadImageDoc メソッドを使用して開くことができます。
HRESULT PrepareBitmapBits(
BitmapBitsFormatEnum Format,
int Width,
int Height,
int ByteWidth,
int XResolution,
int YResolution,
__int64 RawDataPtr,
BSTR DestinationFolderName,
IPrepareImageMode* PrepareMode
);
void PrepareBitmapBits(
BitmapBitsFormatEnum Format,
int Width,
int Height,
int ByteWidth,
int XResolution,
int YResolution,
Int64 RawDataPtr,
string DestinationFolderName,
IPrepareImageMode PrepareMode
);
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] ビットマップの 1 行分の幅をバイト単位で指定します。アラインメントを考慮する必要があります。このパラメーターに 0 は指定できません。
XResolution
[in] ビットマップの水平方向の解像度を dpi で指定します。
YResolution
[in] ビットマップの垂直方向の解像度を dpi で指定します。
RawDataPtr
[in] このパラメーターは、ビットマップ データを含むメモリー バッファーへのハンドルとして扱われます。ハンドルは __int64 として渡されます。データ形式の詳細については、BitmapBitsFormatEnum の各定数の説明を参照してください。
DestinationFolderName
[in] 内部画像形式 の画像を保存するフォルダーのフル パスを指定します。このフォルダーは存在している必要があります。存在しない場合は、エラー コードが返されます。
PrepareMode
[in] 画像の準備モードを定義する PrepareImageMode object を参照します。0 を指定することもでき、その場合は PrepareImageMode のプロパティの既定値が使用されます。また、プロファイル が読み込まれている場合は、そのプロファイルで設定されたパラメーターが使用されます。
Windows: このメソッド固有の戻り値はありません。代わりに、ABBYY FineReader Engine 関数の標準戻り値を返します。
Linux および macOS: このメソッドは E_NOTIMPL を返します。
- 準備済み画像を含むファイルが不要になった時点で削除する必要がある場合は、その処理をアプリケーションに実装してください。これらのファイルは、ABBYY FineReader Engine によってディスクから自動的に削除されません。
- Linux で Engine が別プロセスサーバーとして読み込まれている場合、または Windows で OutprocLoader オブジェクトを使用してオブジェクトを作成している場合、このメソッドは機能しません。
Engine
OpenBitmapBits
LoadImageDoc
BitmapBitsFormatEnum
プロファイルの使用