> ## 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.

# Engine オブジェクトの PrepareBitmap メソッド

> ABBYY FineReader Engine API の Engine オブジェクトにおける PrepareBitmap メソッド — このメソッドは、指定したビットマップ (HBITMAP) のコピーを FineReader Engine の内部画像形式で作成します（Windows のみ）。

<Warning>
  このメソッドは、Linux または macOS では実装されていません。
</Warning>

このメソッドは、指定したビットマップ画像 (HBITMAP) を [FineReader Engine の内部形式](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#internal_format) のコピーとして作成します。

このメソッドで取得した出力画像は、[IEngine::LoadImageDoc](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/loadimagedoc-method) メソッドを使用して開くことができます。

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

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

```cpp theme={null}
HRESULT PrepareBitmap(
  __int64            BitmapHandle,
  BSTR               DestinationFolderName,
  int                XResolution,
  int                YResolution,
  IPrepareImageMode* PrepareMode
);
```

### C\#

```csharp theme={null}
void PrepareBitmap(
  Int64            BitmapHandle,
  string           DestinationFolderName,
  int              XResolution,
  int              YResolution,
  IPrepareImageMode PrepareMode
);
```

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

```vb theme={null}
Sub PrepareBitmap( _
  BitmapHandle As Int64, _
  DestinationFolderName As String, _
  XResolution As Integer, _
  YResolution As Integer, _
  [PrepareMode As IPrepareImageMode = Nothing] _
)
```

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

BitmapHandle

\[in] GDI オブジェクト (HBITMAP) のハンドルを指定します。このハンドルは、ABBYY FineReader Engine を動作させるプロセスから使用できる必要があります。ハンドルは [\_\_int64](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties) として渡されます。

DestinationFolderName

\[in] 内部形式の画像を保存するフォルダーのフルパスを指定します。このフォルダーは存在している必要があります。存在しない場合は、エラー コードが返されます。

XResolution

\[in] ビットマップの水平方向の解像度を指定します。

YResolution

\[in] ビットマップの垂直方向の解像度を指定します。

PrepareMode

\[in] 内部形式へのビットマップ変換用パラメーターを格納する [PrepareImageMode](/ja/fine-reader/engine/api-reference/image-related-objects/prepareimagemode) オブジェクトを参照します。このパラメーターには 0 を指定することもでき、その場合は画像準備モードの既定のパラメーターが使用されます。また、[profile](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles) が読み込まれている場合は、そのプロファイルで設定されたパラメーターが使用されます。

<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>

* 準備済み画像を含むファイルが不要になった時点で削除する必要がある場合は、その処理をアプリケーションに実装してください。これらのファイルは、ABBYY FineReader Engine によってディスクから自動的に削除されることはありません。

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

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

[Engine](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface)

[OpenBitmap](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/openbitmap-method)

[LoadImageDoc](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/loadimagedoc-method)

[プロファイルの操作](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles)