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

# Image Object (IImage Interface)

This object represents a single "image plane" ([black-and-white](/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white), [gray](/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#gray), [color](/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#color) or [preview](/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#preview)) of an open image. It gives a user access to properties of this "image plane," such as its geometrical parameters and resolution.

<Note>
  In Windows, the Image object allows you to get a bitmap handle corresponding to this image.
</Note>

## Properties

| Name           | Type                                                                                                                                                                                                          | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Application    | [Engine](/fine-reader/engine/api-reference/engine-object-iengine-interface), [read-only](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties) | Returns the [Engine](/fine-reader/engine/api-reference/engine-object-iengine-interface) object.                                                                                                                                                                                                                                                                                                                                                                                                               |
| Height         | [int](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), read-only                                                                                             | Stores the height of the current image plane in pixels. The heights of the black-and-white, gray, and color image planes of an image are equal.                                                                                                                                                                                                                                                                                                                                                               |
| ImageColorType | [ImageColorTypeEnum](/fine-reader/engine/api-reference/enumerations/imagecolortypeenum), read-only                                                                                                            | Specifies the color type for the current image plane (black-and-white, gray, color). <br /><br /> **Note:** *By agreement on the ABBYY FineReader Engine API, if the [ImageDocument](/fine-reader/engine/api-reference/image-related-objects/imagedocument) object represents black-and-white image, an image plane received from IImageDocument::ColorImage property will actually be of black-and-white color type. This property provides information about actual color type of the current image plane.* |
| Width          | [int](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), read-only                                                                                             | Stores the width of the current image plane in pixels. The widths of the black-and-white, gray, and color image planes of an image are equal.                                                                                                                                                                                                                                                                                                                                                                 |
| XResolution    | [int](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), read-only                                                                                             | Stores the horizontal resolution of the current image plane in pixels per inch. The resolutions of the black-and-white, gray, and color image planes of an image are equal.                                                                                                                                                                                                                                                                                                                                   |
| YResolution    | [int](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), read-only                                                                                             | Stores the vertical resolution of the current image plane in pixels per inch. The resolution of the black-and-white, gray, and color image planes of an image are equal.                                                                                                                                                                                                                                                                                                                                      |

## Methods

| Name                                                                                                          | Description                                                                                                            |
| ------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| [EstimateBitmapSize](/fine-reader/engine/api-reference/image-related-objects/image/estimatebitmapsize-method) | Estimates the size of the bitmap that will be returned by the GetBitmap method. <br /><br /> **Note:** *Windows only.* |
| [GetBitmap](/fine-reader/engine/api-reference/image-related-objects/image/getbitmap-method)                   | Returns a handle of bitmap that corresponds to the current image plane. <br /><br /> **Note:** *Windows only.*         |
| [WriteToFile](/fine-reader/engine/api-reference/image-related-objects/image/writetofile-method)               | Writes the image of the current image plane into an image file.                                                        |

## Related objects

<img src="https://mintcdn.com/abbyy/lsETHFYUFiongXSm/images/fine-reader/engine/image.gif?s=da343740f90ff220a56e93e71b854ee5" alt="Image" width="123" height="89" data-path="images/fine-reader/engine/image.gif" />[](/fine-reader/engine/api-reference/image-related-objects/imagedocument)

[Object Diagram](/fine-reader/engine/api-reference/object-diagram)

## Input parameter

This object is the input parameter of the [IMultipageImageWriter::AddPage](/fine-reader/engine/api-reference/image-related-objects/multipageimagewriter/addpage-method) method.

## Samples

The object is used in the following code samples:

* Linux: [CommandLineInterface](/fine-reader/engine/guided-tour/samples#commandlineinterface) and [BCR](/fine-reader/engine/guided-tour/samples#bcr_linux)
* macOS: [Business Card Recognition](/fine-reader/engine/guided-tour/samples#bcr_mac)
* Windows: [CommandLineInterface](/fine-reader/engine/guided-tour/samples#commandlineinterface) and the [Engine Predefined Processing Profiles](/fine-reader/engine/guided-tour/samples#engine_predefined_processing_profiles) demo tool

## See also

[ImageDocument](/fine-reader/engine/api-reference/image-related-objects/imagedocument)

[Working with Images](/fine-reader/engine/guided-tour/advanced-techniques/working-with-images)

[Working with Properties](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)