Skip to main content
This method is implemented in FRE for Windows.
This method opens the specified device-independent bitmap. DIB must be created using Windows API.

Syntax

C++

HRESULT OpenDib(
  __int64            DibHglobal,
  int                XResolution,
  int                YResolution,
  IPrepareImageMode* PrepareMode,
  IImageDocument**   Result
);

C#

IImageDocument OpenDib(
  Int64            DibHglobal,
  int              XResolution,
  int              YResolution,
  IPrepareImageMode PrepareMode
);

Visual Basic .NET

Function OpenDib( _
  DibHglobal As Int64, _
  XResolution As Integer, _
  YResolution As Integer, _
  [PrepareMode As IPrepareImageMode = Nothing] _
) As IImageDocument

Parameters

DibHglobal [in] This variable contains the handle of the memory block (HGLOBAL) where the bitmap is saved. This handle should be available to the process that operates ABBYY FineReader Engine. The handle is passed as __int64. XResolution [in] Specifies the horizontal resolution of the bitmap. YResolution [in] Specifies the vertical resolution of the bitmap. PrepareMode [in] This variable refers to the PrepareImageMode object that stores parameters for bitmap conversion in internal format. This parameter may be 0 in which case default parameters of the image preparation mode are used, or, if a profile has been loaded, the parameters set by this profile are used. Result [out, retval] A pointer to IImageDocument* pointer variable that receives the interface pointer to the resulting ImageDocument object.

Return values

Windows: This method has no specific return values. It returns the standard return values of ABBYY FineReader Engine functions. Linux and macOS: This method returns E_NOTIMPL.

Remarks

This method does not work if the Engine is loaded as an out-of-process server.

See also

Engine PrepareDib Working with Profiles