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

> ABBYY FineReader Engine API における Engine オブジェクトの OpenBitmapBits メソッド — このメソッドは、指定されたビットマップデータを開き、1 ビット モノクロ、8 ビット グレー、および 24 ビット カラー画像をサポートします（Windows のみ）。

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

このメソッドは、指定された[ビットマップデータ](/ja/fine-reader/engine/api-reference/enumerations/bitmapbitsformatenum)を開き、次の画像形式に対応しています。

* 1 ビット モノクロ (各ピクセルは 1 ビットで表されます) 。
* 8 ビット グレー (各ピクセルは 8 ビットで表されます) 。
* 24 ビット カラー (24 ビットはそれぞれ、R、G、B の各成分に 8 ビットずつ使用されます) 。

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

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

```cpp theme={null}
HRESULT OpenBitmapBits(
  BitmapBitsFormatEnum Format,
  int                  Width,
  int                  Height,
  int                  ByteWidth,
  int                  XResolution,
  int                  YResolution,
  __int64              RawDataPtr,
  IPrepareImageMode*   PrepareMode,
  IImageDocument**     Result
);
```

### C\#

```csharp theme={null}
IImageDocument OpenBitmapBits(
  BitmapBitsFormatEnum Format,
  int                  Width,
  int                  Height,
  int                  ByteWidth,
  int                  XResolution,
  int                  YResolution,
  Int64                RawDataPtr,
  IPrepareImageMode    PrepareMode
);
```

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

```vb theme={null}
Function OpenBitmapBits( _
  Format As BitmapBitsFormatEnum, _
  Width As Integer, _
  Height As Integer, _
  ByteWidth As Integer, _
  XResolution As Integer, _
  YResolution As Integer, _
  RawDataPtr As Int64, _
  [PrepareMode As IPrepareImageMode = Nothing] _
) As IImageDocument
```

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

Format

\[in] [BitmapBitsFormatEnum](/ja/fine-reader/engine/api-reference/enumerations/bitmapbitsformatenum) 型のこのパラメーターは、開くビットマップ データの形式を指定します。

Width

\[in] ビットマップの幅をピクセル単位で指定します。このパラメーターに 0 は指定できません。

Height

\[in] ビットマップの高さをピクセル単位で指定します。このパラメーターに 0 は指定できません。

ByteWidth

\[in] ビットマップの 1 行の幅をバイト単位で指定します (パディングを含む) 。このパラメーターに 0 は指定できません。

XResolution

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

YResolution

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

RawDataPtr

\[in] このパラメーターは、ビットマップ データを含むメモリ バッファーへのハンドルとして扱われます。このハンドルは [\_\_int64](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties) として渡されます。データ形式の詳細については、[BitmapBitsFormatEnum](/ja/fine-reader/engine/api-reference/enumerations/bitmapbitsformatenum) の各定数の説明を参照してください。

PrepareMode

\[in] 画像の前処理モードを定義する [PrepareImageMode](/ja/fine-reader/engine/api-reference/image-related-objects/prepareimagemode) オブジェクトを指定します。0 を指定することもでき、その場合は PrepareImageMode の Properties の既定値が使用されます。また、[profile](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles) が読み込まれている場合は、その profile で設定されたパラメーターが使用されます。

Result

\[out, retval] 生成された [ImageDocument](/ja/fine-reader/engine/api-reference/image-related-objects/imagedocument) オブジェクトのインターフェイス ポインターを受け取る IImageDocument\* ポインター変数へのポインターです。

<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="see-also">
  ## 関連項目
</div>

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

[BitmapBitsFormatEnum](/ja/fine-reader/engine/api-reference/enumerations/bitmapbitsformatenum)

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