> ## 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 オブジェクトの PrepareDib メソッド

> ABBYY FineReader Engine API の Engine オブジェクトにおける PrepareDib メソッド — このメソッドは、指定したデバイス非依存ビットマップ（DIB）のコピーを FineReader Engine の内部画像形式で作成します（Windows のみ）。

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

このメソッドは、指定したデバイス非依存ビットマップのコピーを [FineReader Engine の内部画像形式](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#internal_format) に変換して作成します。DIB は Windows API を使用して作成する必要があります。

このメソッドで取得した出力画像は、[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 PrepareDib(
  __int64            DibHglobal,
  BSTR               DestinationFolderName,
  int                XResolution,
  int                YResolution,
  IPrepareImageMode* PrepareMode
);
```

### C\#

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

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

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

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

DibHglobal

\[in] ビットマップが保存されているメモリ ブロック (HGLOBAL) のハンドルを指定します。ハンドルは [\_\_int64](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties) として渡されます。このハンドルは、ABBYY FineReader Engine を使用するプロセスからアクセス可能である必要があります。

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 によってディスクから自動的に削除されることはありません。
* Engine オブジェクトがプロセス外サーバーとして読み込まれている場合、このメソッドは動作しません。

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

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

[OpenDib](/ja/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/opendib-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)