> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> ABBYY FineReader Engine API における Image オブジェクトの GetBitmap メソッド — メモリ解放を管理する ハンドル オブジェクトを介して、画像の一部をトップダウン DIB（デバイスに依存しないビットマップ）として返します（Windows のみ）。

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

このメソッドは、画像の一部をトップダウン DIB (デバイス非依存ビットマップ) として返します。グレースケール画像および白黒画像では、0 を黒として扱うパレットが使用されます。

このメソッドは、DIB を [ハンドル](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/handle) オブジェクトとして返します。このオブジェクトはメモリの割り当てを管理し、不要になったリソースを解放します。

<div id="syntax">
  ## 構文
</div>

<div id="c">
  ### C++
</div>

```cpp theme={null}
HRESULT GetBitmap(
  IImageModification* Modification,
  IHandle**           Result
);
```

### C\#

```csharp theme={null}
IHandle GetBitmap( IImageModification Modification );
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```vb theme={null}
Function GetBitmap(Modification As IImageModification) As IHandle
```

<div id="parameters">
  ## パラメーター
</div>

Modification

\[in] [ImageModification](/ja/fine-reader/engine/api-reference/image-related-objects/imagemodification) 型のこのパラメーターは、画像に対して行う変更を定義します。これには、クリッピング矩形 (この場合、画像の指定部分のみが渡されます) 、拡大率、画像の一部を色で塗りつぶすための描画矩形などを含めることができます。このパラメーターには 0 を指定することもでき、その場合は画像ページに対して変更は行われず、そのまま渡されます。

Result

\[out, retval] 関連付けられたビットマップへのハンドルを表す、生成された [Handle](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/handle) オブジェクトのインターフェイス ポインターを受け取る IHandle\* ポインター変数へのポインター。

<div id="return-values">
  ## 戻り値
</div>

* Windows: このメソッドには固有の戻り値はありません。[ABBYY FineReader Engine 関数の標準的な戻り値](/ja/fine-reader/engine/api-reference/return-codes)が返されます。

* Linux および macOS: このメソッドは `E_NOTIMPL` を返します。

<div id="remarks">
  ## 注記
</div>

このメソッドは、Linux で Engine がプロセス外サーバーとして読み込まれている場合、または Windows で [OutprocLoader](/ja/fine-reader/engine/api-reference/engine-loaders/outprocloader) オブジェクトを使用してオブジェクトが作成された場合には機能しません。

<div id="samples">
  ## サンプル
</div>

<Accordion title="C# コード">
  ```csharp theme={null}
  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 );
  ```
</Accordion>

このメソッドは、次の Windows デモツールで使用されています：[Engine Predefined Processing Profiles](/ja/fine-reader/engine/guided-tour/samples#engine_predefined_processing_profiles)。

<div id="see-also">
  ## 関連項目
</div>

[ImageModification](/ja/fine-reader/engine/api-reference/image-related-objects/imagemodification)

[IImage::EstimateBitmapSize](/ja/fine-reader/engine/api-reference/image-related-objects/image/estimatebitmapsize-method)