> ## 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.

# 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).

<Warning>
  Este método está implementado en FRE para Windows
</Warning>

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](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/handle). Este objeto administra la asignación de memoria y libera los recursos cuando dejan de utilizarse.

<div id="syntax">
  ## Sintaxis
</div>

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

```cpp theme={null}
HRESULT GetBitmap(
  IImageModification* Modification,
  IHandle**           Result
);
```

### C\#

```csharp theme={null}
IHandle GetBitmap( IImageModification Modification );
```

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

```vb theme={null}
Function GetBitmap(Modification As IImageModification) As IHandle
```

<div id="parameters">
  ## Parámetros
</div>

Modification

\[in] Este parámetro de tipo [ImageModification](/es/fine-reader/engine/api-reference/image-related-objects/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](/es/fine-reader/engine/api-reference/supplementary-objects-and-methods/handle) resultante, que representa el identificador del mapa de bits asociado.

<div id="return-values">
  ## Valores de retorno
</div>

* 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](/es/fine-reader/engine/api-reference/return-codes).

* Linux y macOS: Este método devuelve E\_NOTIMPL.

<div id="remarks">
  ## Observaciones
</div>

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](/es/fine-reader/engine/api-reference/engine-loaders/outprocloader) en Windows.

<div id="samples">
  ## Ejemplos
</div>

<Accordion title="Código C#">
  ```csharp theme={null}
  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 );
  ```
</Accordion>

El método se utiliza en las siguientes herramientas de demostración para Windows: [Engine Predefined Processing Profiles](/es/fine-reader/engine/guided-tour/samples#engine_predefined_processing_profiles).

<div id="see-also">
  ## Consulte también
</div>

[ImageModification](/es/fine-reader/engine/api-reference/image-related-objects/imagemodification)

[IImage::EstimateBitmapSize](/es/fine-reader/engine/api-reference/image-related-objects/image/estimatebitmapsize-method)