Chinese Simplified (简体中文)

PrepareBitmap Method of the Engine Object

Important! This method is not implemented.

This method creates a copy of the specified bitmap image (HBITMAP) in FineReader Engine internal image format.

The output image obtained from this method may then be opened using the IEngine::LoadImageDoc method.

Note: This method supports only 24-bit bitmap images.

Syntax

HRESULT PrepareBitmap(
  __int64            BitmapHandle,
  BSTR               DestinationFolderName,
  int                XResolution,
  int                YResolution,
  IPrepareImageMode* PrepareMode
);
    

Parameters

BitmapHandle
[in] Specifies the handle of the GDI object (HBITMAP). This handle should be available to the process that operates ABBYY FineReader Engine. The handle is passed as __int64.
DestinationFolderName
[in] Specifies the full path to the folder, where the image in internal format should be saved. This folder must exist; otherwise, an error code is returned.
XResolution
[in] Specifies the horizontal resolution of the bitmap.
YResolution
[in] Specifies the vertical resolution of the bitmap.
PrepareMode
[in] 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.

Return values

This method returns E_NOTIMPL. See details in the standard return values of ABBYY FineReader Engine functions.

Remarks

  • If you need to delete the files with prepared images when they are no longer necessary, implement the procedure in your application. These files will not be automatically removed from the disk by ABBYY FineReader Engine.
  • This method does not work if the Engine object is loaded as an out-of-process server.

See also

Engine

OpenBitmap

LoadImageDoc

Working with Profiles

12.12.2022 20:26:04

Usage of Cookies. In order to optimize the website functionality and improve your online experience ABBYY uses cookies. You agree to the usage of cookies when you continue using this site. Further details can be found in our Privacy Notice.