Image オブジェクトの GetBitmap メソッド

このメソッドは Windows 用 FRE で実装されています

このメソッドは、画像の一部をトップダウン DIB (デバイス非依存ビットマップ) として返します。グレースケール画像および白黒画像では、0 を黒として扱うパレットが使用されます。このメソッドは、DIB をハンドルオブジェクトとして返します。このオブジェクトはメモリの割り当てを管理し、不要になったリソースを解放します。

構文

C++

HRESULT GetBitmap(
  IImageModification* Modification,
  IHandle**           Result
);

C#

IHandle GetBitmap( IImageModification Modification );

Visual Basic .NET

Function GetBitmap(Modification As IImageModification) As IHandle

パラメーター

Modification [in] ImageModification 型のこのパラメーターは、画像に対して行う変更を定義します。これには、クリッピング矩形 (この場合、画像の指定部分のみが渡されます) 、拡大率、画像の一部を色で塗りつぶすための描画矩形などを含めることができます。このパラメーターには 0 を指定することもでき、その場合は画像ページに対して変更は行われず、そのまま渡されます。 Result [out, retval] 関連付けられたビットマップへのハンドルを表す、生成された Handle オブジェクトのインターフェイスポインターを受け取る IHandle* ポインター変数へのポインター。

戻り値

Windows: このメソッドには固有の戻り値はありません。ABBYY FineReader Engine 関数の標準的な戻り値が返されます。
Linux および macOS: このメソッドは E_NOTIMPL を返します。

注記

このメソッドは、Linux で Engine がプロセス外サーバーとして読み込まれている場合、または Windows で OutprocLoader オブジェクトを使用してオブジェクトが作成された場合には機能しません。

サンプル

C# コード

FREngine.IEngine engine;
FREngine.IFRDocument frdoc;
// Document はすでに作成されており、画像が追加されているものとします
// ドキュメントのページのカラー画像プレーンのビットマップ ハンドルを取得します
FREngine.IFRPage page = frDoc.Pages[0];
FREngine.IImageDocument imageDoc = page.ImageDocument;
FREngine.IImage image = imageDoc.ColorImage;
FREngine.IHandle hBitmap = image.GetBitmap( null );
// ビットマップを操作します
System.Drawing.Image preprocessedImage = System.Drawing.Image.FromHbitmap( hBitmap.Handle );
...
Gdi32.DeleteObject( hBitmap );

このメソッドは、次の Windows デモツールで使用されています：Engine Predefined Processing Profiles。

​構文

​C++

​C#

​Visual Basic .NET

​パラメーター

​戻り値

​注記

​サンプル

​関連項目

構文

C++

C#

Visual Basic .NET

パラメーター

戻り値

注記

サンプル

関連項目