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

# AddClipRegion Method of the ImageModification Object

This method adds a new clipping region to the internal array of clipping regions of the [ImageModification](/fine-reader/engine/api-reference/image-related-objects/imagemodification) object. To remove all the clipping regions previously added call the [IImageModification::ClearClipRegions](/fine-reader/engine/api-reference/image-related-objects/imagemodification/clearclipregions-method) method. If the modification must be applied to a single [color](/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#color) (or [gray](/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#gray)) plane of the image, coordinates of the region should be specified on this color (gray) plane. If the modification must be applied to the whole ImageModification, the coordinates should be specified on the deskewed [black-and-white](/fine-reader/engine/guided-tour/advanced-techniques/working-with-images#black-and-white) image plane.

## Syntax

### C++

```cpp theme={null}
HRESULT AddClipRegion( IRegion* Region );
```

### C\#

```csharp theme={null}
void AddClipRegion( IRegion Region );
```

### Visual Basic .NET

```vb theme={null}
Sub AddClipRegion(Region As IRegion)
```

## Parameters

Region

\[in] This parameter of the [Region](/fine-reader/engine/api-reference/supplementary-objects-and-methods/region) type specifies the clipping region to be added.

## Return values

This method has no specific return values. It returns the [standard return values of ABBYY FineReader Engine functions](/fine-reader/engine/api-reference/return-codes).

## Remarks

Clipping regions specify what part of the image will be affected during modification. Only part of image inside the bounding region of the clipping regions is processed, and the part of image inside the bounding region that does not belong to any of the clipping regions, is filled in with the white color.

## See also

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

[ClearClipRegions](/fine-reader/engine/api-reference/image-related-objects/imagemodification/clearclipregions-method)