Método GetBitmap del objeto Image

Método GetBitmap del objeto Image en la FineReader Engine API de ABBYY: devuelve una parte de la imagen como un DIB (mapa de bits independiente del dispositivo) con orientación de arriba abajo mediante un objeto Handle que administra la liberación de memoria (solo para Windows).

Este método está implementado en FRE para Windows

Este método devuelve una parte de la imagen como un DIB (mapa de bits independiente del dispositivo) con orientación de arriba abajo. La paleta, en la que 0 corresponde al color negro, se usa para imágenes en escala de grises y en blanco y negro.

El método devuelve el DIB como un objeto Handle. Este objeto administra la asignación de memoria y libera los recursos cuando dejan de utilizarse.

​

Sintaxis

​

C++

HRESULT GetBitmap(
  IImageModification* Modification,
  IHandle**           Result
);

​

C#

IHandle GetBitmap( IImageModification Modification );

​

Visual Basic .NET

Function GetBitmap(Modification As IImageModification) As IHandle

​

Parámetros

Modification

[in] Este parámetro de tipo ImageModification define las modificaciones que se aplican a la imagen. Puede incluir rectángulos de recorte, en cuyo caso solo se pasan las partes especificadas de la imagen; el factor de escalado; rectángulos de pintura para rellenar partes de la imagen con color, etc. Este parámetro puede ser 0 y, en ese caso, no se aplicará ninguna modificación a la página de imagen y se pasará “tal cual”.

Result

[out, retval] Un puntero a una variable de puntero IHandle* que recibe el puntero de interfaz del objeto Handle resultante, que representa el identificador del mapa de bits asociado.

​

Valores de retorno

• Windows: Este método no tiene valores de retorno específicos. Devuelve los valores de retorno estándar de las funciones de ABBYY FineReader Engine.

• Linux y macOS: Este método devuelve E_NOTIMPL.

​

Observaciones

Este método no funciona si Engine se carga como un servidor fuera de proceso en Linux o si el objeto se crea con OutprocLoader en Windows.

​

Ejemplos

Código C#

FREngine.IEngine engine;
FREngine.IFRDocument frdoc;
// Suponemos que el documento ya se ha creado y que se le han agregado imágenes
// Obtener el identificador de mapa de bits de un plano de imagen en color de una página del documento
FREngine.IFRPage page = frDoc.Pages[0];
FREngine.IImageDocument imageDoc = page.ImageDocument;
FREngine.IImage image = imageDoc.ColorImage;
FREngine.IHandle hBitmap = image.GetBitmap( null );
// Trabajar con el mapa de bits
System.Drawing.Image preprocessedImage = System.Drawing.Image.FromHbitmap( hBitmap.Handle );
...
Gdi32.DeleteObject( hBitmap );

El método se utiliza en las siguientes herramientas de demostración para Windows: Engine Predefined Processing Profiles.

​

Consulte también

ImageModification

IImage::EstimateBitmapSize